Plataforma web full-stack para gestão completa de cobranças de condomínios: inadimplência, jurídico, financeiro, recebimentos, agenda e disparo automatizado via WhatsApp. Integra API Superlógica, Evolution API (WhatsApp) e Google Sheets, com controle de acesso e aprovação manual de usuários.

• Visão geral consolidada — KPI cards com total de inadimplentes, condomínios ativos, maior devedor e unidades sem número cadastrado
• Ranking de condomínios — ordenado por valor total de inadimplência com barras percentuais proporcionais
• Filtro "Últimos 5 anos" — exibe apenas inadimplências com vencimento nos últimos 5 anos, com cache separado por filtro
• Cache local + servidor — TTL de 30 minutos, chave separada por filtro (_5a / _all), pré-carregamento em background e botão "Forçar" para limpar

• Dashboard consolidado — KPIs de total em dívida, total de processos, unidades com/sem processo, movimentações na semana, condomínios e advogados
• CRUD de advogados — cada advogado tem uma planilha Google Sheets associada (spreadsheet_id + aba)
• Top 20 devedores — ranking consolidado a partir das planilhas dos advogados
• Análise por situação judicial — agrupamentos por advogado e condomínio

• Despesas via Superlógica — resumo por categoria, fornecedor e mês
• Liquidação de despesas — baixa direto pelo Superlógica
• Despesas locais — CRUD próprio para despesas fora do Superlógica
• Fila de pagamento — controle da ordem e status dos pagamentos

• Dashboard com 4 blocos — Geral, COSERN Loja 71, COSERN Loja 114 e Diversos
• Previsto vs Recebido vs Pendente — KPI de % de recebimento
• Fluxo de caixa — série temporal por data
• Setores configuráveis — permite mapear setores financeiros personalizados

• Calendário de tarefas — CRUD com checklist por tarefa
• Insights mensais — despesas (pendentes, pagas no mês, vencendo em 7 dias, vencidas)
• Inadimplência consolidada — variação mensal/anual, projeção e top condomínios

• Geração em lote — DOCX e PDF de documentos de execução por unidade, entregues em ZIP

• Planilha de clientes — consulta à base "CLIENTES PRATIKA 2026"

• Exportação Excel (.xlsx) — abas Resumo e Detalhado, processamento assíncrono com polling de status
• Exportação PDF — relatório formatado com logo, tabela por condomínio, linha de totais, efeito zebrado
• Filtro "Últimos 5 anos" — aplicável a Excel e PDF
• Ordenação decrescente — botão "Maior valor primeiro"
• Filtros por condomínio e por data de posição

• Disparo em lote — envia para todos os números do Excel (colunas Telefone 1 e Telefone 2)
• Templates personalizados — variáveis dinâmicas ou mensagem padrão
• Reenvio seletivo — reenvie apenas mensagens aguardando resposta
• Histórico de campanhas — enviados, respondidos e erros por campanha

• Sidebar retrátil — modo rail com ícones ou expandida com labels, estado persistente
• Tema claro/escuro — persistência no localStorage
• Login seguro — sidebar não renderiza na tela de login

.
├── projeto_disparador/              # Backend Django
│   └── core/
│       ├── models.py                # User, MessageTemplate, Campanha, MensagemEnviada, AdvogadoPlanilha
│       ├── auth.py                  # Autenticação JWT
│       ├── api.py                   # Rotas de autenticação
│       ├── admin_api.py             # Dashboard, relatórios, exportação, usuários
│       ├── campanha_api.py          # Campanhas e reenvio de mensagens
│       ├── message_api.py           # Disparo de mensagens via planilha
│       ├── template_api.py          # CRUD de templates
│       ├── juridico_api.py          # Dashboard jurídico + CRUD advogados
│       ├── financeiro_api.py        # Despesas Superlógica, locais e fila de pagamento
│       ├── sheets_api.py            # Integração Google Sheets (recebimentos, fluxo)
│       ├── agenda_api.py            # Tarefas e insights combinados
│       ├── execucao_api.py          # Geração de DOCX/PDF de execuções
│       ├── sindico_api.py           # Planilha de clientes/síndicos
│       ├── webhook_api.py           # Webhooks
│       ├── services.py              # Processamento de planilhas
│       ├── evolution_service.py     # Integração Evolution API
│       ├── superlogica.py           # Integração API Superlógica
│       ├── sheets_service.py        # Cliente Google Sheets API
│       └── settings.py              # Configurações Django
├── frontend/
│   └── src/
│       ├── App.vue                  # Sidebar retrátil, tema claro/escuro
│       ├── main.js                  # Temas pratikaLight / pratikaDark
│       └── views/
│           ├── AuthView.vue         # Login
│           ├── DashboardView.vue    # Dashboard de inadimplência
│           ├── ReportsView.vue      # Relatórios Excel/PDF
│           ├── CampanhasAba.vue     # Histórico de campanhas
│           ├── TemplatesView.vue    # Gerenciar templates
│           ├── AdminView.vue        # Administração de usuários
│           ├── JuridicoView.vue     # Dashboard jurídico + advogados
│           ├── FinanceiroView.vue   # Despesas Superlógica
│           ├── AgendaView.vue       # Calendário + insights
│           ├── SheetsView.vue       # Recebimentos (Google Sheets)
│           ├── ExecucaoView.vue     # Geração de execuções
│           ├── SindicosView.vue     # Planilha de síndicos
│           ├── LevantamentoView.vue
│           └── PainelView.vue
├── credentials/
│   └── google-sheets.json           # Credenciais da Google Sheets API
├── docker-compose.yml
└── README.md

Variáveis injetadas via docker-compose.yml ou .env:

• Docker v2+
• Docker Compose

docker compose up --build -d

O script de inicialização aplica as migrações automaticamente e cria o usuário administrador padrão.

docker compose down

E-mail: admin@admin.com
Senha:  admin123

⚠️ Troque a senha padrão antes de usar em produção.

1. Administrador faz login
        ↓
2. Dashboard — visualiza inadimplência por condomínio
   [Opcional] Ativa filtro "Últimos 5 anos"
        ↓
3. Relatórios → configura filtros e exporta Excel ou PDF
        ↓
4. Faz upload do Excel gerado na seção de disparo
        ↓
5. Seleciona template (opcional) e envia mensagens
        ↓
6. Sistema envia WhatsApp para Telefone 1 e Telefone 2
        ↓
7. Resumo: ✅ Enviados | ❌ Erros | 📵 Sem número
        ↓
8. Campanhas → acompanha respostas e reenvia

Em paralelo:

• Jurídico centraliza processos por advogado (planilhas Google Sheets)
• Financeiro consolida despesas do Superlógica + despesas locais + fila de pagamento
• Recebimentos acompanha previsto vs recebido em tempo real via Google Sheets
• Agenda combina tarefas do dia com insights mensais de despesas e inadimplência

• Todos os endpoints (exceto login) exigem autenticação via JWT
• Operações administrativas restritas a is_staff ou is_superuser
• Novos usuários ficam bloqueados até aprovação manual pelo administrador
• Senhas armazenadas com hash via Django Auth
• Credenciais do Google Sheets isoladas em credentials/ (fora do versionamento)

MIT © 2026 João Ricardo