Termos técnicos e de negócio usados no projeto.
ADR — Architecture Decision Record. Registro de decisão arquitetural.
No projeto, vive em CONTEXTO_PROJETO.md (seção 9).
Alerting — Sistema de alertas administrativos por e-mail com deduplicação.
Audit Log — Tabela que registra create/update/delete de entidades
auditáveis, com diff (mascarado de campos sensíveis).
BaseRepository — Classe abstrata com CRUD genérico (find, where, paginate,
create, update, delete) usada por todos os repositórios.
Batch (migrations) — Agrupamento de migrations aplicadas juntas; permite
rollback em lote.
Backup verificado — Backup cuja integridade é validada por um comando
que descompacta e confere tabelas essenciais.
Cache — Armazenamento temporário em arquivo com TTL por namespace.
Canal — Google Ads, Meta Ads, TikTok Ads, Instagram, Outro. Catálogo global.
Container — Injetor de dependências com autowiring por reflexão.
Configurado em config/container.php.
CPL — Custo por Lead. investimento / leads.
CPA — Custo por Aquisição. investimento / vendas.
CSP — Content Security Policy. Cabeçalho HTTP que restringe origens de
scripts/estilos. No projeto, usa nonce em produção.
CSRF — Cross-Site Request Forgery. Mitigado por token em formulários.
CTR — Click-Through Rate. cliques / impressões × 100.
Diagnóstico — Avaliação estruturada de uma campanha em 8 critérios.
Gera score 0–100, classificação e recomendações.
Driver (e-mail) — log (grava em arquivo) ou smtp (envia de verdade).
EventoUso — Registro de uso da plataforma (login, criação de cliente, etc.).
Escopo (usuário) — Toda operação é filtrada por usuario_id.
Feedback — Reporte de bug, sugestão, dúvida ou elogio enviado pelo usuário.
Fila — Sistema de processamento assíncrono com retry exponencial.
Tabela fila_jobs.
FK — Foreign Key.
GuestMiddleware — Bloqueia rotas de convidado (login, cadastro) quando
já há sessão ativa.
Health Check — Endpoint /health que reporta status de DB, disco, mailer,
logs, backup e alertas.
HMAC — Hash-based Message Authentication Code. Usado para validar
assinaturas de webhooks.
HSTS — HTTP Strict Transport Security. Enviado apenas sob HTTPS.
Isolamento por usuário — Garantia de que um usuário nunca vê dados de outro.
Job — Tarefa processada pela fila (ex.: ProcessarWebhookJob).
Lead — Potencial cliente. Pipeline com 5 estágios.
Leadgen ID — Identificador de lead no Meta Ads.
Logger — Sistema de logs próprio com rotação por tamanho e formatostext/json.
Middleware — Camada que intercepta a requisição antes do handler.
Ex.: AuthMiddleware, CsrfMiddleware, ThrottleMiddleware.
Migration — Arquivo SQL versionado que altera o schema.
Multi-tenant simples — Isolamento por usuario_id no mesmo banco.
Nonce — Valor único por requisição usado em CSP para permitir inline scripts.
Onboarding — Jornada do usuário novo, do cadastro ao primeiro valor.
Estado derivado dos dados existentes.
Plano — Conjunto de itens de execução gerados a partir do diagnóstico.
Política de senha — Mínimo 10 caracteres, sem senhas comuns, sem nome/e-mail.
PSR-4 — Padrão de autoload por namespace.
Queue — Ver Fila.
QueueWorker — Serviço que processa jobs de uma fila.
Rate limit — Limite de tentativas por IP/janela. Aplicado em login,
cadastro, reset e 2FA.
Repository — Camada de acesso a dados. Estende BaseRepository.
Retry exponencial — Backoff 30/60/120/240/480s entre tentativas de um job.
ROAS — Return on Ad Spend. receita / investimento.
Score de diagnóstico — 0–100. Mede saúde estrutural da campanha.
Seeder — Script idempotente que popula dados iniciais (canais, perguntas).
Service — Camada com regra de negócio.
Session — Sessão PHP com flash messages, old input e errors.
Snapshot (relatório) — JSON imutável com dados do relatório no momento da
geração.
Social login — Não implementado.
SQLite — Banco usado em testes (in-memory).
Tenant — No projeto, equivalente a "usuário" (multi-tenant simples).
ThrottleMiddleware — Aplica rate limit em rotas específicas.
TOTP — Time-based One-Time Password. Padrão RFC 6238 usado no 2FA.
Token email — Token de confirmação ou reset de senha.
Upsert — INSERT ou UPDATE conforme existência. Usado em métricas e fila.
URL_BASE / URL_PATH — Variáveis do .env que compõem URLs em subpasta.
View — Template PHP. Não pode conter lógica complexa.
Verificação em dois passos — Sinônimo de 2FA.
Webhook — Endpoint público que recebe eventos externos (Google Ads, Meta Ads).
Worker — Ver QueueWorker.