Salas e Recursos

Gerenciamento de Salas

As salas representam os espaços físicos de atendimento disponíveis em cada unidade.

Cadastro de Sala

Campo	Obrigatório	Descrição
Nome	✅	Ex: "Sala 1 - Laser", "Consultório Dr. Silva"
Unidade	✅	Unidade física onde a sala está localizada
Capacidade	❌	Número de pacientes simultâneos (padrão: 1)
Descrição	❌	Equipamentos ou características especiais
Ativo	✅	Se a sala está disponível para uso

Validação de Conflito de Sala

Ao criar um agendamento com sala vinculada, o sistema verifica:

• A sala está na mesma unidade do agendamento
• A sala não está em uso no horário solicitado (agendamento ativo no mesmo slot)

Se houver conflito, o sistema retorna erro ROOM_CONFLICT e lista as salas alternativas disponíveis no horário.

Bloqueio de Sala

Salas podem ser bloqueadas para períodos específicos (manutenção, reforma, evento):

• Bloquear sala por período (data inicial e final)
• Durante bloqueio, a sala não aparece como disponível

Convênios (Insurance Plans)

O módulo de convênios permite registrar os planos de saúde aceitos pela organização.

Cadastro de Convênio

Campo	Obrigatório	Descrição
Nome	✅	Ex: "Unimed", "Bradesco Saúde"
Código	❌	Código interno do plano
Tabela de preços	❌	Valor diferenciado por convênio por procedimento

Pacientes podem ser vinculados a um convênio no cadastro. Na criação de fatura, o sistema sugere o valor do convênio se houver tabela configurada.

Endpoints da API

Método	Endpoint	Papel mínimo	Descrição
GET	/rooms	Viewer	Listar salas da unidade
POST	/rooms	Admin	Cadastrar sala
PUT	/rooms/:id	Admin	Atualizar sala
DELETE	/rooms/:id	Admin	Inativar sala
GET	/insurance-plans	Viewer	Listar convênios
POST	/insurance-plans	Admin	Cadastrar convênio

Permissões

Ação	OWNER	ADMIN	RECEPTIONIST	PROFESSIONAL	VIEWER
Ver salas e convênios	✅	✅	✅	✅	✅
Cadastrar/editar salas	✅	✅	❌	❌	❌
Cadastrar/editar convênios	✅	✅	❌	❌	❌

Acesso

• Salas: /app/rooms
• Convênios: /app/insurances
• Guard: Requer autenticação