Changelog

Todas as mudanças notáveis deste projeto são documentadas neste arquivo.

O formato segue Keep a Changelog
e o projeto adota Semantic Versioning.

[Unreleased]

Added

• Migrations webhook_eventos e fila_jobs com índices para consulta rápida.
• Support/Queue (fachada) + FilaJobRepository com reserva atômica,
  retry exponencial e limpeza.
• Support/WebhookSignature — HMAC hex/base64 com prefixo opcional
  (Google X-Goog-Signature, Meta X-Hub-Signature-256).
• Services/WebhookService — valida assinatura, deduplica por ID externo,
  persiste evento e enfileira ProcessarWebhookJob.
• Jobs/ProcessarWebhookJob — cria leads a partir de webhooks (Google Ads
  via gclid; Meta Ads via leadgen_id), com rastreio em observações.
• Services/QueueWorker — processa lotes, aplica backoff e registra falhas.
• Controllers/WebhookController — endpoints públicos /webhooks/google
  e /webhooks/meta (incluindo verificação hub.challenge).
• Comandos CLI: queue:work, queue:once, queue:status, queue:prune.
• AdminController::webhooks e fila + views correspondentes
  (sem CSS/JS inline; respeitam a regra de nonce).
• Links Webhooks e Fila na sidebar admin.
• CsrfMiddleware isenta rotas sob /webhooks/.
• config/webhooks.php e config/queue.php.
• docs/WEBHOOKS.md com endpoints, segurança, fluxo, worker e simulação.
• Testes: QueueTest, WebhookSignatureTest, WebhookServiceTest,
  QueueWorkerTest.

Changed

• Application::boot() inicializa Queue.
• docs/OPERACAO.md e docs/ROADMAP.md atualizados.
• .env.example ganhou WEBHOOK_* e QUEUE_*.

Added

• config/import.php com limites, aliases de cabeçalho e campos obrigatórios.
• Support/CsvImporter — detecção de separador, remoção de BOM, sniff de encoding
  (UTF-8/ISO-8859-1), normalização de cabeçalhos e iteração em generator.
• Services/ImportService — sugestão automática de mapeamento, preview com contagem
  de válidas/inválidas e erros por linha, confirmar() com upsert idempotente por
  (campanha_id, data).
• Controllers/ImportController — fluxo em etapas (upload → mapear → preview → confirmar),
  com cancelamento que remove o arquivo temporário.
• View metricas/import com stepper visual e tabela de prévia.
• Botão "Importar CSV" em /metricas.
• Sidebar redesenhada: perfil clicável no rodapé, seção "Administração" com
  Painel admin e Alertas (apenas para admin, com badge ADMIN).
• Helper global is_admin().
• storage/imports/ para arquivos temporários.
• Testes: CsvImporterTest e ImportServiceTest.

Changed

• partials/sidebar.php reescrito com agrupamento e bloco condicional de admin.
• .env.example ganhou IMPORT_MAX_BYTES e IMPORT_MAX_ROWS.
• config/container.php registra ImportService e ImportController.

Added

• Migration alertas_enviados (deduplicação de alertas por chave).
• Support/Alerting — canal de alertas por e-mail com deduplicação e log de envios.
• Services/AlertService — chaves canônicas (erro.500, disco.baixo, backup.falhou,
  erros.500.lote, teste.manual) com textos padronizados.
• Support/Backup — verificação de integridade do último dump (descompacta, extrai
  tabelas e valida contra a lista essencial).
• Hook de alerta de erro 500 em Application::renderServerError (silencioso em debug/testing).
• HealthController expandido com backup e alertas.
• AdminController + views admin/dashboard e admin/alertas (acesso restrito a
  usuários com perfil admin ou listados em ADMIN_USER_IDS).
• Config/AdminConfig — leitura de e-mails e IDs de admin.
• Comandos CLI: cache:clear, audit:prune, user:promote, backup:verify,
  alert:test, alert:list.
• Logger com formato json (logs/app.jsonl), sanitização de campos sensíveis
  e rotação por tamanho.
• docs/OPERACAO.md — runbook do dia a dia.
• Testes: LoggerJsonTest, BackupVerifyTest, AlertingTest, AdminDashboardTest.

Changed

• config/logging.php inclui format e json_path.
• .env.example ganhou ADMIN_EMAILS, ADMIN_USER_IDS, ALERT_* e LOG_FORMAT.
• docs/ROADMAP.md atualizado (Sprint 13 concluída + próximas sprints).

