Auditoria de dados no ecosif-compliance (AUD-01 Python)¶
Extensão do contrato AUD-01 para o serviço Flask/SQLAlchemy.
Mecanismo¶
| Tema | Decisão |
|---|---|
| Captura | SQLAlchemy before_flush (diff) + after_flush (persist com PK) |
| Tabelas | Mesmas sys_audit_config / sys_audit_event |
| Transação | Evento na mesma TX do negócio |
| Recursão | Entidades sys_audit_* ignoradas |
| Ator | flask.g.ecosif_user (username / id) |
service_name |
ecosif-compliance (config audit.service-name) |
Association tables (co_documents_rules) são capturadas via histórico de relationships secondary.
Configuração¶
Em config.json (ou env):
"audit": {
"enabled": "${ECOSIF_AUDIT_ENABLED:-true}",
"service-name": "${ECOSIF_AUDIT_SERVICE_NAME:-ecosif-compliance}",
"config-cache-ttl-seconds": "${ECOSIF_AUDIT_CONFIG_CACHE_TTL_SECONDS:-60}"
}
Desligar: ECOSIF_AUDIT_ENABLED=false ou UPDATE sys_audit_config SET enabled=false.
Seed¶
Flyway V0.7.00.21 — tabelas co_*. Ver nota.
CUD em gr_* / ct_* já seedados nas Ondas 1–2 também gera evento quando o commit passa pelo SQLAlchemy deste serviço.
Código¶
app/db/audit/ — models, cache, diff, actor, listener. Wiring em app/db/session_manager.py.
Testes¶
Unitário (SQLite):
cd ecosif-compliance && .venv/bin/pytest tests/test_audit_listener.py -q
Integração Postgres (cria DB ecosif_compliance_audit_it, aplica V0.7.00.11 + seed V0.7.00.21, CUD co_rules / association / gr_filial com ator Flask):
cd ecosif-compliance && .venv/bin/pytest tests/test_audit_integration_pg.py -m integration -v
DSN opcional: ECOSIF_AUDIT_IT_DSN (default postgresql+psycopg2://postgres:postgres@localhost:5432/postgres).