docs: migrar SPEC/PLAN para docs/SPECS e docs/PLANS e adicionar ficheiros de contexto do projecto

2026-10-28 16:01:30 +00:00
parent 61ae4697f9
commit f39c6212a3
22 changed files with 1065 additions and 6 deletions
@@ -0,0 +1,135 @@
+---
+type: Status
+tags: [dev, dashboard, estado, versao, bloqueios, conformidade, 2026-06-30, reorganizacao]
+layer: wiki
+---
+# STATUS.md — DashDescomplicar
+
+**Versão:** 2.7.3 | **Data:** 2026-06-30 | **Ciclo:** PDCA Operacional
+
+---
+
+## PDCA Operacional
+
+### 🟦 PLAN
+
+**Proprietário:** Claude Code (Desk #2323)  
+**Referência Autoritária:** `docs/PLANS/DashDescomplicar-PLAN.md`
+
+**Roadmap Q3-Q4 2026:**
+- Q3-S1 (Jul): Audit segurança + certificado de revisão
+- Q3-S2 (Ago): Painel Cron Dev (visibilidade de agentes cron)
+- Q3-S3 (Set): Reintrodução progressiva Paperclip
+- Q3-S4 (Out): Sincronização multi-máquina
+- Q4-S1 (Nov): Integração Wiki Descomplicar
+- Q4-S2 (Dez): Painel Inteligência Stack (melhorias)
+
+**Ciclos de Manutenção:**
+- **Semanal (Seg):** Health check + revisão de logs (docs/PLANS § Ciclos de Manutenção)
+- **Mensal (último Sex):** Audit dependências + STATUS.md update (docs/PLANS § Ciclos de Manutenção)
+- **Trimestral:** Revisão segurança (OWASP) + testes de carga (docs/PLANS § Ciclos de Manutenção)
+
+---
+
+### 🟩 DO
+
+**Execução:** Desenvolvimento + Deploy em EasyPanel
+
+**Localização Código:**
+- Repositório: `git.descomplicar.pt/ealmeida/DashDescomplicar` (Gitea)
+- Dev local: `/media/ealmeida/Dados/Dev/DashDescomplicar/`
+- Deploy: `easy.descomplicar.pt` (EasyPanel) — serviço `descomplicar_dashboard_descomplicar`
+- Banco de dados: CWP `176.9.3.158` — `desscomplicar` (MySQL)
+
+**Dependências Críticas:**
+- MCP Gateway (`gateway.descomplicar.pt`) — 39 MCPs
+- Desk CRM (MySQL interno) — tarefas, tickets, projecto (#2323)
+- n8n — workflows de automação
+- Moloni API — dados financeiros
+- SSH (CWP + EasyPanel) — coleta de métricas infraestrutura
+- IJFW (`~/.ijfw/memory/`) — sessões Claude Code
+
+**Processo de Deploy (docs/PLANS § Processo de Deploy):**
+1. Branch `main` com testes a passar: `npm test`
+2. Lint sem erros: `npm run lint`
+3. Build local validado: `npm run build`
+4. STATUS.md actualizado com versão nova
+5. SSH para EasyPanel + `git pull` + `docker build` + restart
+
+**Features Activas (v2.7.3):**
+- Dashboard (`/`) — página principal, hero stats
+- Monitor (`/monitor`) — monitorizacao infraestrutura
+- Financeiro (`/financial`) — Moloni + Desk métricas
+- MCPs (`/mcps`) — estado 39 MCPs
+- n8n (`/n8n`) — automações
+- Paperclip (`/paperclip`) — 🟡 Suspenso (manutenção)
+- IA/Claude (`/ai`) — overview Claude Code
+- Operações (`/operations`) — Desk CRM gestão
+- Sessions (`/sessions`) — replay Claude Code (obs.md prioritária: `/media/ealmeida/Dados/Hub/05-Projectos/Observabilidade/SPEC.md`)
+
+---
+
+### 🟨 CHECK
+
+**Observabilidade:** Telemetria, métricas, health checks
+
+**Referência OKF:**
+- 📊 **Métricas:** `okf/entidades/Metrics.md` (coleta de performance, disponibilidade, negócio)
+- 🔗 **Integração:** `okf/relacionamentos/CSRIntegration-integra-Metrics.md`
+
+**Métricas de Saúde (docs/PLANS § Métricas de Saúde):**
+- **Uptime:** > 99.5% (target SLA)
+- **Response time:** < 500ms (p95)
+- **Error rate:** < 0.5% (5xx errors)
+- **DB connections:** < 80% do pool máximo
+- **Disk space:** > 10% livre em EasyPanel
+- **Session sync:** < 5min de lag
+
+**Health Endpoints:**
+- `GET https://dash.descomplicar.pt/api/dashboard` (< 500ms)
+- `GET /api/metrics` (Prometheus format)
+- Logs: `docker logs descomplicar_dashboard_descomplicar` (EasyPanel)
+
+**Ferramenta de Observabilidade:**
+- Painéis de Monitor consumem Desk CRM, Moloni, SSH, MCP Gateway (okf/relacionamentos/)
+- Observabilidade sistema integrado (relação bidirecional via okf/index.md)
+
+---
+
+### 🟧 ACT
+
+**Melhoria Contínua:** SelfImprovement (Sistema #2066)
+
+**Processo:**
+1. **Recolher feedback:** Desk #65 comentários, CodeRED incidents, logs de erro
+2. **Análise:** Identificar padrões, causa raiz de falhas
+3. **Decisão:** Priorizar melhorias (RICE: Reach × Impact ÷ Confidence ÷ Effort)
+4. **Implementar:** Nova feature/bugfix → PR → review → merge → deploy
+5. **Registar:** Atualizar CHANGELOG.md + PLAN.md roadmap + STATUS.md
+
+**Integração SelfImprovement:**
+- SPEC autoritária: `/media/ealmeida/Dados/Hub/05-Projectos/SelfImprovement/SPEC.md`
+- PLAN autoritário: `/media/ealmeida/Dados/Hub/05-Projectos/SelfImprovement/PLAN.md`
+- Desk task: #2066
+
+**Escalação de Incidentes:**
+- **P0 (site down):** CodeRED imediatamente → `curl -X POST https://codered.descomplicar.pt/v1/trigger/RED-ZMT3FCU8`
+- **P1 (erro crítico):** Desk #65 comentário + IRC com Claude Code
+- **P2 (bugfix/enhancement):** Desk #65 comentário + roadmap Q3-Q4
+
+---
+
+## Estado actual
+
+- **Em curso:** Fase C — 5W2H+PDCA completo (AGENTS.md When/How + STATUS.md PDCA + okf/ cruzamentos)
+- **Bloqueios:** Nenhum
+- **Próximos passos:**
+  1. ✅ AGENTS.md: When/How preenchidos com PLAN/PROC/QR refs
+  2. ✅ STATUS.md: PDCA ligado a docs/PLANS, okf/, observabilidade
+  3. 🔄 okf/relacionamentos/: completar com arestas de métricas
+  4. 🔄 Validar coerência grafo (sem órfãos)
+
+---
+
+**Última actualização:** 2026-06-30 (Fase C — PDCA operacional)
+**Próxima revisão de plano:** 2026-09-30 (fim Q3, segundo docs/PLANS/DashDescomplicar-PLAN.md)