94 lines
5.2 KiB
Markdown
94 lines
5.2 KiB
Markdown
# Prompt 06 — Painel Cliente (escritório): condomínios, contatos, espaços comuns, assembleias, documentos
|
||
|
||
## Contexto
|
||
Prompts 01–05 concluídos: autenticação completa, painel master funcionando, empresas sendo provisionadas com tenant próprio. **Leia `10-tracker-progresso.md` antes de começar.**
|
||
|
||
Este prompt implementa o CRUD principal do menu **Cliente → Cadastro Condomínio**, que é o coração do sistema: condomínios, contatos (síndico/subsíndico/conselheiro), vínculo de funcionários, espaços comuns, assembleias e documentos.
|
||
|
||
Todos os endpoints deste prompt exigem `exigirFuncionario` (Prompt 04) e operam sobre o `db_empresa_<slug>` do `empresa_id` do token (usar `TenantDataSourceProvider` do Prompt 03).
|
||
|
||
## Objetivo
|
||
CRUD completo de `condominios`, `contatos` + `contato_condominio`, `funcionario_condominio`, `espacos_comuns`, `assembleias`, `documentos` (upload de arquivo).
|
||
|
||
## Especificação
|
||
|
||
### 1. Condomínios
|
||
```
|
||
POST /api/condominios body: {"nome", "cnpj", "endereco"}
|
||
GET /api/condominios lista todos do tenant
|
||
GET /api/condominios/{id}
|
||
→ resposta agregada: dados do condomínio + síndico atual (via ContatoCondominioDao) +
|
||
contagem de assembleias futuras + contagem de avisos ativos (isso é o "checklist"
|
||
que o funcionário usa como referência rápida)
|
||
PUT /api/condominios/{id}
|
||
```
|
||
|
||
### 2. Contatos (síndico/subsíndico/conselheiro)
|
||
```
|
||
POST /api/contatos body: {"nome", "telefone", "email"}
|
||
→ cria a pessoa (sem vínculo ainda)
|
||
POST /api/condominios/{id}/contatos/vincular
|
||
body: {"contato_id" (ou dados de um contato novo pra criar+vincular numa chamada só),
|
||
"tipo": "sindico"|"subsindico"|"conselheiro",
|
||
"data_inicio_mandato", "data_fim_mandato"}
|
||
→ grava em contato_condominio; se marcar tipo=sindico e já existir outro síndico ativo
|
||
pro mesmo condomínio, perguntar/forçar: por padrão, encerrar automaticamente o mandato
|
||
anterior (status='inativo', data_fim_mandato=hoje) e ativar o novo — deixar isso
|
||
documentado no código como decisão de negócio
|
||
GET /api/condominios/{id}/contatos lista todos os vínculos ativos daquele condomínio
|
||
DELETE /api/condominios/{id}/contatos/{contatoId}?tipo=... (desvincula — não apaga o contato,
|
||
só remove o vínculo daquele condomínio/tipo específico; um contato pode continuar
|
||
vinculado a outros condomínios)
|
||
```
|
||
|
||
### 3. Funcionários vinculados a condomínios
|
||
```
|
||
POST /api/condominios/{id}/funcionarios-vinculados
|
||
body: {"funcionario_id"} (funcionario precisa existir em db_master, mesma empresa)
|
||
GET /api/condominios/{id}/funcionarios-vinculados
|
||
DELETE /api/condominios/{id}/funcionarios-vinculados/{funcionarioId}
|
||
```
|
||
|
||
### 4. Espaços comuns
|
||
```
|
||
POST /api/condominios/{id}/espacos-comuns
|
||
body: {"nome", "descricao", "valor_utilizacao_centavos", "indice_correcao"}
|
||
GET /api/condominios/{id}/espacos-comuns
|
||
PUT /api/condominios/{id}/espacos-comuns/{espacoId}
|
||
→ se o valor mudar, atualizar data_ultimo_reajuste=hoje automaticamente
|
||
```
|
||
|
||
### 5. Assembleias
|
||
```
|
||
POST /api/condominios/{id}/assembleias
|
||
body: {"tipo", "data_hora", "local", "pauta"}
|
||
GET /api/condominios/{id}/assembleias (ordenar por data_hora desc)
|
||
PUT /api/condominios/{id}/assembleias/{id} (inclui mudar status: agendada/realizada/cancelada)
|
||
```
|
||
|
||
### 6. Documentos (upload)
|
||
```
|
||
POST /api/condominios/{id}/documentos multipart/form-data: arquivo + tipo
|
||
→ salvar o arquivo em um diretório local montado como volume Docker (ex: /app/uploads/
|
||
<empresa_slug>/<condominio_id>/<uuid>-<nome_original>), gravar caminho_armazenamento
|
||
com esse path relativo
|
||
→ validar extensão (permitir: pdf, jpg, jpeg, png, docx) e tamanho máximo (ex: 10MB)
|
||
GET /api/condominios/{id}/documentos
|
||
GET /api/documentos/{id}/download → serve o arquivo (Content-Disposition: attachment)
|
||
```
|
||
Adicionar o volume de uploads no `docker-compose.yml` do Prompt 01 (`./uploads:/app/uploads`).
|
||
|
||
### 7. Auditoria
|
||
Toda operação de `POST`/`PUT`/`DELETE` deste prompt deve gravar uma linha em `log_auditoria` (tabela_afetada, registro_id, ação, dados_anteriores/dados_novos em JSON, funcionario_id do token).
|
||
|
||
## Critérios de aceite
|
||
- [ ] Criar um condomínio, vincular um síndico e um subsíndico, e chamar `GET /api/condominios/{id}` mostra o síndico atual corretamente.
|
||
- [ ] Vincular um segundo síndico ao mesmo condomínio encerra automaticamente o mandato do primeiro (`status='inativo'`).
|
||
- [ ] O mesmo `contato` pode ser vinculado como síndico em dois condomínios diferentes simultaneamente.
|
||
- [ ] Upload de um PDF funciona; upload de um `.exe` é rejeitado com erro claro; upload de 15MB é rejeitado.
|
||
- [ ] `log_auditoria` recebe uma linha para cada operação de escrita feita neste prompt (testar com pelo menos 3 operações diferentes).
|
||
- [ ] Todos os endpoints só retornam/alteram dados do `empresa_id` do token — tentar acessar `/api/condominios/{id}` de outra empresa retorna 404 (não 403 — não revelar que o ID existe em outro tenant).
|
||
|
||
## Ao concluir
|
||
Atualizar `10-tracker-progresso.md`: Prompt 06 concluído, data, resumo. Confirmar Prompts 01–05 seguem marcados.
|