Noções Básicas de Governança

ls docs/postgresql-style-guide.md  # ou equivalente do repositório
psql -c "SELECT extname FROM pg_extension ORDER BY 1;"

# Guia de Estilo PostgreSQL (trecho)
- Tabelas: snake_case plural (`orders`, `line_items`)
- PK: `bigint GENERATED ALWAYS AS IDENTITY` ou `uuid` com default explícito
- Timestamps: `timestamptz` nomeado `created_at`, `updated_at`
- FK: `{referenced_table_singular}_id`
- Nenhuma palavra reservada sem aspas

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 possui DDL apenas em CI

SELECT extname, extversion FROM pg_extension;

Equipe de serviço escreve SQL → DBA revisa o nível → CI aplica com role migrator

# ADR-0142: Blob de configuração JSONB em tenants
Status: Aceito
Contexto: Flags rápidas de tenant antes do GA
Consequência: Validar no aplicativo; migrar para colunas até o Q4
Data de revisão: 2026-12-01

-- Tarefa semanal: objetos criados fora do role 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 auditoria de ddl via pgaudit ou event trigger na conta de plataforma

payments_db e billing_db usam o mesmo:
- guia de nomenclatura
- convenções de timestamp
- política de nomenclatura RLS (`{table}_tenant_isolation`)