Acompanhamento da Feature

Chronos Sync Local - BMAC Method

Painel de leitura da documentação, planejamento e implementação por feature, com seleção centralizada antes da navegação.

Relatório Executivo Selecionar Feature Voltar ao Login
Planejamento
9
Stories
9 10 arquivos
Em Review
0
Prontas p/ Dev
0
Concluídas
9
Docs
27
Progresso Total da Feature
Feature `chronos-sync-local`
9 concluídas, 0 em review, 0 prontas para dev, 0 ainda não iniciadas.
Andamento estimado
100%
Próximos Passos
BMAC Nenhum próximo passo automático identificado com o estado atual dos artefatos.
Filtros de Stories
Epics e Stories
Epic 1: Fundacao da Sincronizacao Local
Progresso estimado 100%
3 concluídas, 0 em review, 0 prontas para dev
1.1
Modelar armazenamento local dos dados Chronos
complete
1.2
Definir carga completa inicial e reconciliacao
complete
1.3
Definir carga incremental recorrente
complete
Epic 2: Consumo Local na Dashboard
Progresso estimado 100%
3 concluídas, 0 em review, 0 prontas para dev
2.1
Substituir leitura online por leitura local em quebras
complete
2.2
Reaplicar ownership e classificacao de grids com base local
complete
2.3
Preservar acoes existentes com fallback no SQL Server
complete
Epic 3: Operacao e Observabilidade
Progresso estimado 100%
3 concluídas, 0 em review, 0 prontas para dev
3.1
Agendamento e monitoramento das sincronizacoes
complete
3.2
Indicadores de atraso, falha e divergencia
complete
3.3
Homologacao e rollout controlado
complete
Biblioteca de Documentos
Planning Artifacts
architecture.md epics.md feature-overview.md implementation-plan.md implementation-readiness-report.md prd.md
Implementation Artifacts
1-1-modelar-armazenamento-local-dos-dados-chronos.md 1-2-definir-carga-completa-inicial-e-reconciliacao.md 1-3-definir-carga-incremental-recorrente.md 2-1-substituir-leitura-online-por-leitura-local-em-quebras.md 2-2-reaplicar-ownership-e-classificacao-de-grids-com-base-local.md 2-3-preservar-acoes-existentes-com-fallback-no-sql-server.md 3-1-agendamento-e-monitoramento-das-sincronizacoes.md 3-2-indicadores-de-atraso-falha-e-divergencia.md 3-3-homologacao-e-rollout-controlado.md README.md
Docs do Projeto
api-contracts.md architecture.md chronos-sync-local-operations.md como-abrir-uma-negociacao.md component-inventory.md data-models.md deployment-guide.md development-guide.md documentacao_api_planeta.txt fluxo-de-cobranca-30-dias.md index.md kb-governanca-e-cobertura.md manual-dashboard-cobrador.md manual-fechamento-gratificacoes.md manual-metas-premios.md perfis-e-permissoes.md politica-de-seguranca-e-backup.md project-overview.md project-scan-report.json relatorios-e-kpis.md source-tree-analysis.md travessia_campos_0002449.txt travessia_endpoints_credits_0002449_raw.txt travessia_parcelas_0002449_blocos.txt travessia_parcelas_0002449_info.txt travessia_parcelas_0002449_pretty.json travessia_parcelas_0002449_raw.json
Planejamento Legado
epics.md homologation-and-release-strategy.md implementation-plan.md
docs/development-guide.md

Guia de Desenvolvimento

DOCS MD
Sumário rápido
Guia de Desenvolvimento Pre-requisitos Dependencias PHP Configuracao de banco MySQL SQL Server Subir o projeto localmente Configuracoes operacionais relevantes Ponto de entrada por fluxo Como localizar uma alteracao Alteracao visual em pagina Alteracao em regra de cobranca Alteracao em uploads/documentos Alteracao em IA Estrategia recomendada para novas features Testes e validacao EVO Method no projeto

Guia de Desenvolvimento

Pre-requisitos

  • PHP 8.x com extensoes para:
    • pdo_mysql
    • pdo_sqlsrv
    • curl
    • mbstring
    • gd
    • fileinfo
  • Composer
  • Acesso ao MySQL principal
  • Acesso ao SQL Server Gestor90
  • Apache ou stack equivalente com suporte a PHP-FPM

Dependencias PHP

Dependencias declaradas em composer.json:

  • erusev/parsedown
  • ezyang/htmlpurifier
  • dompdf/dompdf

Instalacao:

composer install

Configuracao de banco

MySQL

Arquivo: config/database.php

Responsabilidades:

  • autenticacao
  • historicos
  • usuarios
  • clientes inativos
  • documentos
  • metas e gratificacoes
  • KB

SQL Server

Arquivo: config/database_sqlsrv.php

Responsabilidades:

  • carteira
  • propostas
  • parcelas
  • recebimentos
  • dados financeiros de origem

Subir o projeto localmente

Exemplo simples:

php -S 0.0.0.0:8080 -t /var/www/html/cobranca

Observacao:

  • o ambiente real do projeto parece depender de Apache/PHP-FPM, entao o servidor embutido do PHP e util apenas para verificacoes rapidas

Configuracoes operacionais relevantes

Arquivo .user.ini:

  • memory_limit = 512M
  • upload_max_filesize = 64M
  • post_max_size = 64M
  • max_execution_time = 120
  • date.timezone = America/Sao_Paulo

Ponto de entrada por fluxo

Como localizar uma alteracao

Alteracao visual em pagina

  1. localizar a pagina PHP da raiz
  2. localizar o script em js/ ou assets/js/
  3. localizar o endpoint em src/api/

Alteracao em regra de cobranca

Buscar primeiro em:

  • src/api/functions_cobranca.php
  • src/api/cobranca30/*
  • src/contatos/*
  • dashboard_data.php

Alteracao em uploads/documentos

Buscar em:

  • assets/js/documentos_cliente.js
  • src/api/documentos/*
  • storage/documentos/

Alteracao em IA

Buscar em:

  • assets/js/config_ia.js
  • assets/js/historico_clientes_ia.js
  • src/api/texto/*

Estrategia recomendada para novas features

  1. mapear pagina + JS + endpoint + tabela afetada
  2. validar qual banco e fonte da verdade do fluxo
  3. manter compatibilidade com sessao e perfis
  4. preferir adicionar logs de erro em endpoints novos
  5. evitar duplicar SQL sem extrair criterio comum quando a logica for critica

Testes e validacao

Nao foi encontrada suite de testes automatizados da aplicacao.

Validacao pratica recomendada:

  1. validar login com perfil gerencia e cobrador
  2. validar a pagina principal afetada
  3. validar o endpoint diretamente no navegador ou via fetch da propria pagina
  4. verificar logs em logs/
  5. confirmar efeitos no MySQL e no SQL Server

Existe apenas um arquivo utilitario de teste/manual:

EVO Method no projeto

O metodo EVO foi instalado localmente:

Fluxos relevantes para evolucao futura:

  • document-project
  • generate-project-context
  • create-prd
  • create-architecture