Added

• Support/Csp com nonce por request; SecurityHeadersMiddleware aplica CSP estrita
  ('unsafe-inline' só fora de produção).
• Support/Totp — TOTP RFC 6238 puro (secret base32, code, verify, backup codes, otpauth URI).
• Support/PasswordPolicy — mínimo 10 caracteres, bloqueio de senhas comuns e de
  senhas com e-mail/nome do usuário.
• TwoFactorService e TwoFactorRepository; 2FA opcional pós-login.
• TwoFactorController (setup, confirmação, desativação, regeneração de backup codes,
  desafio e verificação).
• PerfilController + views perfil/index e perfil/two-factor.
• AuditService + AuditRepository + tabela audit_log; hook opcional em BaseRepository
  ($auditable = true) com mascaramento de campos sensíveis.
• Rate limiting em /cadastro e /resetar-senha/{token}.
• AuthService::alterarSenha() e uso de PasswordPolicy em registro/reset.
• docs/SEGURANCA.md.
• Testes: TotpTest, PasswordPolicyTest, CspTest, AuditServiceTest.

Changed

• AuthService::login() retorna '2fa_required' quando 2FA está ativo; sessão fica
  pendente até a verificação.
• layouts/app.php usa assets externos (/assets/css/app.css, /assets/js/app.js).
• security.php ganha seções csp, password e two_factor.
• Container registra 2FA, auditoria e perfil.

Added

• config/container.php com todos os bindings de DI do projeto.
• Application::buildContainer() reduzido a executar o arquivo de configuração.
• tests/Support/TestCase.php — base para testes de feature com SQLite em memória,
  esquema completo e helpers (criarUsuario, criarCliente, criarCampanha, autenticar).
• tests/Support/HttpClient.php — simula requisições ao Router com sessão e CSRF.
• Testes de feature:
  • ClienteControllerTest (index, store, update, destroy, isolamento)
  • CampanhaControllerTest (store, filtros, isolamento)
  • DiagnosticoControllerTest (iniciar, responder, concluir)
  • MetricaControllerTest (lançar, validação, export CSV)
  • LeadControllerTest (pipeline, criar, mover, coluna AJAX, interação, export CSV)
  • RelatorioControllerTest (gerar, exibir, recarregar snapshot)
• docs/TESTES.md — guia de testes, política de cobertura e CI.
• .github/workflows/ci.yml — CI em PHP 8.1 e 8.2 (lint + PHPUnit).
• phpunit.xml atualizado com suíte Feature e <php><env> para testes.

Changed

• Application.php: DI movida para config/container.php.
• Testes rodam em SQLite puro, sem depender de MySQL.

Added

• Support/Cache (driver arquivo, TTL por namespace, remember, forget,
  flushNamespace, prune).
• config/cache.php + variáveis .env (CACHE_ENABLED, CACHE_DRIVER, CACHE_PATH, CACHE_PREFIX).
• Cache aplicado em MetricaService::resumoUsuario/resumoCampanha e em todas as
  consultas agregadas do DashboardController.
• Invalidação automática de cache (Cache::flushNamespace) nos writes de métricas
  e nos demais services de domínio.
• Support/Csv com BOM UTF-8, separador ;, floats em formato pt-BR e streaming.
• MetricaController::exportCsv (GET /metricas/export.csv?periodo=&campanha_id=).
• LeadController::exportCsv (GET /leads/export.csv?filtros…).
• Paginação AJAX do Kanban (GET /leads/coluna/{estagio}?offset=) + botão "Carregar mais".
• Migrations: índice composto metricas (usuario_id, data) e
  leads (usuario_id, estagio, updated_at).
• Helper asset_versioned() (hash de conteúdo em query string).
• Comando cleanup estendido para limpar cache expirado.

Changed

• DashboardController agora depende de Support\Onboarding e usa cache curto (60s).
• MetricaService e LeadService invalidam cache nos writes.
• Views metricas/index.php e leads/index.php incluem botões de exportação.
• leads/index.php implementa "carregar mais" por coluna via AJAX.

Added

• Migrations feedbacks (com contexto JSON) e eventos_uso (com sessão e IP).
• FeedbackRepository + FeedbackService (tipos bug/sugestão/dúvida/elogio;
  status novo/em_analise/resolvido/descartado).
• FeedbackController com widget universal, painel admin, resposta e endpoint de funil.
• EventoUsoRepository + EventoUsoService com eventos canônicos e prefixo outros.
  para eventos fora do vocabulário.
