Initial project import
This commit is contained in:
Tiago
@@ -0,0 +1,215 @@
|
||||
# Sistema de Contabilidade de Condomínios — Arquitetura v3.0 (FINAL)
|
||||
|
||||
> Substitui v2.0. Escopo drasticamente simplificado: o sistema é um **cadastro de referência** para o escritório — não um ERP de condomínio. Sem reservas, sem moradores, sem financeiro do condomínio, sem ocorrências, sem fornecedores, sem votação. Só: condomínios, contatos (síndico/subsíndico/conselheiro), funcionários vinculados, áreas comuns, assembleias e avisos/alertas com documentos anexados.
|
||||
|
||||
**Stack:** Java puro (JDBC) + `HttpServer` do JDK · PostgreSQL 16 (1 database por empresa) · Frontend HTML/CSS/JS puro no mesmo processo · Docker Compose.
|
||||
|
||||
---
|
||||
|
||||
## 1. Diagrama — `db_master` (sem mudança desde v2.0)
|
||||
|
||||
```mermaid
|
||||
erDiagram
|
||||
EMPRESAS ||--o{ FUNCIONARIOS : tem
|
||||
EMPRESAS ||--o{ API_KEYS : possui
|
||||
EMPRESAS ||--o{ EMPRESA_FUNCIONALIDADES : libera
|
||||
FUNCIONALIDADES ||--o{ EMPRESA_FUNCIONALIDADES : referenciada_em
|
||||
EMPRESAS ||--o{ EVOLUTION_INSTANCIAS : cadastra
|
||||
PLANOS ||--o{ PLANO_FUNCIONALIDADES : inclui
|
||||
FUNCIONALIDADES ||--o{ PLANO_FUNCIONALIDADES : referenciada_em
|
||||
PLANOS ||--o{ ASSINATURAS : usado_em
|
||||
EMPRESAS ||--o{ ASSINATURAS : possui
|
||||
EMPRESAS ||--o{ PERIODOS_USO : tem
|
||||
PERIODOS_USO ||--o{ PAGAMENTOS : gera
|
||||
EMPRESAS ||--o{ LOGS_ENVIO_AVISOS : gera
|
||||
EMPRESAS ||--o{ LEMBRETES_COBRANCA : recebe
|
||||
```
|
||||
|
||||
Schema igual ao documento v2.0 (empresas, funcionarios, api_keys, funcionalidades, empresa_funcionalidades, evolution_instancias, configuracoes_plataforma, planos, plano_funcionalidades, assinaturas, periodos_uso, pagamentos, logs_envio_avisos, lembretes_cobranca) — nada disso mudou.
|
||||
|
||||
---
|
||||
|
||||
## 2. Diagrama — `db_empresa_<slug>` (NOVO, bem mais simples)
|
||||
|
||||
```mermaid
|
||||
erDiagram
|
||||
CONDOMINIOS ||--o{ CONTATO_CONDOMINIO : vincula
|
||||
CONTATOS ||--o{ CONTATO_CONDOMINIO : vinculado_a
|
||||
CONDOMINIOS ||--o{ FUNCIONARIO_CONDOMINIO : atendido_por
|
||||
CONDOMINIOS ||--o{ ESPACOS_COMUNS : possui
|
||||
CONDOMINIOS ||--o{ ASSEMBLEIAS : realiza
|
||||
CONDOMINIOS ||--o{ AVISOS : publica
|
||||
ASSEMBLEIAS ||--o{ AVISOS : gera
|
||||
AVISOS ||--o{ AVISO_DOCUMENTOS : anexa
|
||||
DOCUMENTOS ||--o{ AVISO_DOCUMENTOS : anexado_em
|
||||
AVISOS ||--o{ AVISO_DESTINATARIOS : enviado_para
|
||||
CONDOMINIOS ||--o{ DOCUMENTOS : arquiva
|
||||
```
|
||||
|
||||
### Schema
|
||||
|
||||
```sql
|
||||
CREATE TABLE condominios (
|
||||
id BIGSERIAL PRIMARY KEY,
|
||||
nome VARCHAR(150) NOT NULL,
|
||||
cnpj VARCHAR(18) UNIQUE,
|
||||
endereco VARCHAR(255),
|
||||
criado_em TIMESTAMP NOT NULL DEFAULT now()
|
||||
);
|
||||
|
||||
-- pessoa física (síndico/subsíndico/conselheiro) — cadastrada uma vez,
|
||||
-- pode ser vinculada a mais de um condomínio
|
||||
CREATE TABLE contatos (
|
||||
id BIGSERIAL PRIMARY KEY,
|
||||
nome VARCHAR(150) NOT NULL,
|
||||
telefone VARCHAR(20), -- WhatsApp
|
||||
email VARCHAR(150),
|
||||
criado_em TIMESTAMP NOT NULL DEFAULT now()
|
||||
);
|
||||
|
||||
-- vínculo N:N entre contato e condomínio, com o papel que exerce ali
|
||||
CREATE TABLE contato_condominio (
|
||||
contato_id BIGINT NOT NULL REFERENCES contatos(id),
|
||||
condominio_id BIGINT NOT NULL REFERENCES condominios(id),
|
||||
tipo VARCHAR(20) NOT NULL, -- sindico, subsindico, conselheiro
|
||||
data_inicio_mandato DATE,
|
||||
data_fim_mandato DATE,
|
||||
status VARCHAR(20) NOT NULL DEFAULT 'ativo',
|
||||
PRIMARY KEY (contato_id, condominio_id, tipo)
|
||||
);
|
||||
-- "síndico atual" de um condomínio = SELECT ... WHERE condominio_id=X AND tipo='sindico' AND status='ativo'
|
||||
|
||||
-- funcionário do escritório (cadastro fica em db_master.funcionarios) vinculado
|
||||
-- a quais condomínios ele cuida — também recebe avisos/alertas desses condomínios
|
||||
CREATE TABLE funcionario_condominio (
|
||||
funcionario_id BIGINT NOT NULL, -- referência a db_master.funcionarios, sem FK cross-db
|
||||
condominio_id BIGINT NOT NULL REFERENCES condominios(id),
|
||||
PRIMARY KEY (funcionario_id, condominio_id)
|
||||
);
|
||||
|
||||
CREATE TABLE espacos_comuns (
|
||||
id BIGSERIAL PRIMARY KEY,
|
||||
condominio_id BIGINT NOT NULL REFERENCES condominios(id),
|
||||
nome VARCHAR(100) NOT NULL, -- salão de festas, churrasqueira, quadra...
|
||||
descricao TEXT,
|
||||
valor_utilizacao_centavos BIGINT,
|
||||
indice_correcao VARCHAR(30), -- IGPM, IPCA, definido em assembleia...
|
||||
data_ultimo_reajuste DATE,
|
||||
criado_em TIMESTAMP NOT NULL DEFAULT now()
|
||||
);
|
||||
|
||||
CREATE TABLE assembleias (
|
||||
id BIGSERIAL PRIMARY KEY,
|
||||
condominio_id BIGINT NOT NULL REFERENCES condominios(id),
|
||||
tipo VARCHAR(20) NOT NULL, -- ordinaria, extraordinaria
|
||||
data_hora TIMESTAMP NOT NULL,
|
||||
local VARCHAR(150),
|
||||
pauta TEXT,
|
||||
status VARCHAR(20) NOT NULL DEFAULT 'agendada', -- agendada, realizada, cancelada
|
||||
criado_em TIMESTAMP NOT NULL DEFAULT now()
|
||||
);
|
||||
|
||||
CREATE TABLE documentos (
|
||||
id BIGSERIAL PRIMARY KEY,
|
||||
condominio_id BIGINT NOT NULL REFERENCES condominios(id),
|
||||
tipo VARCHAR(40), -- ata, convocacao, regimento, convencao, contrato, outro
|
||||
nome_arquivo VARCHAR(255) NOT NULL,
|
||||
caminho_armazenamento VARCHAR(500) NOT NULL,
|
||||
versao INT NOT NULL DEFAULT 1,
|
||||
enviado_por BIGINT, -- id em db_master.funcionarios
|
||||
criado_em TIMESTAMP NOT NULL DEFAULT now()
|
||||
);
|
||||
|
||||
CREATE TABLE avisos (
|
||||
id BIGSERIAL PRIMARY KEY,
|
||||
condominio_id BIGINT NOT NULL REFERENCES condominios(id),
|
||||
assembleia_id BIGINT REFERENCES assembleias(id), -- opcional: aviso sobre uma assembleia específica
|
||||
tipo VARCHAR(20) NOT NULL DEFAULT 'aviso', -- aviso, alerta
|
||||
titulo VARCHAR(150) NOT NULL,
|
||||
mensagem TEXT NOT NULL,
|
||||
data_evento TIMESTAMP, -- data/hora do evento relacionado (se houver)
|
||||
data_publicacao TIMESTAMP NOT NULL DEFAULT now(),
|
||||
data_expiracao TIMESTAMP,
|
||||
prioridade VARCHAR(10) DEFAULT 'normal', -- baixa, normal, alta, urgente
|
||||
enviar_whatsapp BOOLEAN NOT NULL DEFAULT false,
|
||||
enviar_email BOOLEAN NOT NULL DEFAULT false,
|
||||
status_envio VARCHAR(20) NOT NULL DEFAULT 'nao_enviado', -- nao_enviado, enviado, falhou
|
||||
criado_por_funcionario BIGINT, -- id em db_master.funcionarios
|
||||
criado_em TIMESTAMP NOT NULL DEFAULT now()
|
||||
);
|
||||
|
||||
CREATE TABLE aviso_documentos (
|
||||
aviso_id BIGINT NOT NULL REFERENCES avisos(id),
|
||||
documento_id BIGINT NOT NULL REFERENCES documentos(id),
|
||||
PRIMARY KEY (aviso_id, documento_id)
|
||||
);
|
||||
|
||||
-- destinatário pode ser um contato (síndico/subsíndico/conselheiro) OU um funcionário do escritório
|
||||
CREATE TABLE aviso_destinatarios (
|
||||
aviso_id BIGINT NOT NULL REFERENCES avisos(id),
|
||||
tipo_destinatario VARCHAR(20) NOT NULL, -- contato, funcionario
|
||||
destinatario_id BIGINT NOT NULL, -- contatos.id ou db_master.funcionarios.id, conforme tipo
|
||||
PRIMARY KEY (aviso_id, tipo_destinatario, destinatario_id)
|
||||
);
|
||||
|
||||
CREATE TABLE log_auditoria (
|
||||
id BIGSERIAL PRIMARY KEY,
|
||||
funcionario_id BIGINT,
|
||||
acao VARCHAR(20) NOT NULL, -- create, update, delete
|
||||
tabela_afetada VARCHAR(60) NOT NULL,
|
||||
registro_id BIGINT,
|
||||
dados_anteriores JSONB,
|
||||
dados_novos JSONB,
|
||||
criado_em TIMESTAMP NOT NULL DEFAULT now()
|
||||
);
|
||||
```
|
||||
|
||||
**Removido em relação à v2.0:** `contatos_condominio` (virou `contatos` + `contato_condominio`), `reservas_area_comum`, `regras_cobranca`, `historico_reajustes`, `prestacoes_contas`, `lancamentos_financeiros`, `ocorrencias`, `fornecedores`, `votacoes`.
|
||||
|
||||
---
|
||||
|
||||
## 3. Fluxo do exemplo que você deu
|
||||
|
||||
"Assembleia dia 23/11/2026 às 18:00 → vincular documentos pertinentes":
|
||||
1. Cadastra em `assembleias`: `condominio_id`, `tipo='ordinaria'`, `data_hora='2026-11-23 18:00'`, `pauta`.
|
||||
2. Cria um `avisos` com `assembleia_id` apontando pra ela, `tipo='aviso'`, `data_evento` = mesma data/hora.
|
||||
3. Anexa os documentos (convocação, pauta detalhada) via `aviso_documentos`.
|
||||
4. Escolhe destinatários em `aviso_destinatarios` (síndico, subsíndico, conselheiros daquele condomínio + funcionários vinculados) — ou marca "todos" como padrão sugerido.
|
||||
5. Marca `enviar_whatsapp`/`enviar_email` e dispara.
|
||||
|
||||
---
|
||||
|
||||
## 4. Autenticação, financeiro/AbacatePay, dashboard, catálogo de funcionalidades
|
||||
|
||||
Sem mudanças em relação à v2.0 — seguem valendo:
|
||||
- 3 camadas de auth (master / escritório / API Key)
|
||||
- Módulo financeiro do escritório (assinaturas, períodos de uso, pagamentos PIX via AbacatePay, bloqueio automático)
|
||||
- Menu do dashboard (Master: Clientes/Planos/Financeiro/Configurações · Cliente: Cadastro Condomínio/Financeiro/Configurações)
|
||||
- Catálogo de `funcionalidades` (whatsapp, e-mail, API, exportação, auditoria etc.)
|
||||
|
||||
---
|
||||
|
||||
## 5. Endpoints ajustados
|
||||
|
||||
```
|
||||
CRUD /api/condominios
|
||||
CRUD /api/condominios/{id}/contatos (vincula/desvincula tipo=sindico|subsindico|conselheiro)
|
||||
CRUD /api/condominios/{id}/funcionarios-vinculados
|
||||
CRUD /api/condominios/{id}/espacos-comuns
|
||||
CRUD /api/condominios/{id}/assembleias
|
||||
CRUD /api/condominios/{id}/documentos
|
||||
POST /api/condominios/{id}/avisos (body: assembleia_id?, documentos: [id,...], destinatarios: [{tipo, id}, ...])
|
||||
GET /api/condominios/{id}/avisos/{id}
|
||||
```
|
||||
|
||||
**App externo (API Key)**
|
||||
```
|
||||
GET /api/external/condominios/{id}/resumo
|
||||
→ síndico/subsíndico/conselheiros atuais, próxima assembleia, avisos ativos, espaços comuns
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 6. Próximos passos
|
||||
|
||||
Escopo definitivo fechado. Posso começar os prompt files numerados agora (`01-setup-projeto-docker.md` em diante)?
|
||||
Reference in New Issue
Block a user