# Ligbox Ops Platform

Plataforma de operações Ligbox — Spec-Driven Development com [GitHub Spec Kit](https://github.github.io/spec-kit/).

**VM:** 122 (`ligbox-ops`) · `10.10.10.122` · SSH WAN `95.216.14.146:2522`


## Estrutura do monorepo

| Projecto | VM | Pasta |
|----------|-----|-------|
| Wizard | VM112 | `projects/wizard/` |
| Ops Desk | VM122 | `projects/ops-desk/` |
| Finance | VM123 | `projects/finance/` |
| Integrations | VM104 | `projects/integrations/` |

**Specs** ficam em `specs/` (raiz) — muitas cruzam VMs. Ver `projects/README.md` e `deploy/manifest.yaml`.

---

## Início rápido Spec Kit

Abrir este directório no Cursor Agent e usar os skills:

| Comando | Fase |
|---------|------|
| `/speckit-constitution` | Princípios (já definidos) |
| `/speckit-specify` | Requisitos da feature |
| `/speckit-clarify` | Resolver ambiguidades |
| `/speckit-checklist` | Validar spec |
| `/speckit-plan` | Plano técnico |
| `/speckit-tasks` | Tarefas executáveis |
| `/speckit-analyze` | Consistência |
| `/speckit-implement` | Implementar |

**Ordem recomendada (produção):** constitution → specify → clarify → checklist → plan → tasks → analyze → implement

---

## Documentação

| Ficheiro | Conteúdo |
|----------|----------|
| `.specify/memory/constitution.md` | Constitution geral infra Ligbox |
| `docs/network/INTERFACES_PROXMOX.md` | Bridges, vmbr1, iptables, tabela VMs |
| `chat-bruto/INDICE_MODELAGEM_BRUTA.txt` | Índice sessões Cursor (modelagem bruta) |

### CHAT BRUTO (referência futura)

| Ficheiro | Transcript | Conteúdo |
|----------|------------|----------|
| `CHAT_BRUTO_LIGBOX_OPS_PLATFORM_VM122_SPEC_20260608.*` | `dd17614b-6e05-46cd-9bec-5e963f721c72` | VM122, Spec Kit, features 001/002, UI Desk, Traefik, fila specs, visão dashboard |
| `CHAT_BRUTO_LIGBOX_OPS_PLATFORM_20260604.*` | `e41f7d28-c63a-4d6d-a32c-65bfe4d3684f` | Visão inicial plataforma, agentes, SOC, backlog |

Canais: `workspace/` · `obsidian-infra/ligbox-ops-platform/` (VM112) · `LAPTOP/` (scp Windows)

---

## Estado MVP (VM122)

Deploy em `/opt/ligbox-ops-platform/` (conteúdo = `projects/ops-desk/` no Git):

- API `:8080` · Frontend `:8091` · Redis + Worker internos
- fail2ban activo · webhook secret dev (rotacionar em produção)

Próxima feature (após constitution): `004-onboard-funnel-events` → `009-ops-audit-overview`

## Specs (fila activa)

| # | Feature | Estado | Descrição |
|---|---------|--------|-----------|
| 001 | webhook-vm112-integration | ✅ MVP | account.created → ticket |
| 002 | wazuh-integration | ✅ | Wazuh ingress + UI |
| **004** | **onboard-funnel-events** | 📋 **Spec pronta** | Funil completo + timeline + widget |
| **009** | **ops-audit-overview** | 📋 **Spec pronta** | Overview Cloudflare-like + 8 checks |
| **019** | **ops-console-active-operations** | 📋 **Spec pronta** | Console UI Wazuh-like **VM123 Docker**; chamado único |
| 003 | desk-auth-rbac | backlog | Auth API pública |