ligbox-ops-platform/specs/009-ops-audit-overview/research.md
Ligbox Spec Hub 3a2c64834b Initial import: ligbox-ops-platform + specs + LAPTOP + obsidian merge (CT130)
Source: VM122 /opt + obsidian-infra + LAPTOP
Hub: CT130 spec-hub 10.10.10.130
2026-06-19 17:26:41 +00:00

68 lines
2.1 KiB
Markdown

# Research: 009-ops-audit-overview
**Date**: 2026-06-08
## Decisões
### R1 — Fonte checks infra (carbonio, nginx, cert)
**Decisão**: Reutilizar API portal VM112 existente:
- `GET /onboarding/infrastructure/status/{domain}`
- Campos: `carbonio_hostname`, `carbonio_nginx_vhost`, cert info se exposto
**Alternativa rejeitada**: SSH zmprov directo — viola separação, requer credenciais extra.
### R2 — DNS checks
**Decisão**: `dnspython` resolver público ou httpx para DNS-over-HTTPS Cloudflare `1.1.1.1/dns-query`.
**Rationale**: Ops não depende de resolver interno; alinha com visão cliente externa.
### R3 — Domínios monitorizados
**Decisão**: Auto-register de `webhook_events.payload.domain` onde `event_type IN ('account.created','onboarding.completed')`.
**MVP**: Manual seed `diarissima.com` ou domínio activo VM112 para demo.
### R4 — Worker vs scheduler
**Decisão**: Extender worker container existente (Redis) com job `audit_cycle` — sem novo serviço.
### R5 — UI placement
**Decisão**: Nova view `overview` no nav Desk, **antes** Dashboard ou substituir conteúdo Dashboard principal (merge funil 004 + overview 009 num dashboard rico).
**Recomendação UX**: Dashboard único com secções:
1. Funil onboarding (004)
2. Tenant health grid (009)
3. Tickets recentes + infra (existente)
## VM112 API endpoints confirmados
```
GET /onboarding/infrastructure/status/{domain}
GET /onboarding/dns/verify/{domain}
GET /health (já usado vm112/status no Ops)
```
## Score thresholds
| Check | pass | warn | fail |
|-------|------|------|------|
| cert_le | > 30 days | 14-30 days | < 14 or invalid |
| dns_* | record matches expected | partial | missing/wrong |
| webmail_http | 200-399 | 403 | timeout/5xx |
## Backlog mapping
| Backlog | Feature 009 |
|---------|-------------|
| AUD-1 Collectors | Phase B collectors |
| AUD-2 UI overview | Phase E UI |
| AUD-3 Scorecard 8 checks | FR-005 + scorecard API |
## Referências
- BACKLOG.md Track A
- VISAO_PLATAFORMA_LIGBOX_OPS.md § Track A MVP
- CHAT BRUTO VM122 dashboard expectativa vs MVP