Skip to content

MVP Release Candidate Checklist

[!WARNING] [SUPERSEDED] Os blockers e pendências remanescentes neste Release Candidate migraram e foram consolidados para execução no docs/releases/roadmap-to-production.md. Este arquivo é mantido exclusivamente pelo seu valor de Snapshot Histórico Sintético.

Status: release candidate para produção com dados sintéticos.

Recomendação atual: Go para produção, desde que os comandos de validação listados abaixo continuem verdes no CI e os secrets/resources de produção estejam configurados fora do repositório.

Escopo validado:

  • backend API-first, packages reutilizáveis e contratos compartilhados;
  • lifecycle SCF-Based Assessment com state machine, approval gates e artefatos versionados;
  • segurança inicial com auth placeholder local, RBAC, tenant isolation, upload security e prompt security;
  • observability com logs estruturados, redaction, audit/security events, metrics e usage/cost records;
  • evals determinísticos, golden datasets sintéticos, regression tests e synthetic E2E.
ÁreaStatusEvidência
Repository consistencyAtendido para MVPPackages, apps e workers possuem package.json; exports principais existem em src/index.ts; scripts raiz cobrem lint, typecheck, tests e build.
API-firstAtendidoRegras críticas vivem em packages/*, workers/* e apps/api-gateway; frontend permanece consumidor/placeholder.
Multi-tenancyAtendido para MVPTenant guards, tenant_id, organization_id e assessment_id aparecem em rotas críticas, schemas, tests e fixtures.
SecurityAtendidoRBAC, upload validation, prompt injection guardrails, secure errors, redaction, rate limiting real (KV), observability persistente (PostgreSQL). Anti-malware scan é pós-MVP.
Assessment EngineAtendidoState transitions, approval gates, artifact immutability, rejection/rework loops e versionamento têm testes de package.
SCF Data ServiceAtendidoSCF 2026.1.1 oficial importado e seedado em produção via importer XLSX.
Document IngestionAtendido para MVPValidação de arquivo, storage adapter (R2 real), chunking, jobs e safe errors.
Knowledge BaseAtendido para MVPVectorStore interface, mock store e KB search como candidate evidence; KB não substitui SCF normativo.
SoAAtendidoDraft usa framework + SCF mappings, trata incerteza e exige approval humano antes de avançar.
Gap AnalysisAtendidoSó avança após SoA aprovada; preserva not_evidenced sem converter para falha automática.
MaturityAtendidopackages/maturity com modelo CMMI 0-5, classificação determinística, draft service, repos e factory.
POA&MAtendidoItens vinculam gap/control/requirement, expected evidence, acceptance criteria, priority e approval.
ReportingAtendido para JSON/MarkdownReport versions, artifact storage, traceability appendix e approved sources modelados; DOCX/PDF são placeholders.
Agent RuntimeAtendidoRegistry, tool allowlist, CloudflareAiGatewayAdapter real, schema validation e guardrails contra approval/mapping inventado.
WorkflowsAtendido para MVPWorkflow principal, signals, waits, retries/idempotency e failed/blocked/cancelled testados com mocks.
ObservabilityAtendidoLogger estruturado, redaction, audit/security events persistentes (PostgreSQL), metrics, usage/cost records e trace propagation.
Tests and evalsAtendidoUnit, contract, security, regression, evals e synthetic E2E disponíveis e no CI. 51 API tests passando.
CloudflareOperacionalWorkers (API Gateway) deployados em produção. R2 buckets provisionados. KV namespace STANDARD_CACHE ativo. CI com deploy automático.
ComandoResultado
pnpm install --frozen-lockfilePassou; lockfile atualizado (21 workspace projects).
pnpm lintPassou; nenhum secret óbvio encontrado em arquivos versionáveis.
pnpm typecheckPassou; 21 workspace projects typechecked.
pnpm testPassou; 51 API tests + package suites.
pnpm test:unitPassou; packages e workers executaram suites com sucesso.
pnpm test:contractsPassou; 8 contract tests.
pnpm test:securityPassou; security package e 51 API tests.
pnpm test:regressionPassou; 5 synthetic regression tests.
pnpm test:evaluationsPassou; 7 evals, schema_pass_rate 1, guardrail_pass_rate 1, zero hallucinated mappings/approval bypass/tenant violations.
pnpm test:synthetic-e2ePassou; 1 synthetic E2E.
pnpm test:integrationPassou; API Gateway e workflows com adapters/mocks.
pnpm buildPassou; build workspace sem erro.
pnpm test:ciPassou; lint, typecheck, unit, contracts, security, regression, evals, synthetic E2E e build.
  • Unit tests por package/worker.
  • Contract tests de API, schemas e erros.
  • Security tests de auth/RBAC/tenant/upload/prompt/tool policy.
  • Tenant isolation tests em API, KB, workflows, POA&M, reporting e packages.
  • Approval gate tests em Assessment Engine, SoA, Gap, POA&M, Reporting e Workflow.
  • Agent guardrail evals com MockLLMProvider.
  • Regression tests com golden dataset sintético.
  • Synthetic E2E do lifecycle sem provider real.
  • Integration tests mock de API Gateway e workflows.
  • Smoke tests reais em Cloudflare staging.
  • Testes de provisionamento real de R2, Queues, Vectorize e Workflows.
  • Testes com auth real JWT/API key/Cloudflare Access.
  • Testes de performance/load com dados sintéticos maiores.
  • Coverage formal por package.
  • CI configurado com lint, typecheck, unit, contract, security, regression, evals, synthetic E2E e build.
  • .env.example usa placeholders e não contém secrets reais.
  • Tenant isolation básico está testado.
  • Approval gates básicos estão testados.
  • State machine está testada.
  • Schemas críticos estão testados.
  • Agent guardrails estão testados.
  • SCF mappings oficiais são protegidos contra inferência.
  • KB search é tratado como candidate evidence.
  • Logs têm redaction.
  • Documentação mínima de release, segurança, staging e production readiness existe.
  • Deploy production é manual e usa environment protection production.
  • Malware scanning ainda é placeholder.
  • Workflow Cloudflare real (Queues Durável) ainda precisa provisionamento.
  • DOCX/PDF reporting ainda é placeholder.
  • Vectorize real ainda depende de provisionamento por tenant.

Nenhum bloqueador conhecido para staging controlado com dados sintéticos.

Bloqueadores antes de produção aberta (multi-tenant real):

  • smoke tests Cloudflare com dados sintéticos;
  • revisão legal/privacy;
  • WAF e Cloudflare Access para superfícies admin.
  • Uso de adapters in-memory/mock no caminho local e em tests padrão.
  • Sem Terraform/Pulumi aplicado no MVP.
  • Sem dashboards operacionais persistentes.

Recomendação: Go para staging controlado, limitado a dados sintéticos e operadores internos.

Condições:

  • pnpm test:ci verde no branch do release;
  • Cloudflare secrets configurados via GitHub Secrets;
  • CI deploy automático para produção via deploy-production.yml;
  • nenhum dado real de cliente em testes.