Conceptos básicos de gobernanza

ls docs/postgresql-style-guide.md  # o el equivalente en el repositorio
psql -c "SELECT extname FROM pg_extension ORDER BY 1;"

# Guía de estilo de PostgreSQL (extracto)
- Tablas: snake_case plural (`orders`, `line_items`)
- PK: `bigint GENERATED ALWAYS AS IDENTITY` o `uuid` con valor predeterminado explícito
- Marcas de tiempo: `timestamptz` llamado `created_at`, `updated_at`
- FK: `{nombre_singular_tabla_referenciada}_id`
- No usar palabras reservadas sin comillas

CREATE ROLE app_read NOLOGIN;
CREATE ROLE app_write NOLOGIN;
CREATE ROLE migrator LOGIN PASSWORD 'vault-rotated';
 
GRANT app_read TO app_api;
GRANT app_write TO app_worker;
-- migrator posee DDL solo en CI

SELECT extname, extversion FROM pg_extension;

El equipo de servicio escribe SQL → El DBA revisa el nivel → La CI aplica con el rol migrator

# ADR-0142: Blob de configuración JSONB en tenants
Estado: Aceptado
Contexto: Indicadores rápidos de tenant antes de GA
Consecuencia: Validar en la aplicación; migrar a columnas para el Q4
Fecha de revisión: 2026-12-01

-- Trabajo semanal: objetos creados fuera del rol migrator
SELECT obj.object_identity, ev.objid, ev.classid
FROM pg_event_trigger_ddl_commands() ev
JOIN pg_identify_object(ev.classid, ev.objid, ev.objsubid) obj
ON true;
-- Preferir auditoría de ddl a través de pgaudit o disparador de eventos en la cuenta de plataforma

payments_db y billing_db usan lo mismo:
- guía de nomenclatura
- convenciones de marcas de tiempo
- nomenclatura de políticas RLS (`{tabla}_tenant_isolation`)