• EventoUsoController com endpoint fire-and-forget (POST /events).
• Widget universal de feedback no layout autenticado (feedbacks/widget.php).
• Tour de onboarding com 5 passos, controlado por localStorage, disparado na primeira sessão.
• Checklist de primeiros passos no dashboard, calculado a partir dos dados do usuário (Support/Onboarding).
• Instrumentação server-side nos controllers chave via EventoUsoService::registrarDoRequest.
• docs/ROADMAP.md com sprints concluídas e próximas.
• docs/FEEDBACK.md com fluxo de triagem e critérios de priorização.
• Testes: FeedbackServiceTest e EventoUsoServiceTest.

Changed

• DashboardController passa onboarding para a view.
• Dashboard/index.php inclui o card de primeiros passos (oculto quando 100%).
• partials/topbar.php adiciona botões de feedback e tour.
• partials/sidebar.php adiciona link de Feedbacks (admin) e Roadmap.
• Container registra novos repositórios, serviços e controllers.

Added

• Config security.php com headers, rate limiting e política de cookies.
• SecurityHeadersMiddleware aplicado globalmente (CSP, X-Frame-Options, HSTS em HTTPS, etc.).
• ThrottleMiddleware + RateLimiter (driver arquivo) para login e recuperação de senha.
• Logger com rotação por tamanho (logs/app.log + arquivos numerados).
• HealthController expandido (/health retorna DB, disco, mailer, PHP, logs).
• Comando cleanup no bin/console para limpar rate-limit e cache antigos.
• bin/backup.sh com dump do MySQL (--single-transaction) e tar do storage/, com retenção de N dias.
• Documentação: docs/DEPLOY.md, docs/SMOKE-TEST.md, docs/ONBOARDING.md.
• .htaccess raiz e public/ com headers, compressão e cache de assets.
• Novas variáveis .env: RATE_LIMIT_PATH, BACKUP_PATH, BACKUP_KEEP_DAYS.
• Testes: RateLimiterTest (5 casos) e SecurityHeadersTest (4 casos).

Changed

• Application::boot() configura Logger antes de qualquer código executável.
• Application::logError() usa Logger::error() com contexto estruturado.
• Rotas /login e /esqueci-senha agora têm ThrottleMiddleware.
• config/logging.php inclui política de rotação.

Added

• Migrations leads e interacoes_lead com FKs, índices e timestamps de conversão/perda.
• LeadRepository (pipeline por estágio, paginação, resumo agregado, por cliente/campanha).
• InteracaoLeadRepository (por lead, tipos, checagem de posse).
• LeadService:
  • criação com validação e interação inicial automática;
  • movimentação de estágio com timestamps de conversão/perda + interação de log;
  • registro de interações tipadas (nota, ligação, e-mail, WhatsApp, reunião, proposta);
  • resumo com valor em pipeline e valor convertido.
• LeadController com index (Kanban + tabela), create, store, show, edit, update,
  mover, interagir, excluirInteracao e destroy.
• Views leads/index (Kanban drag-and-drop com fallback de clique), leads/form e
  leads/show (detalhe + timeline de interações + mover estágio).
• Integração em campanhas/show (bloco "Leads gerados" com KPIs) e
  clientes/show (bloco "Leads" com valor em pipeline).
• Dashboard com KPIs de leads (total, pipeline, convertido, distribuição por estágio).
• Sidebar com link "Leads" no grupo Resultados.
• Testes: LeadServiceTest cobrindo estágios, pipeline, interações, isolamento e conversão.

Changed

• CampanhaController::show() injeta leads da campanha.
• ClienteController::show() injeta leads do cliente.
• DashboardController recebe LeadService.
• Container registra LeadRepository, InteracaoLeadRepository, LeadService e LeadController.

Added

• Migration relatorios com snapshot JSON e FK para clientes/usuários.
• RelatorioRepository (paginação, por cliente, resumo, decode do snapshot).
• RelatorioService que consolida:
  • métricas agregadas do período (investimento, impressões, cliques, leads, vendas, receita, CTR, CPL, CPA, ROAS);
  • campanhas com resumo individual;
  • diagnósticos concluídos dentro do período;
  • planos com progresso;
  • resumo geral (campanhas ativas, score médio).
  • Snapshot imutável gravado no momento da geração; atualizarSnapshot() recalcula.
