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,169 @@
 ---
 type: Document
 title: Agents
 description: Governance de agentes IA para este projecto
 tags: [dev, dashboard, governance, 5w2h, roles, relacionamentos, modelo, 2026-06-30, reorganizacao]
 ---
 # AGENTS.md — Governance de Agentes IA
 ## Identidade do Projecto
 - **Repositório**: DashDescomplicar
 - **Localização**: `/media/ealmeida/Dados/Dev/DashDescomplicar/`
 - **CRM**: Desk #2323 | Projecto: #65 (OKF Stack Completo)
 - **Modelo Base**: Hub → `05-Projectos/Modelo-Organizacao-Proc-Dev/`
 - **Versão Actual**: 2.7.3 (2026-06-30)
 ## Directrizes de Operação
 ### 1. PT-PT e Precisão
 Toda a interacção, comentários, commits e documentação devem ser em português europeu, com acentos e cedilhas.
 ### 2. MCP-first
 - **Desk CRM**: Consultar/actualizar via MCP desk-crm-v3
 - **Gitea**: Commits e gestão de versões via MCP gitea
 - **SSH**: Apenas se necessário para validação remota (EasyPanel, CWP)
 - **Memória IJFW**: Guardar contexto persistente via ijfw-memory
 ### 3. Ciclo de Trabalho Obrigatório
 1. **Validar contexto** — ler AGENTS.md + STATUS.md + desk.project
 2. **Executar** — seguir docs/PLANS/DashDescomplicar-PLAN.md (roadmap + ciclos)
 3. **Validar** — registar mudanças em STATUS.md
 4. **Registar** — actualizar CRM (#2323) se há progresso significativo
 ### 4. Validação Obrigatória
 Nunca dar uma tarefa como concluída sem validar o estado actual via curl/MCP/SSH.
 ---
 ## Agentes Descomplicar Autorizados
 ### Claude Code (cc)
 **Identidade**: `staff_id = 25` (CLAUDE em Desk CRM)
 | Campo | Valor |
 |-------|-------|
 | **What** | Desenvolvimento, DevOps, features no DashDescomplicar |
 | **Why** | Fonte central de código, deploy, PDCA operacional |
 | **Where** | Dev/DashDescomplicar + EasyPanel (easy.descomplicar.pt) |
 | **Who** | Equipa de desenvolvimento (Emanuel + Claude Code) |
 | **When** | [Ver WHEN/HOW abaixo] |
 | **How** | [Ver WHEN/HOW abaixo] |
 #### When
 - **Semanal (Seg):** Health check: `curl -sf https://dash.descomplicar.pt/api/dashboard` + revisão de logs
 - **Mensal (último Sex):** Audit dependências (`npm audit`) + atualizar STATUS.md
 - **Trimestral:** Revisão segurança (OWASP) + testes de carga
 - **Contínuo:** PRs/features → docs/PLANS/DashDescomplicar-PLAN.md (roadmap)
 - **Incidente:** CodeRED para site down (`curl -X POST https://codered.descomplicar.pt/v1/trigger/RED-ZMT3FCU8`)
 #### How
 **Referência operacional primária:**
 - 📋 **PLAN:** `docs/PLANS/DashDescomplicar-PLAN.md` (roadmap Q3-Q4, ciclos de manutenção, deploy)
 - 📋 **SPEC:** `docs/SPECS/DashDescomplicar-SPEC.md` (especificação, projectos ativos)
 **Procedimentos Descomplicar:** 
 - `PROC-Deploy-EasyPanel.md` (D7-Tecnologia) — deploy via SSH + Docker
 - `PROC-Observabilidade-Dashboard.md` — coleta de métricas
 - `QR-Desk-Subtarefas-Dependencias.md` — gestão de dependências no CRM
 **Validação:**
 - Build local: `npm run build && npm run lint && npm test`
 - Health endpoint: `GET /api/dashboard` (< 500ms p95)
 - Logs: `docker logs descomplicar_dashboard_descomplicar` (EasyPanel)
 **Escalação:**
 - Bug/Feature: Comentário em Desk #65
 - Incidente P0 (site down): CodeRED imediatamente
 - Questão técnica: IRC com Claude Code peers
 ---
 ### Observabilidade (Sistema)
 **Integração**: Sistemas de telemetria que alimentam DashDescomplicar
 | Campo | Valor |
 |-------|-------|
 | **What** | Coleta e agregação de métricas operacionais |
 | **Why** | Observabilidade de infraestrutura e aplicação |
 | **Where** | `okf/entidades/Metrics.md` + logs/performance-metrics.json |
 | **Who** | Observabilidade (Sistema #2059) |
 | **When** | Contínuo (eventos em tempo real) |
 | **How** | [Ver WHEN/HOW abaixo] |
 #### When
 - **Contínuo:** Coleta via Express middleware (Painéis + API)
 - **Agregação horária:** Roll-up em Prometheus (opcional)
 - **Retenção:** Logs de performance em JSON (7 dias rotated)
 #### How
 **Referência operacional:**
 - 📋 **SPEC Autoritária:** `/media/ealmeida/Dados/Hub/05-Projectos/Observabilidade/SPEC.md`
 - 📋 **PLAN Autoritário:** `/media/ealmeida/Dados/Hub/05-Projectos/Observabilidade/PLAN.md`
 - 📊 **Métricas OKF:** `okf/entidades/Metrics.md`
 **Integração com DashDescomplicar:**
 - Endpoint: `GET /api/metrics` (Prometheus format)
 - Painéis consomem via CSR-Integration (cache + reconnect)
 - Tabela relação: `okf/relacionamentos/CSRIntegration-integra-Metrics.md`
 ---
 ## O Que Este Projecto Contém
 - `docs/PLANS/DashDescomplicar-PLAN.md` — **PLANO OPERACIONAL PRINCIPAL** (roadmap Q3-Q4, ciclos, deploy)
 - `docs/SPECS/DashDescomplicar-SPEC.md` — especificações e projectos activos
 - `okf/` — **GRAFO DE CONHECIMENTO** (12 entidades + 7 relacionamentos bidireccionais)
  - `okf/entidades/` — Dashboard-Engine, 8+ Painéis, CSR-Integration, Metrics
  - `okf/relacionamentos/` — exibe, integra-com, usa (com cruzamentos de métricas)
 - `AGENTS.md` — (este ficheiro) governance de agentes e integração
 - `STATUS.md` — **PDCA OPERACIONAL** (Plan-Do-Check-Act ligado a recursos)
 - `MEMORY.md` — histórico de sessões (deprecated, usar IJFW em ~/.ijfw/memory/)
 - `desk.project` — ancoragem CRM: task #2323, projecto #65
 - `CHANGELOG.md` — histórico de versões
 ---
 ## Validação de Integridade
 ✅ **When/How completo** — Cada agent tem schedule e referências a PLAN/PROC/QR  
 ✅ **Bidirecionalidade** — Relacionamentos em okf/ documentados nos dois sentidos  
 ✅ **Sem órfãos** — Toda entidade ligada a pelo menos 1 entrada + 1 saída  
 ✅ **PDCA linkado** — STATUS.md refere docs/PLANS/ e observabilidade  
 ---
 ## Referência ao Modelo
 Consulte `/media/ealmeida/Dados/Hub/05-Projectos/Modelo-Organizacao-Proc-Dev/ESTRUTURA.md` para a hierarquia padrão obrigatória em todos os projectos Descomplicar.
 **Última actualização:** 2026-06-30 (Fase C — 5W2H+PDCA completo)
 ## Relacionamentos Direccionais
 ### Depende De
 - [[06-Operacoes]] - Hub operacional central com procedimentos
 - [[04-Stack]] - Decisões técnicas e stack Descomplicar
 ### Suporta
 - [[05-Projectos/Modelo-Organizacao-Proc-Dev/ESTRUTURA.md]] - Modelo de projectos
 ### Documenta
 - [[06-Operacoes/Procedimentos/]] - Procedimentos operacionais
 ### Implementação
 - [[DashDescomplicar/src/]] - Código-fonte do Dashboard
 - [[DashDescomplicar/okf/]] - Grafo de conhecimento de painéis
 ### Relacionado Com
 - [[04-Stack]] - Stack técnico partilhado
 - [[CodeRED]] - Sistema de alertas críticos
 ### Procedimento
 - [[06-Operacoes/Procedimentos/D7-Tecnologia/Infraestrutura/PROC-EasyPanel-Deployment.md]] - Deploy em EasyPanel
 - [[06-Operacoes/Procedimentos/D7-Tecnologia/Sistema/PROC-Desk-Subtarefas-Dependencias.md]] - Modelo de subtarefas
 ### Herança
 - [[05-Projectos/Modelo-Organizacao-Proc-Dev/ESTRUTURA.md]] - Estrutura canónica
@@ -1,3 +1,11 @@
 ---
 type: Document
 title: Audit Report
 description: >-
  Relatório de auditoria de segurança e qualidade do DashDescomplicar (React 19 + TypeScript + Vite + Express + MySQL), com 20 vulnerabilidades classificadas e veredicto de não apto para produção.
 timestamp: 2026-02-14T03:33:42.730555+00:00
 layer: wiki
 ---
 # Auditoria de Segurança e Qualidade - DashDescomplicar
 **Data:** 14-02-2026  
@@ -1,7 +1,21 @@
 ---
 type: Changelog
 title: Changelog
 description: >-
  Todas as alterações notáveis neste projecto serão documentadas neste ficheiro
 timestamp: 2026-06-15T18:43:39.495926+00:00
 layer: wiki
 ---
 # Changelog
 Todas as alterações notáveis neste projecto serão documentadas neste ficheiro.
 ## [Unreleased] - 2026-10-24
 ### Fixed — Detector de padrões de sessões (Desk #14404)
 - **`patterns.ts` / `detectDurationOutliers`**: outcome `unknown` deixa de contar como "não concluída" — as sessões cron do Hermes (`project_slug` NULL) têm 100% `unknown` (outcome não medido) e geravam por construção ~5% de outliers todas as semanas ("Projecto null: N sessões longas não concluídas", 11 semanas seguidas). Só `error`/`interrupted` contam.
 - **`sessions-patterns.ts`**: tickets de padrão recorrente passam a ir para o departamento Tecnologia (id=7); o id=1 é "Comercial", não "Geral".
 ## [2.7.3] - 2026-06-15
 ### Added — Indexação Multi-Fonte (Hermes + OpenCode)
@@ -0,0 +1,181 @@
 ---
 layer: wiki
 type: Document
 title: "CLAUDE — DashDescomplicar"
 description: >-
  Instruções operacionais para Claude Code no projecto DashDescomplicar. Stack React 19 + Express + EasyPanel Swarm.
 tags: [claude, operacional, dashboard, deploy, react, express]
 timestamp: 2026-06-29T23:00:00+01:00
 ---
 # CLAUDE — DashDescomplicar
 Instruções operacionais para agentes
 ## OKF — Organizational Knowledge Framework (OBRIGATÓRIO)
 Este projecto tem um mapeamento OKF interno em `okf/`. **Antes de qualquer acção, consultar o OKF.**
 | Regra | Detalhe |
 |-------|---------|
 | **Consultar antes de agir** | Ler `okf/index.md` ao iniciar sessão. Ver entidades relevantes ao contexto. |
 | **Manter actualizado** | Se criares, alterares ou removeres um componente, actualizar a ficha OKF correspondente. |
 | **Novo componente = nova ficha** | Qualquer novo serviço, módulo, integração ou script → criar `5W2H-PDCA.md` em `okf/entidades/`. |
 | **Validar antes de commit** | `okf-validate.sh --project .` — 0 erros para commit. |
 | **Relacionamentos bidirecionais** | Se A depende de B, tanto A como B devem registar a relação. |
 **Estrutura:** `okf/index.md` → índice geral. `okf/entidades/` → uma pasta por componente com `5W2H-PDCA.md`.
 IA a trabalhar neste projecto.
 ## Contexto
 - **Projecto:** DashDescomplicar — dashboard interno `dash.descomplicar.pt`
 - **Desk:** Projecto #65
 - **Versão actual:** 2.7.3 (ver `CHANGELOG.md`)
 - **Dev local:** `/media/ealmeida/Dados/Dev/DashDescomplicar`
 - **Hub:** `/media/ealmeida/Dados/Hub/04-Stack/02.05-Aplicações/DashDescomplicar/`
 ## Stack
 | Camada | Tecnologias |
 |--------|-------------|
 | Frontend | React 19, TypeScript 5.6, Vite 7, Tailwind CSS, Framer Motion, Lucide React |
 | Backend | Express 4, MySQL2, SSH2, Zod, Node.js 18+ |
 | Observabilidade | better-sqlite3, chokidar, node-html-parser |
 | DevOps | Docker, Gitea (HTTPS), EasyPanel Swarm |
 ## Desenvolvimento Local
 ```bash
 # Modo desenvolvimento completo
 npm run dev
 # Apenas frontend (porta 5173)
 npm run dev:client
 # Apenas backend (porta 3001)
 npm run dev:server
 ```
 - Frontend: `http://localhost:5173`
 - API: `http://localhost:3001/api`
 - Health: `http://localhost:3001/api/health`
 - Proxy Vite: `/api` → `localhost:3001`
 ## Build e Validação
 ```bash
 # Build completo (validação antes de commit)
 npx tsc -b && npx vite build && npx tsc -p api/tsconfig.json
 # Build rápido
 npm run build
 ```
 ## Pipeline de Deploy
 1. **Validar build localmente** (obrigatório)
 2. **Push para Gitea:**
   ```bash
   git push origin main
   # Se necessário: git pull --rebase origin main
   ```
 3. **Rebuild e redeploy no servidor** (SSH `easy`):
   ```bash
   cd /etc/easypanel/projects/descomplicar/dashboard_descomplicar/code
   docker build -t easypanel/descomplicar/dashboard_descomplicar:latest .
   docker service update --force descomplicar_dashboard_descomplicar
   ```
 4. **Verificar:**
   ```bash
   curl -sf https://dash.descomplicar.pt/api/dashboard
   curl -sf https://dash.descomplicar.pt/api/health
   ```
 > **IMPORTANTE:** EasyPanel MCP (`redeploy_service`) está quebrado. Usar **sempre** SSH directo para redeploy.
 ## Variáveis de Ambiente
 Prefixo correcto: `DB_*` (NÃO `MYSQL_*`)
 ```env
 DB_HOST=176.9.3.158
 DB_USER=ealmeida_desk24
 DB_PASS=...
 DB_NAME=ealmeida_desk24
 WP_MONITOR_API_KEY=...
 HETZNER_TOKEN=...
 NODE_ENV=production
 FRONTEND_URL=https://dash.descomplicar.pt
 API_PORT=3001
 ```
 ## Segurança
 - Pre-commit hook (`Regra #47`): corre `npm audit --audit-level=moderate`
  - Pode falhar sem rede — tratar como erro de rede, não vulnerabilidade
  - `npm audit fix --force` pode fazer breaking changes — verificar build depois
 - Credenciais: **nunca** hardcodar; validação obrigatória em `api/db.ts`
 - `.env` está no `.gitignore` — nunca commitar
 ## Arquitectura de Ficheiros Relevantes
 ```
 src/
  App.tsx          — router principal (8 painéis)
  pages/           — Monitor, Financial, McpMonitor, N8nMonitor, Paperclip, AiOverview, Operations, Sessions
  components/
    Layout.tsx     — sidebar com navegação
 api/
  server.ts        — Express com rate-limit, CORS, Zod
  db.ts            — MySQL2 connection pool
  routes/          — wp-monitor, monitor, hetzner, sessions, ...
  services/        — monitoring, server-metrics, calendar, dashboard, ...
  scripts/         — sessions-indexer, sessions-patterns, check-sites, ...
 ```
 ## Padrões de Código
 - Validação Zod em todas as rotas API
 - `.passthrough()` em objectos aninhados (plugins WP podem enviar campos extra)
 - `z.string()` em vez de `z.enum()` para health status (plugins enviam qualquer string)
 - `z.any().optional()` para arrays complexos aninhados
 - Error handling: sem stack traces em produção; error IDs UUID para tracking
 - Rate limiting: 100 req/15min produção, 1000/15min dev
 ## Observabilidade (Sessões Claude Code)
 - SQLite local: `~/.claude-work/sessions.db` (sincronizado para EasyPanel via rsync)
 - Volume bind: `/root/data/dashboard-descomplicar/sessions.db → /data/sessions.db`
 - Env var servidor: `OBSERVABILIDADE_DB=/data/sessions.db`
 - Timer sync: `obs-index-sync.timer` (cada 15min)
 - Fontes: Claude Code JSONL, Hermes (`~/.hermes/state.db`), OpenCode (`~/.local/share/opencode/opencode.db`)
 ## Gitea
 - Owner: `ealmeida` (NÃO `descomplicar`)
 - Repo: `DashDescomplicar`
 - HTTPS funciona directamente via `git push origin main`
 - Gitea MCP não é necessário para push
 ## OKF — Grafo de Conhecimento
 - **Índice:** `okf/index.md` — 25 entidades + 17 relacionamentos (Deep OKF)
 - **Entidades:** `okf/entidades/` — um ficheiro por componente (painéis, API, integrações, infra)
 - **Relacionamentos:** `okf/relacionamentos/` — arestas com taxonomia (roteia, alimenta, serve, exibe)
 - **Navegação:** Usar `[[Nome-Entidade]]` para saltar entre entidades
 ## WP-CLI em CWP
 - Contas CWP têm shells `nologin` — usar sempre `--allow-root`
 - Com `--skip-plugins --skip-themes`, fazer `require_once` manual do plugin antes de `do_action`
 ## Referências
 - `SYS-DashDescomplicar.md` — descrição geral do sistema e painéis
 - `okf/index.md` — grafo de conhecimento completo (Deep OKF)
 - `MEMORY.md` — memórias operacionais acumuladas
 - `CHANGELOG.md` — histórico de versões
 - `docs/SPECS/SPEC-dashboard-expansion-q2-2026.md` — spec expansão Q2 2026
 - `docs/PLANS/PLAN-conductor-dashboard-expansion.md` — plano de expansão
 - `AUDIT-REPORT.md` — auditoria de segurança
@@ -0,0 +1,15 @@
 ---
 type: Document
 title: Memory
 description: Histórico de sessões
 tags: [dev, dashboard, historico, sessoes, decisoes, proximos-passos, 2026-06-30, reorganizacao]
 layer: wiki
 ---
 # MEMORY.md — DashDescomplicar
 ## HOJE (sessão inaugural)
 - Estrutura criada conforme Modelo-Organizacao-Proc-Dev
 - Pastas docs/PLANS/ e docs/SPECS/ criadas
 - Documentação AGENTS.md, MEMORY.md, desk.project, CHANGELOG.md, STATUS.md iniciada
 ---
@@ -1,3 +1,11 @@
 ---
 type: Reference
 title: Readme
 description: >-
  > Dashboard de Gestão e Monitorização da Descomplicar®
 timestamp: 2026-02-14T04:22:01.943892+00:00
 layer: wiki
 ---
 # DashDescomplicar
 > **Dashboard de Gestão e Monitorização** da Descomplicar®
@@ -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)
@@ -0,0 +1,132 @@
 ---
 layer: wiki
 title: DashDescomplicar — Dashboard de Gestão e Monitorização
 description: >-
  Dashboard interno da Descomplicar® para monitorização e gestão operacional em tempo real. Centraliza dados de CRM Desk, …
 date: 2026-04-08
 timestamp: 2026-04-08T00:00:00+01:00
 type: sistema
 status: activo
 tags: [dashboard, monitorizacao, react, sistema]
 repo: /media/ealmeida/Dados/Dev/DashDescomplicar
 ---
 # SYS-DashDescomplicar
 Dashboard interno da Descomplicar® para monitorização e gestão operacional em tempo real. Centraliza dados de CRM Desk, Hetzner, servidores SSH, WordPress, MCPs, n8n, Paperclip e métricas financeiras num interface unificado.
 - **Repo local:** `/media/ealmeida/Dados/Dev/DashDescomplicar`
 - **Stack:** React 19 + TypeScript 5.6 + Vite 7 + Tailwind + Framer Motion (frontend) · Express 4 + MySQL2 + SSH2 + Zod (backend) · Docker + Gitea + EasyPanel (DevOps)
 - **Layout:** sidebar com 8 painéis (ver `src/components/Layout.tsx`)
 ---
 ## Painéis
 ### 1. Dashboard (`/`)
 Página principal. Hero stats agregados (tarefas, calendário, servidores), gráficos de tendências e status real-time como entrada rápida para os restantes painéis.
 ### 2. Monitor (`/monitor`) — `pages/Monitor.tsx`
 Monitorização de infraestrutura e WordPress.
 - Load dos servidores, storage (NVMe, RAID1)
 - Containers Docker e serviços
 - Sites WordPress e WordPress Updates
 - Backups, alertas e janelas de manutenção
 ### 3. Financeiro (`/financial`) — `pages/Financial.tsx`
 Métricas de negócio via Moloni/Desk.
 - Receita e Despesa (mês e ano)
 - Vendas Mês / Vendas Ano, Despesas Mês / Despesas Ano
 - Gráficos de evolução (pie/line charts)
 ### 4. MCPs (`/mcps`) — `pages/McpMonitor.tsx`
 Estado dos 39 MCPs do gateway e locais.
 - Contadores Online / Offline / Disabled / Total
 - Botão "Actualizar" para refresh manual
 ### 5. Automações n8n (`/n8n`) — `pages/N8nMonitor.tsx`
 Workflows determinísticos.
 - Total de Workflows, Activos, Falhas (24h)
 - Histórico de execuções recentes
 ### 6. Paperclip (`/paperclip`) — `pages/Paperclip.tsx`
 Orquestrador autónomo (64 agentes).
 - Agentes activos / idle / com erro
 - Routines activas
 - Nota: Paperclip em reintrodução progressiva (suspenso 08-04-2026)
 ### 7. IA / Claude (`/ai`) — `pages/AiOverview.tsx`
 Overview do ecossistema Claude Code.
 - Skills, agents, plugins, MCPs, hooks
 - Ligação ao inventário do 04-Stack
 ### 8. Operações (`/operations`) — `pages/Operations.tsx`
 Gestão operacional via Desk CRM.
 - Tickets Abertos (Open, In Progress, Answered)
 - Alta Prioridade
 - Tempo Médio de Resposta (média últimos 90 dias)
 ---
 ## Painéis a adicionar
 ### 9. Cron Dev (proposto) — `pages/CronDev.tsx`
 Painel para todas as acções cron do servidor `dev` (CT 102, `/root/Dev/claude_automations_dev/`). Actualmente os 9 agentes cron (imap-triage, ticket-triage, auto-expense, aiktop, infra-check, wp-update, etc.) correm sem visibilidade agregada — o `/today` lê logs via SSH mas não há UI.
 Requisitos:
 - Lista de todos os jobs cron activos com schedule, último run, próximo run, duração e exit code
 - Estado: OK / Warning / Erro / Stale (sem correr há >24h)
 - Logs recentes (tail) por job, com filtro e pesquisa
 - Alertas visuais para falhas consecutivas (>2)
 - Acção manual "Run now" (opcional, autenticada)
 - Métricas agregadas: total jobs, sucessos 24h, falhas 24h, tempo médio
 Fonte: SSH ao `dev` + leitura de `/var/log/` e logs dos agentes + `crontab -l`.
 ### 10. Inteligência — Melhorias Propostas (proposto) — `pages/Intelligence.tsx`
 Painel para gerir o backlog de melhorias ao stack identificadas no projecto **Inteligência** (`04-Stack/02.04-Sistemas/Inteligencia/melhorias/`), incluindo `Melhorias-Stack-321-Videos.md` e futuras análises de canais/vídeos/notícias.
 Requisitos:
 - Lista de melhorias propostas com título, fonte (vídeo/canal/notícia), data, categoria (skill, agent, MCP, hook, plugin, workflow, infra)
 - Estados: proposto / em análise / aprovado / em implementação / concluído / rejeitado
 - Prioridade (alta/média/baixa) e esforço estimado
 - Link para fonte original (URL vídeo, notícia) e ficheiro Hub
 - Filtros por categoria, estado, prioridade e fonte
 - Métricas: total propostas, taxa de adopção, melhorias implementadas por mês
 - Acção "Criar tarefa Desk" para promover melhoria a execução (projecto #65)
 Fonte: leitura dos `.md` em `Hub/04-Stack/02.04-Sistemas/Inteligencia/melhorias/` com parse de frontmatter + integração Desk CRM.
 ---
 ## Arquitectura
 ```
 Frontend (React 19 + Vite)  ->  API Express  ->  Fontes:
                                                 - Desk CRM (MySQL)
                                                 - Hetzner Cloud API
                                                 - SSH2 (servidores)
                                                 - Moloni (MCP/API)
                                                 - MCP Gateway
                                                 - n8n API
                                                 - Paperclip API
 ```
 Segurança: `express-rate-limit`, CORS, validação Zod, OIDC opcional.
 ---
 ## Relação com o Stack
 | Sistema | Relação |
 |---|---|
 | Desk CRM | Fonte de tarefas, tickets, projectos, tempo |
 | MCP Gateway | Estado dos 39 MCPs |
 | n8n | 8 workflows determinísticos monitorizados |
 | Paperclip | 64 agentes — suspenso, painel mantido para reintrodução |
 | Moloni | Dados financeiros |
 | Hetzner / CWP / EasyPanel | Infraestrutura monitorizada |
 ---
 **Referências:** `Dev/DashDescomplicar/README.md` · `src/components/Layout.tsx` · `src/pages/*.tsx`
@@ -0,0 +1,8 @@
 {
  "task_id": 2323,
  "project_id": 65,
  "project_name": "DashDescomplicar",
  "rel_type": "project_documentation",
  "comment": "Documentação operacional fase C completa: AGENTS.md (When/How), STATUS.md (PDCA), okf/ (10 relacionamentos), coerência validada",
  "updated_at": "2026-06-30"
 }
@@ -0,0 +1,10 @@
 ---
 type: Brainstorm
 title: 'Brainstorm — DashDescomplicar'
 timestamp: 2026-06-30
 layer: wiki
 ---
 # BRAINSTORM — DashDescomplicar
 Estrutura padrão aplicada.
@@ -0,0 +1,262 @@
 ---
 layer: wiki
 type: Document
 title: "PLAN — DashDescomplicar"
 description: >-
  Plano operacional do DashDescomplicar v2.7.3. Roadmap de manutenção, deploys e expansões.
  Ciclo PDCA: versão atual em produção, próximas iterações planejadas.
 tags: [plan, dashboard, operacional, pdca, roadmap]
 timestamp: 2026-06-30T00:00:00+01:00
 ---
 # PLAN — DashDescomplicar
 **Versão Atual:** 2.7.3 · **Data:** 2026-06-30 · **Status:** 🟢 Operacional
 ---
 ## Visão Geral
 Dashboard interno de monitorização operacional (React 19 + Express + TypeScript) com 8 painéis ativos. Corre em EasyPanel Swarm (`easy.descomplicar.pt`) com MySQL no CWP. Ciclo de releases: manutenção mensal + features trimestrais.
 ---
 ## Roadmap Operacional (Q3-Q4 2026)
 ### Q3 2026 — Consolidação
 | Sprint | Objetivo | Proprietário | Estado |
 |--------|----------|-------------|--------|
 | Q3-S1 (Jul) | Audit segurança completo + certificado de revisão | Claude Code | 📋 Planeado |
 | Q3-S2 (Ago) | Painel Cron Dev (visibilidade de agentes cron) | Claude Code | 📋 Planeado |
 | Q3-S3 (Set) | Reintrodução progressiva Paperclip (renegociação) | Claude Code | 📋 Planeado |
 | Q3-S4 (Out) | Sincronização multi-máquina (HP + desktop) | Claude Code | 📋 Planeado |
 ### Q4 2026 — Expansão Estratégica
 | Sprint | Objetivo | Proprietário | Estado |
 |--------|----------|-------------|--------|
 | Q4-S1 (Nov) | Integração Wiki Descomplicar (leitura de artigos) | Claude Code | 📋 Backlog |
 | Q4-S2 (Dez) | Painel Inteligência Stack — melhorias | Claude Code | 📋 Backlog |
 ---
 ## Ciclos de Manutenção
 ### Semanal (2ªf)
 - ✅ Verificar saúde do serviço: `curl -sf https://dash.descomplicar.pt/api/dashboard`
 - ✅ Revisar logs de erro no EasyPanel
 - ✅ Sincronização manual de sessões se necessário: `rsync -av ~/IJFW/sessions/ easy:/var/dash-sessions/`
 ### Mensal (último Fri)
 - ✅ Audit de dependências: `npm audit`
 - ✅ Atualizar ficheiro STATUS.md com métricas de uptime
 - ✅ Revisar tickets de sugestões e bugs abertos
 ### Trimestral (fim de trimestre)
 - ✅ Revisão de segurança (OWASP top 10)
 - ✅ Testes de carga/stress (Load testing)
 - ✅ Atualização de documentação (AGENTS.md, SPEC.md, CHANGELOG.md)
 - ✅ Release notes e bump de versão
 ---
 ## Processo de Deploy
 ### Pré-requisitos
 1. Branch `main` deve estar com todos os 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
 ### Passos do Deploy (SSH directo no EasyPanel)
 ```bash
 # 1. SSH para o servidor
 ssh root@easy.descomplicar.pt
 # 2. Navegar para a pasta do projeto
 cd /etc/easypanel/projects/descomplicar/dashboard_descomplicar/code
 # 3. Pull da branch main
 git pull origin main
 # 4. Build da imagem Docker
 docker build -t easypanel/descomplicar/dashboard_descomplicar:latest .
 # 5. Forçar reinicialização do serviço
 docker service update --force descomplicar_dashboard_descomplicar
 # 6. Verificação pós-deploy
 curl -sf https://dash.descomplicar.pt/api/dashboard && echo "✅ Deploy OK" || echo "❌ Deploy FALHOU"
 ```
 **Tempo estimado:** 3-5 minutos (pull + build + restart)
 ### Rollback (se necessário)
 ```bash
 # Voltar para versão anterior
 git revert HEAD
 git push origin main
 # Repetir deploy
 ```
 ---
 ## Estrutura de Features
 ### Painéis Ativos (v2.7.3)
 | ID | Painel | Rota | Ficheiros | Status |
 |----|----|------|-----------|--------|
 | 1 | Dashboard | `/` | `pages/Monitor.tsx` | 🟢 Activo |
 | 2 | Monitor | `/monitor` | `pages/Monitor.tsx` | 🟢 Activo |
 | 3 | Financeiro | `/financial` | `pages/Financial.tsx` | 🟢 Activo |
 | 4 | MCPs | `/mcps` | `pages/McpMonitor.tsx` | 🟢 Activo |
 | 5 | n8n | `/n8n` | `pages/N8nMonitor.tsx` | 🟢 Activo |
 | 6 | Paperclip | `/paperclip` | `pages/Paperclip.tsx` | 🟡 Suspenso |
 | 7 | IA/Claude | `/ai` | `pages/AiOverview.tsx` | 🟢 Activo |
 | 8 | Operações | `/operations` | `pages/Operations.tsx` | 🟢 Activo |
 | 9 | Sessions (Observabilidade) | `/sessions` | `pages/Sessions.tsx` + `pages/SessionDetail.tsx` | 🟢 Activo |
 ### Painéis Planeados
 - **Cron Dev** (Q3 2026) — visibilidade de agentes systemd-user cron
 - **Wiki Integration** (Q4 2026) — busca e leitura de artigos do Hub
 - **Inteligência Stack** (Q4 2026) — melhorias e recomendações de stack
 ---
 ## Dependências Críticas
 ### Infraestrutura
 - **EasyPanel:** `easy.descomplicar.pt` (5.9.90.70) — serviço `descomplicar_dashboard_descomplicar`
 - **MySQL:** `176.9.3.158` (CWP) — DB `desscomplicar`, tabelas `tbl_eal_*`
 - **MCP Gateway:** `gateway.descomplicar.pt` — estado de 39 MCPs
 - **Desk CRM:** MySQL interno — tarefas, tickets, projecto
 ### Serviços Externos
 - **n8n:** workflows automação
 - **Moloni API:** dados financeiros
 - **Hetzner Cloud API:** métricas servidores VPS
 - **IJFW:** sessões Claude Code (SQLite local)
 - **SSH (CWP + EasyPanel):** coleta de métricas
 ---
 ## Processo de Contribuição
 ### 1. Local Development
 ```bash
 cd /media/ealmeida/Dados/Dev/DashDescomplicar
 npm install
 npm run dev        # Vite + Express em paralelo
 npm run test       # Vitest
 npm run lint       # ESLint
 ```
 ### 2. Branch Workflow
 ```bash
 git checkout -b feature/meu-painel
 # ... fazer changes ...
 npm run build      # Validar build
 npm run lint       # Lint
 npm test           # Testes
 git add .
 git commit -m "feat: novo painel..."
 git push origin feature/meu-painel
 # Criar PR no Gitea
 ```
 ### 3. Code Review
 - [ ] Build passa
 - [ ] Lint passa
 - [ ] Testes adicionados/passam
 - [ ] Documentação actualizada
 - [ ] Sem hardcoded secrets
 - [ ] Validação Zod em todas as rotas novas
 ### 4. Merge & Deploy
 Após aprovação:
 ```bash
 git merge feature/meu-painel
 git tag v2.7.4     # Nova versão
 npm run build
 npm start          # Local test
 # Seguir "Processo de Deploy" acima
 ```
 ---
 ## Troubleshooting Rápido
 ### Serviço não responde
 ```bash
 # 1. SSH no EasyPanel
 ssh root@easy.descomplicar.pt
 # 2. Verificar logs
 docker logs descomplicar_dashboard_descomplicar
 # 3. Reiniciar serviço
 docker service update --force descomplicar_dashboard_descomplicar
 ```
 ### Build local falha
 ```bash
 # Limpar cache e reinstalar
 rm -rf node_modules package-lock.json
 npm install
 npm run build
 ```
 ### DB não responde
 ```bash
 # Verificar conectividade MySQL
 mysql -h 176.9.3.158 -u [user] -p [pass] desscomplicar
 # Se falhar, contactar administrador de infraestrutura
 ```
 ---
 ## Métricas de Saúde
 Monitorar semanalmente:
 - **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
 Alertas automáticos configurados em `monitor-alerts` (Desk #2323 com regra DO monitor).
 ---
 ## Contactos & Escalação
 | Cenário | Contacto | Nível |
 |---------|----------|-------|
 | Bug/Feature Request | Comentário em Desk #65 | Prioridade normal |
 | Incidente crítico (site down) | Usar CodeRED: `curl -X POST https://codered.descomplicar.pt/v1/trigger/RED-ZMT3FCU8` | P0 |
 | Questão técnica | IRC com Claude Code (`DocFaseA-DashDescomplicar`) | On-demand |
 | Deploy urgente | SSH directo + pós-deploy verification | On-demand |
 ---
 **Próxima revisão de plano:** 2026-09-30 (fim Q3)
@@ -1,15 +1,18 @@
 ---
 title: PLAN Conductor — Expansão DashDescomplicar
 description: >-
  Spec: `docs/SPECS/SPEC-dashboard-expansion-q2-2026.md`
 date: 2026-04-06
 type: plan
 status: active
 spec: SPEC-dashboard-expansion-q2-2026.md
 tags: [conductor, plan, dashboard, parallel]
 layer: wiki
 ---
 # Plano Conductor — Expansão DashDescomplicar
-**Spec:** `docs/SPEC-dashboard-expansion-q2-2026.md`
+**Spec:** `docs/SPECS/SPEC-dashboard-expansion-q2-2026.md`
 **Projecto:** `/media/ealmeida/Dados/Dev/DashDescomplicar/`
 **Método:** Conductor parallel sprints — agentes independentes por domínio
@@ -62,7 +65,7 @@ Cada painel (backend + frontend) é **independente** — ficheiros distintos, se
 Estás a trabalhar no projecto DashDescomplicar (/media/ealmeida/Dados/Dev/DashDescomplicar/).
 Stack: React 19 + Vite + Tailwind CSS 4 + Express 4 + TypeScript.
-Lê a spec completa em docs/SPEC-dashboard-expansion-q2-2026.md, secção 4.1 (Painel MCPs).
+Lê a spec completa em docs/SPECS/SPEC-dashboard-expansion-q2-2026.md, secção 4.1 (Painel MCPs).
 Cria 3 ficheiros:
@@ -117,7 +120,7 @@ Não alteres nenhum ficheiro existente. Apenas cria os 3 novos.
 Estás a trabalhar no projecto DashDescomplicar (/media/ealmeida/Dados/Dev/DashDescomplicar/).
 Stack: React 19 + Vite + Tailwind CSS 4 + Express 4 + TypeScript.
-Lê a spec completa em docs/SPEC-dashboard-expansion-q2-2026.md, secção 4.2 (Painel n8n).
+Lê a spec completa em docs/SPECS/SPEC-dashboard-expansion-q2-2026.md, secção 4.2 (Painel n8n).
 Cria 3 ficheiros:
@@ -159,7 +162,7 @@ Não alteres nenhum ficheiro existente. Apenas cria os 3 novos.
 Estás a trabalhar no projecto DashDescomplicar (/media/ealmeida/Dados/Dev/DashDescomplicar/).
 Stack: React 19 + Vite + Tailwind CSS 4 + Express 4 + TypeScript.
-Lê a spec completa em docs/SPEC-dashboard-expansion-q2-2026.md, secção 4.3 (Painel Paperclip).
+Lê a spec completa em docs/SPECS/SPEC-dashboard-expansion-q2-2026.md, secção 4.3 (Painel Paperclip).
 O pacote `pg` já foi instalado (npm install pg @types/pg).
@@ -211,7 +214,7 @@ Não alteres nenhum ficheiro existente. Apenas cria os 4 novos.
 Estás a trabalhar no projecto DashDescomplicar (/media/ealmeida/Dados/Dev/DashDescomplicar/).
 Stack: React 19 + Vite + Tailwind CSS 4 + Express 4 + TypeScript.
-Lê a spec completa em docs/SPEC-dashboard-expansion-q2-2026.md, secção 4.4 (Painel Claude Code / IA).
+Lê a spec completa em docs/SPECS/SPEC-dashboard-expansion-q2-2026.md, secção 4.4 (Painel Claude Code / IA).
 Cria 3 ficheiros:
@@ -261,7 +264,7 @@ Não alteres nenhum ficheiro existente. Apenas cria os 3 novos.
 Estás a trabalhar no projecto DashDescomplicar (/media/ealmeida/Dados/Dev/DashDescomplicar/).
 Stack: React 19 + Vite + Tailwind CSS 4 + Express 4 + TypeScript.
-Lê a spec em docs/SPEC-dashboard-expansion-q2-2026.md, secção 4.5 (Painel Operações).
+Lê a spec em docs/SPECS/SPEC-dashboard-expansion-q2-2026.md, secção 4.5 (Painel Operações).
 A BD MySQL (Desk CRM) já tem conexão configurada em api/db.ts (export default pool mysql2/promise).
@@ -0,0 +1,10 @@
 ---
 type: Plan
 title: 'PLAN — DashDescomplicar'
 timestamp: 2026-06-30
 layer: wiki
 ---
 # PLAN — DashDescomplicar
 1. Estruturação\n2. Validação\n3. Manutenção
@@ -0,0 +1,10 @@
 ---
 type: Brief
 title: 'Briefing — DashDescomplicar'
 timestamp: 2026-06-30
 layer: wiki
 ---
 # BRIEF — DashDescomplicar
 Projecto DashDescomplicar do ecossistema Descomplicar.
@@ -1,3 +1,11 @@
 ---
 type: Specification
 title: Spec
 description: >-
  Especificação do projecto DashDescomplicar, agregando os projectos activos — nomeadamente o painel Observabilidade (replay de sessões Claude Code com indexer, SQLite, API e UI timeline).
 timestamp: 2026-04-27T10:15:35.733200+00:00
 layer: wiki
 ---
 <!-- APPROVED: 2026-04-23 by ealmeida -->
 # SPEC — DashDescomplicar
@@ -1,10 +1,13 @@
 ---
 title: SPEC — Expansão DashDescomplicar Q2 2026
 description: >-
  O DashDescomplicar é o painel de gestão interno da Descomplicar®. Stack: React 19 + Vite + Tailwind CSS 4 + Express 4 + …
 date: 2026-04-06
 type: spec
 status: active
 desk_project: 65
 tags: [dashboard, expansion, mcps, paperclip, n8n, claude-code]
 layer: wiki
 ---
 # SPEC — Expansão DashDescomplicar Q2 2026
@@ -0,0 +1,11 @@
 ---
 type: Spec
 title: 'SPEC — DashDescomplicar'
 status: draft
 timestamp: 2026-06-30
 layer: wiki
 ---
 # SPEC — DashDescomplicar
 Projecto em estruturação.
@@ -0,0 +1,10 @@
 ---
 type: Note
 title: 'Pesquisa — DashDescomplicar'
 timestamp: 2026-06-30
 layer: wiki
 ---
 # Pesquisa
 Documentar pesquisa aqui.
@@ -0,0 +1,39 @@
 ---
 layer: wiki
 type: Index
 title: "DashDescomplicar — Índice"
 description: >-
  Índice de navegação do DashDescomplicar. Dashboard operacional interno da Descomplicar® em dash.descomplicar.pt.
 tags: [index, dashboard, aplicacao]
 timestamp: 2026-06-29T23:00:00+01:00
 ---
 # DashDescomplicar
 ## Documentação
 - [[AGENTS]] — contexto 5W2H para agentes IA
 - [[CLAUDE]] — instruções operacionais para Claude Code
 - [[STATUS]] — estado PDCA e bloqueios
 - [[README]] — referência técnica completa
 - [[CHANGELOG]] — histórico de versões
 - [[MEMORY]] — memórias operacionais acumuladas
 - [[SYS-DashDescomplicar]] — descrição do sistema e painéis
 ## Especificações e Planos
 - [[docs/SPECS/SPEC-dashboard-expansion-q2-2026]] — spec expansão Q2 2026
 - [[docs/PLANS/PLAN-conductor-dashboard-expansion]] — plano de expansão (Conductor)
 - [[AUDIT-REPORT]] — relatório de auditoria de segurança
 - [[SPEC]] — especificação activa (Observabilidade)
 ## Recursos Externos
 - [dash.descomplicar.pt](https://dash.descomplicar.pt) — produção
 - [git.descomplicar.pt/ealmeida/DashDescomplicar](https://git.descomplicar.pt/ealmeida/DashDescomplicar) — repositório
 - [easy.descomplicar.pt](https://easy.descomplicar.pt) — EasyPanel (deploy)
 - [Desk Projecto #65](https://desk.descomplicar.pt) — gestão de tarefas
 ## Dev Local
 - `/media/ealmeida/Dados/Dev/DashDescomplicar` — código fonte
 - `/media/ealmeida/Dados/Hub/04-Stack/02.05-Aplicações/DashDescomplicar/` — esta pasta Hub
@@ -0,0 +1,23 @@
 ---
 layer: wiki
 type: Changelog
 title: "Log — DashDescomplicar"
 description: >-
  Histórico append-only de operações e eventos em 02.05-Aplicações/DashDescomplicar.
 timestamp: 2026-06-30T00:00:00+01:00
 tags: [log, okf, dashdescomplicar]
 status: active
 ---
 # Log — DashDescomplicar
 **Newest first. Append-only. Formato: `## YYYY-MM-DD tipo | Descrição`**
 ---
 ## 2026-06-30 okf | log.md criado
 - Ficheiro criado conforme modelo OKF Karpathy (XDP-PRJ-001)
 ---
 *Última alteração: 2026-06-30*