Analise da Arvore do Codigo

Estrutura principal

/var/www/html/cobranca
|-- index.php
|-- dashboard_*.php
|-- acompanhamento_*.php
|-- painel_*.php
|-- relatorios.php
|-- config/
|   |-- database.php
|   |-- database_sqlsrv.php
|   |-- juridico.php
|   `-- kb_routes.php
|-- src/
|   |-- api/
|   |   |-- auth/
|   |   |-- cobranca30/
|   |   |-- dashboard_digital/
|   |   |-- documentos/
|   |   |-- juridico/
|   |   |-- kb/
|   |   |-- lembretes/
|   |   |-- texto/
|   |   `-- triagem/
|   |-- contatos/
|   |-- controllers/
|   |-- lib/
|   |-- middleware/
|   |-- models/
|   `-- views/
|-- js/
|-- assets/js/
|-- public/
|   |-- assets/kb/
|   |-- partials/
|   `-- uploads/kb/
|-- storage/documentos/
|-- docs/
|-- database/
|-- sql/
|-- vendor/
|-- _evo/
`-- _evo-output/

Responsabilidade por diretorio

Raiz do projeto

Contem as paginas PHP principais. Aqui fica a maior parte dos entry points web acessados pelo usuario. Cada pagina tende a:

• exigir autenticacao,
• renderizar HTML base,
• incluir header.php e footer.php,
• carregar um JS especifico que chama APIs JSON.

config/

Concentrador de conexoes e configuracoes basicas:

• database.php: MySQL principal e banco juridico.
• database_sqlsrv.php: SQL Server Gestor90.
• juridico.php: flags/config de integracao juridica.
• kb_routes.php: contexto da base de conhecimento.

src/api/

Camada mais importante do sistema para evolucao funcional. Agrupa endpoints JSON, persistencia auxiliar e regras operacionais.

Subpastas com maior peso:

• cobranca30/: registro e conciliacao do fluxo 30 dias.
• documentos/: upload, listagem, download, remocao e ZIP de documentos.
• dashboard_digital/: KPIs do painel executivo.
• lembretes/: pendencias operacionais do cobrador.
• juridico/: verificacao e encaminhamento.
• texto/: configuracao de IA e revisao de observacoes.
• kb/: APIs da base de conhecimento.

src/contatos/

Area de telas detalhadas e historicos por cliente. E um dos polos de negocio mais sensiveis. Combina:

• consulta,
• cadastro de historico,
• exibicao de parcelas,
• geracao de PDF,
• apoio de IA,
• anexos/documentos.

src/middleware/

Controles de sessao e autenticacao:

• auth.php
• auth_api.php
• session_boot.php

src/views/

Blocos de UI reutilizaveis e componentes da base de conhecimento.

• partials/: header/footer e componentes globais.
• components/: cards e grids de dashboards.
• kb/: views do modulo de ajuda.

js/ e assets/js/

JS de pagina e JS de funcionalidade embutida.

• js/: scripts das paginas principais.
• assets/js/: scripts acoplados a modais, IA e documentos em telas de contato.

database/ e sql/

Artefatos SQL formais encontrados:

• database/kb_schema.sql: schema da base de conhecimento.
• sql/clientes_inativos.sql: schema de clientes inativos.

Observacao: nem todo schema esta aqui; varias tabelas sao inferidas do codigo ou criadas em runtime.

storage/documentos/

Repositorio fisico de uploads de clientes. Fica fora do public/ e e manipulado por src/api/documentos/*.

_evo/ e _evo-output/

Instalacao local do EVO Method:

• _evo/: agentes, workflows e memoria do metodo.
• _evo-output/: pasta reservada a artefatos de planejamento/execucao do metodo.

Entry points mais relevantes

• index.php: login
• dashboard_gerencia.php: cockpit gerencial
• dashboard_cobrador.php: operacao do cobrador
• dashboard_digital.php: painel executivo
• consulta_historicos.php: busca e investigacao operacional
• painel_distribuicao.php: distribuicao de carteira
• carteira_saudavel.php: manutencao de inativos
• acompanhamento_30dias.php
• acompanhamento_renegociacao.php
• acompanhamento_juridico.php

Padroes observados

• Pagina PHP com HTML inicial e script dedicado.
• Queries SQL extensas diretamente nos endpoints.
• JSON como contrato interno entre pagina e API.
• Reuso parcial de componentes via src/views/components.
• Ausencia de framework MVC unico; o projeto e parcialmente modular e parcialmente procedural.