• RelatorioController com index, novo, store, show, recarregar e destroy.
• Views relatorios/index, relatorios/novo e relatorios/show
  com layout profissional de impressão (@media print oculta sidebar/topbar/ações
  e respeita margens de página).
• Integração em clientes/show (botão "Gerar relatório" + histórico).
• Dashboard com KPIs de relatórios e ação rápida.
• Sidebar com link "Relatórios" no grupo Resultados.
• Testes: RelatorioServiceTest cobrindo geração, validações de período,
  isolamento, imutabilidade do snapshot, listagem e resumo.

Changed

• ClienteController::show() injeta relatórios do cliente via container.
• DashboardController recebe RelatorioService.
• Container registra RelatorioRepository, RelatorioService e RelatorioController.

Added

• Migration metricas com UNIQUE (campanha_id, data) para evitar duplicidade.
• MetricaRepository com somas por campanha/usuário, série diária e top campanhas.
• MetricaService com:
  • lançamento com upsert por dia;
  • validações de consistência (cliques ≤ impressões, leads ≤ cliques, vendas ≤ leads);
  • cálculos derivados (CTR, CPL, CPA, ROAS, taxa de conversão);
  • resumos agregados por campanha/usuário e séries temporais.
• MetricaController com index, porCampanha, lancar, store e destroy.
• Views metricas/index, metricas/campanha e metricas/lancar.
• App\Support\Chart com gráfico de linha comparativo e sparkline (SVG puro).
• Integração em campanhas/show com mini-KPIs e sparkline de investimento.
• Dashboard com 4 KPIs de métricas (30d) e gráfico consolidado.
• Sidebar com grupo "Resultados" e link "Métricas".
• Testes: MetricaServiceTest cobrindo cálculos (CTR/CPL/CPA/ROAS), upsert,
  validações, agregações, série e isolamento por usuário.

Changed

• CampanhaController::show() injeta resumo e série de métricas.
• DashboardController recebe MetricaService e expõe 30 dias por padrão.
• Container registra MetricaRepository, MetricaService e MetricaController.

Added

• Migrations planos_campanha e itens_plano com FKs e índices.
• PlanoCampanhaRepository (paginação com progresso embutido, resumo agregado,
  busca por campanha/diagnóstico) e ItemPlanoRepository (itens por plano,
  progresso, marcar concluído, exclusão em cascata).
• PlanoCampanhaService:
  • criarAPartirDoDiagnostico() gera plano com ~14 itens organizados em 6 categorias
    (Estrutura, Palavras-chave, Criativos, Landing page, Rastreamento, Lançamento, Otimização),
    com prioridades derivadas do diagnóstico;
  • criarManual() permite plano com itens passados linha a linha;
  • marcarItem() atualiza progresso de forma idempotente;
  • montarPlanoDeDiagnostico() exposto para testes.
• PlanoCampanhaController com index, create, store, gerarDoDiagnostico,
  show, edit, update, destroy, marcarItem.
• Views planejamento/index, planejamento/form e planejamento/show com barra
  de progresso circular, checklist interativo (marcação assíncrona) e layout responsivo.
• Integração em campanhas/show com histórico de planos e botão "Gerar plano do diagnóstico".
• Dashboard com KPIs de planos (ativos, progresso geral, itens pendentes, concluídos).
• Sidebar com link "Planejamento".
• Testes: PlanoCampanhaServiceTest cobrindo geração automática, validações,
  progresso, isolamento por usuário e cascata de exclusão.

Changed

• CampanhaController::show() injeta planos via container.
• DashboardController recebe PlanoCampanhaService.
• Container registra PlanoCampanhaRepository, ItemPlanoRepository,
  PlanoCampanhaService e PlanoCampanhaController.

Added

• Migrations perguntas_diagnostico, diagnosticos e respostas_diagnostico
  com FKs, índices e constraint única por (diagnóstico, pergunta).
• Seeder idempotente perguntas_diagnostico_seeder com 8 perguntas base
  (objetivo, público, localização, orçamento, keywords, anúncios, landing, rastreamento),
  cada uma com opções, pontos, recomendação e prioridade.
• PerguntaDiagnosticoRepository (com decode automático do JSON de opções),
  DiagnosticoRepository (busca por usuário, por campanha, em-andamento e último concluído)
  e RespostaDiagnosticoRepository (upsert idempotente por diagnóstico+pergunta).
