docs(okf): entidades e relacionamentos OKF do DashDescomplicar

2026-10-28 16:01:20 +00:00
parent f063a2ec8c
commit 61ae4697f9
48 changed files with 2610 additions and 0 deletions
@@ -0,0 +1,69 @@
+---
+type: Entity
+layer: wiki
+tags: [stack, dashdescomplicar, infra, systemd, timers, observabilidade]
+title: "Systemd-Timers"
+---
+
+# Systemd-Timers
+
+Timers systemd (user) que executam scripts de observabilidade do DashDescomplicar no desktop local (`dev`). Gerem indexação de sessões, import de worklogs e detecção de padrões.
+
+## Responsabilidades
+
+- **Indexação contínua**: Watcher incremental de ficheiros JSONL (Claude Code)
+- **Import worklogs**: Import diário de worklogs Desk CRM (discussions #31/#32/#33)
+- **Detecção padrões**: Análise semanal de padrões de uso (tools, skills, erros)
+- **Publicação**: Resultados publicados para consulta pela API
+
+## Serviços e Timers
+
+| Ficheiro | Tipo | Schedule | Função |
+|---|---|---|---|
+| `observabilidade-indexer.service` | simple (always-on) | — | Watcher incremental ficheiros JSONL |
+| `observabilidade-worklog-import.service` | oneshot | — | Import worklogs Desk |
+| `observabilidade-worklog-import.timer` | timer | Diário 03:00 | Dispara import worklogs |
+| `observabilidade-patterns.service` | oneshot | — | Detecção de padrões |
+| `observabilidade-patterns.timer` | timer | Dom 23:00 | Dispara detecção semanal |
+| `observabilidade-patterns.env.example` | env | — | Template variáveis ambiente |
+
+## Stack
+
+- **Runtime**: Node.js 22.22.2 via `npx tsx`
+- **Working Directory**: `/media/ealmeida/Dados/Dev/DashDescomplicar`
+- **DB Path**: `~/.claude-work/sessions.db`
+- **Logs**: `~/.claude-work/observabilidade-*.log`
+
+## Comandos Executados
+
+```
+# Indexer (always-on)
+npx tsx api/scripts/sessions-indexer.ts --watch
+
+# Worklog Import (daily 03:00)
+npx tsx api/scripts/sessions-worklog-import.ts --discussion all --since-days 7
+
+# Patterns (weekly Sun 23:00)
+npx tsx api/scripts/sessions-patterns.ts --publish
+```
+
+## Localizações
+
+- **Systemd files**: `Dev/DashDescomplicar/systemd/` (5 ficheiros)
+- **Scripts**: `Dev/DashDescomplicar/api/scripts/sessions-*.ts`
+- **Logs**: `~/.claude-work/observabilidade-*.log`
+- **DB**: `~/.claude-work/sessions.db`
+- **Env file**: `~/.claude-work/observabilidade-patterns.env`
+
+## Dependências
+
+- **Node.js 22**: `/home/ealmeida/.nvm/versions/node/v22.22.2/bin/`
+- **Observabilidade-Sessions**: Scripts e lógica de indexação
+- **Gemini-Telemetry**: Dados de telemetria Gemini no mesmo DB
+- **Sistema de Ficheiros**: `~/.claude/projects/`, `~/.hermes/`, `~/.local/share/opencode/`
+
+## Fornece a
+
+- **Observabilidade-Sessions**: Execução agendada dos scripts
+- **Painel-Sessoes**: Dados actualizados para consulta
+- **Express-API**: Sessões indexadas disponíveis via `/api/sessions`