# Documentación del Proyecto

Este directorio contiene documentación técnica viva, orientada a:
- Entender la arquitectura y los flujos principales.
- Operar el sistema (variables de entorno, métricas, schedulers).
- Mapear la cobertura de tests.
- Guías prácticas (how-to) para extender funcionalidades con seguridad.
- Decisiones de arquitectura (ADRs) y su motivación.

Índice recomendado:
- overview.md — visión general y flujos clave.
- architecture.md — responsabilidades por módulo y dependencias.
- database.md — esquema funcional, PRAGMAs y migraciones.
- operations.md — operación y configuración (env, métricas, schedulers).
- tests-map.md — qué cubre cada suite y huecos de cobertura.
- how-to/
  - adding-command.md
  - adding-migration.md
  - adjusting-group-sync.md
  - adding-env.md
- adr/
  - 0001-wal.md
  - 0002-up-only-migrations.md