• DiagnosticoService com motor de regras determinístico:
  • iniciar() cria ou retoma diagnóstico em andamento;
  • responder() valida valor e persiste pontos/recomendação/prioridade;
  • concluir() valida completude e calcula score 0–100, classificação
    (saudavel/atencao/risco/critico) e problema principal (prioridade alta primeiro,
    depois maior perda absoluta);
  • recomendacoesPorPrioridade() agrupa recomendações em alta/média/baixa.
• DiagnosticoController com wizard (iniciar, responder, concluir, continuar, show).
• View diagnostico/wizard.php com navegação por etapas, auto-avanço após resposta,
  persistência assíncrona e barra de progresso.
• View diagnostico/relatorio.php com score circular SVG, classificação colorida,
  problema principal em destaque, recomendações priorizadas e tabela de respostas;
  layout de impressão dedicado.
• Integração do histórico de diagnósticos em campanhas/show.php.
• Controller::rotuloOpcao() e DiagnosticoService::rotulo() para rótulos amigáveis.
• Testes: DiagnosticoServiceTest cobrindo motor de regras (score em extremos,
  classificações, priorização, agrupamento) e fluxo completo com banco.

Changed

• CampanhaController::show() passa a injetar diagnósticos da campanha via container.
• bin/console seed agora suporta múltiplos seeders.
• Container registra repositories, service e controller de diagnóstico.

Added

• Migration canais com catálogo fixo (Google Ads, Meta Ads, TikTok Ads, Instagram, Outro)
  e seeder idempotente (database/seeders/canais_seeder.php).
• Migration campanhas com FKs para usuarios, clientes e canais.
• CanalRepository + CanalService (listagem, opções compactas, busca).
• CampanhaRepository com paginação, filtros combinados (busca, canal, cliente, status),
  resumo agregado por status e top por orçamento.
• CampanhaService com validação server-side (cliente pertence ao usuário, canal existe,
  nome único por usuário, orçamento não-negativo, coerência de datas, status/objetivo válidos).
• CampanhaController completo (index com filtros, create, store, show, edit, update, destroy).
• Rotas de campanhas agrupadas em AuthMiddleware.
• Views campanhas/index (filtros + paginação), campanhas/form (criar/editar) e
  campanhas/show (detalhe com placeholder para métricas).
• Dashboard expandido com 4 KPIs de campanhas e ranking de top campanhas por orçamento.
• Link "Campanhas" ativo na sidebar.
• Comando seed no CLI (php bin/console seed [nome]).
• Testes: CanalServiceTest (4 casos) e CampanhaServiceTest (12 casos).

Changed

• DashboardController agora injeta CampanhaService.
• Container registra CanalRepository, CampanhaRepository, CanalService,
  CampanhaService e CampanhaController.

Added

• DashboardController com dashboard real: KPIs (total, ativos, inativos, segmentos),
  ações rápidas, gráfico de barras de segmentos e lista de clientes recentes.
• ClienteRepository::resumoPorUsuario() e ClienteService::resumo() (agregações por status e segmento).
• Componente Alert (App\Support\Alert) com API fluente (success/error/warning/info)
  e render() idempotente, eliminando duplicação do partial flash.
• Testes: AlertTest (5 casos) e casos adicionais de ClienteServiceTest::resumo.
• Backdrop e fechamento automático da sidebar em mobile (toque no link, clique no backdrop, ESC).
• Tabelas responsivas em telas ≤640px, convertendo linhas em cards com data-label.

Changed

• layouts/app.php reescrito com menu mobile robusto e CSS de tabela responsiva.
• partials/flash.php simplificado: delega para Alert::render().
• layouts/auth.php usa Alert::render() diretamente.
• ClienteController e AuthController passam a usar Alert::* no lugar de Session::flash.
• AuthController::dashboard() removido (migrado para DashboardController).
• Rota /dashboard agora aponta para DashboardController::index.
• Container registra DashboardController.

Added

• Layout autenticado (layouts/app.php) com sidebar, topbar e identidade visual do protótipo.
• Partial sidebar com navegação (Dashboard, Clientes) e logout em formulário POST+CSRF.
• Partial topbar com Changelog/subChangelog dinâmicos e slot de ações.
• CRUD completo de clientes:
  • ClienteRepository com findByUsuarioId, existsByNome, paginateByUsuario e countByUsuario.
  • ClienteService com validação server-side, unicidade por usuário (case-insensitive),
    autorização por usuario_id e mensagens de erro prontas para o usuário.
  • ClienteController com index, create, store, show, edit, update, destroy.
