# `database/schema/` — espejo legible de la estructura

Estos `.sql` son la foto legible y actual de cómo está armada la base: los schemas, las
extensiones, los tipos y las 25 tablas, cada uno en su archivo. Sirven para **leer** cómo
es la base hoy de un vistazo, sin reconstruirla mentalmente leyendo toda la historia de
migraciones.

**No son lo que arma la base. No los corras.** Quien aplica los cambios son las migraciones
(`supabase/migrations/`). Estos archivos solo reflejan el resultado, y se mantienen **a
mano**: después de cada migración editás el `.sql` del objeto que tocaste para que muestre
el estado nuevo. Si te salteás ese paso, el archivo miente y deja de servir como referencia.

## Qué hay en este árbol

- `00_schemas.sql` — el schema `internal` y su blindaje (REVOKE / default-deny).
- `10_extensions_y_types.sql` — las extensiones y el tipo `internal.timerange`.
- `tables/` — las 25 tablas (`internal` + `public`), cada una en su `.sql`.
- `seeds/internal/app_config.sql` — el mirror de los valores del seed de
  `internal.app_config` (el seed lo aplica la migración
  `supabase/migrations/20260604155956_seed_app_config.sql`).

## Lo demás vive en `Documentation/`

- **Qué es esta representación y por qué existe** → `Documentation/EntornoDesarrollo.md`,
  «Representación estática de la DB».
- **Cómo se opera** —cambiar una tabla o función, promover a prod, resetear dev, levantar un
  entorno nuevo— → `Documentation/GuiaOperacionEntorno.md`.
- **Por qué se llegó a este modelo** —el orquestador y el `apply.sh` que existieron y se
  borraron— → `Documentation/Historico/EntornoDesarrollo.md`, «De dos carriles a uno».