30 lines
1.7 KiB
Markdown
30 lines
1.7 KiB
Markdown
# `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».
|