DashDescomplicar/okf/entidades/Systemd-Timers.md

type, layer, tags, title

type	layer	tags	title
Entity	wiki	stack dashdescomplicar infra systemd timers observabilidade	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