SOMA-PRO/database/schema/README.md

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».