Visão Geral da Plataforma
Platform — Overview (índice)
Escopo único: índice do domínio técnico. Público: time técnico / dev. Futuro lar do código da fábrica. Linguagem canônica: canon/CONTEXT.md · Decisões: canon/adr/ · Regras cross-domain: canon/cross-domain-rules.md · Strings/IDs de implementação: canon/impl-reference.md
A plataforma técnica da Hendrios Software Factory — a esteira que transforma issues de Clients em código entregue e operado na VPS deles: triagem → agentes → gates → merge → deploy, com billing por consumo medido em cada run.
Docs deste domínio
| Doc | Escopo |
|---|---|
| 01-architecture.md | VPS, Brain+Runner single-writer, scaling multi-host, matemática de recursos |
| 02-pipeline.md | Trigger (webhook+poll), triagem, máquina de estados (labels EN), Human Planning |
| 03-execution.md | Sandbox/imagem/egress, Orchestrator, eventos de uso, enforcement de Spend Caps |
| 04-secrets-security.md | Segredos, threat model B2B, Vaultwarden (cofre compartilhado) |
| 05-quality-gates.md | Ladder de gates determinístico-primeiro, confidence, auto-merge em camadas |
| 06-operations.md | Operação 24/7, gc/guard, runbook, observabilidade, DR cliente-zero, comportamento Dunning |
| 07-billing-metering.md | Metering técnico (OTLP→OpenMeter/Laminar, Kimai), atributos de billing; estimativa = FUTURO |
| 08-deploy-client-vps.md | House Stack, provisionamento OpenTofu, SLA, backup, Rescue checklist, homologação por tier |
| 09-concierge.md | Concierge (Hermes+MiniMax): atendimento WhatsApp/Telegram, 13 ACs |
| 10-onboarding-automation.md | ChiefOnboarding: sequences, webhooks→provisionamento, n8n |
| 11-rollout.md | Fases 0-4 com critérios mensuráveis + premissas/questões (Q2-Q9 do plano original) |
Premissas & questões abertas
Consolidadas em 11-rollout.md: Q2-Q6 respondidas (piloto=tracer · chaves GLM Lite+MiniMax Plus · GitHub App conta pessoal · notificação webhook→Mattermost+Telegram · Node-first); Q7-Q9 decididas em 2026-06-08 (X=0,90 + calibração ≥20 PRs · Hetzner padrão + Vultr-SP p/ BR · pr-agent self-host).
Fronteira com /business
O “o quê” comercial do onboarding vive em business/07-onboarding-playbook.md; aqui fica o “como” técnico (10). Regras de billing são donas do /business (Spend Caps, Rate Card) — a plataforma implementa e linka.