Files
fn_registry/docs/templates/flow.md
T
egutierrez 581d0f0a0e docs: dod_evidence_schema templates + READMEs (issue 0114)
- docs/templates/issue.md and docs/templates/flow.md include the optional
  dod_evidence_schema: block with realistic example items.
- dev/issues/README.md and dev/flows/README.md document the schema, kinds
  by example, validation rules and the fn doctor dod entrypoint.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-18 18:13:02 +02:00

2.5 KiB

name, id, status, created, updated, priority, risk, related_issues, apps, trigger, schedule, expected_runtime_s, tags, dod_evidence_schema
name id status created updated priority risk related_issues apps trigger schedule expected_runtime_s tags dod_evidence_schema
<slug-del-flow> NNNN pending 2026-05-18 2026-05-18 high low
manual 60
id kind expected required
surface_dashboard url https://metabase.organic-machine.com/dashboard/12 muestra ultimo refresh hoy true
id kind expected required
matrix_room_msg screenshot sala matrix #flows recibe mensaje con resumen del run true
id kind expected required
data_factory_run cmd sqlite3 data_factory.db 'SELECT count(*) FROM runs WHERE flow=NNNN AND created_at > date(now,-1 day)' > 0 true
id kind expected required
error_path_log log fallar collector intencional deja entry status=error en operations.db sin crash false

Goal

Una frase: que estamos probando.

Pre-requisitos

  • Lista de requisitos manuales (ej. Chrome con remote-debugging).

Flow

Pasos numerados. Cada paso puede ser:

  • texto libre (manual)
  • function: <id> (registry function)
  • cmd: <bash>
  • js: <expression> (en tab Chrome)

Acceptance

  • Checklist
  • ...

Definition of Done

  • Repetibilidad: corre N veces consecutivas sin intervencion manual.
  • Observabilidad: call_monitor.calls + data_factory.runs + dashboard.
  • Error-path: 1 modo de fallo probado y manejado (no crash silencioso).
  • Idempotencia: re-ejecutar no duplica datos.
  • Secrets: cero credenciales fuera de pass/vaults.
  • Docs: ## Notas rellenado con hallazgos reales.
  • Registry-first: todas las piezas existen como funciones del registry.
  • INDEX + status: status=done + fila INDEX.md + movido a completed/.
  • User-facing: <accion + lugar exacto>.
  • User-facing repeat: humano vuelve manana y ve datos frescos.
  • User-facing onboarding: parrafo en ## Notas explica "para ver/usar esto: hacer X".
  • User-facing latencia: humano percibe cambio en <X segundos|minutos>.

Telemetria esperada

Que cambia en call_monitor / data_factory.runs / dag_engine.

Notas

Hallazgos tras correr. Incluye el parrafo onboarding.