• Componente Pagination (helper + partial) com preservação de query string.
• Views clientes/index, clientes/form e clientes/show fiéis ao protótipo aprovado,
  com estados vazios, feedbacks personalizados e responsividade.
• Rotas autenticadas de clientes registradas em AuthMiddleware, com CSRF global.
• Container atualizado com bindings de ClienteRepository e ClienteService.
• AuthController::dashboard agora exibe contagem de clientes do usuário (placeholder até Sprint 2).
• Testes: ClienteServiceTest (16 casos) e PaginationTest (5 casos).

Added

• Serviço de e-mail com drivers intercambiáveis (log / smtp) controlados por MAIL_DRIVER.
• LogDriver grava mensagens formatadas em logs/email.log (útil em desenvolvimento).
• SmtpDriver envia via PHPMailer lendo credenciais de config/mail.php / .env.
• TokenService com tokens de uso único (random_bytes(32) + sha256), expiração
  e invalidação automática de tokens anteriores do mesmo tipo.
• UsuarioRepository e TokenEmailRepository (herdam BaseRepository).
• AuthService: cadastro, confirmação por e-mail, login (bloqueado sem confirmação
  e com reenvio automático), logout, iniciarResetSenha() (reenvia confirmação se
  e-mail ainda não validado), resetarSenha().
• Session com start idempotente, flash messages, old input, errors e expiração por inatividade.
• Csrf (geração, campo, validação com hash_equals) e CsrfMiddleware aplicado globalmente.
• AuthMiddleware e GuestMiddleware.
• Container minimalista com autowiring por reflexão (App\Kernel\Container).
• Views de autenticação (login, cadastro, esqueci-senha, resetar-senha,
  confirmar-sucesso) coerentes com o protótipo aprovado.
• Helpers old(), csrf_token(), csrf_field(), flash(), auth_user(), auth_check().
• Router ajustado para espalhar parâmetros de rota como argumentos adicionais do handler.
• Testes: LogDriverTest, TokenServiceTest, AuthServiceTest (fluxo completo).

Added

• Camada de banco com Database (PDO singleton, MySQL/SQLite, transações seguras).
• Migrator com suporte a up/down, batches, status, pending, rollback e fresh.
• Migration inicial: usuarios, tokens_email (com FK e cascade) e clientes (com FK para usuarios).
• BaseRepository com find, findOrFail, findBy, all, where, count, exists,
  paginate, create, update, delete, deleteWhere e proteção via $fillable/$guarded.
• CLI em bin/console com comandos migrate, rollback [N], status, fresh --force e help.
• Testes com SQLite in-memory: DatabaseTest, MigratorTest, BaseRepositoryTest.

Added

• Camada HTTP completa: Request, Response, Route, Router.
• Roteamento com parâmetros ({id}), grupos (prefix, name, middleware),
  rotas nomeadas e geração de URL (->name(), Router::url(), route()).
• Middlewares globais e por rota via MiddlewareInterface.
• Tratamento de 404, 405 e 500 com views dedicadas e resposta JSON
  automática quando o cliente pede application/json.
• View renderer simples com setBasePath().
• Controller base com view(), json(), redirect(), back().
• Helpers route(), esc() e base_url()/asset() revisados para evitar
  barras duplicadas quando URL_PATH está vazio.
• Suíte PHPUnit inicial (RequestTest, RouterTest) + phpunit.xml.
• Log de erros em logs/app.log a partir do Application::logError().

Added

• Estrutura inicial de diretórios (app, config, public, routes, storage, logs, database, tests, docs).
• Bootstrap da aplicação com carregamento de .env via vlucas/phpdotenv (safeLoad).
• Helper base_url() e asset() respeitando URL_BASE + URL_PATH (funciona em subpasta do htdocs).
• Helpers globais env(), base_url(), asset().
• Arquivos de configuração app.php, database.php, mail.php, logging.php.
• Sistema de logs em logs/ (fora do versionamento).
• Driver de e-mail configurável (log / smtp) com suporte a logs/email.log.
• .htaccess raiz redirecionando para /public e front controller em public/.htaccess.
• .gitignore, .editorconfig.
• composer.json com dependências base (phpdotenv, PHPMailer, Monolog) e PHPUnit em dev.
• Documentação inicial: README.md, CONTEXTO_PROJETO.md.

[0.0.1] - 2026-09-23

Added

• Commit inicial do repositório.