Pular para conteúdo

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