ADR-DS-031_감사로그 최소 스키마

1. 기본 정보

• ADR ID: ADR-DS-031
• 제목: 감사로그 최소 스키마
• 상태: Draft
• 작성일: 2026-03-08
• 관련 ADR: ADR-DS-000, ADR-DS-015

2. 결정

상태 전이/결제/검증 이벤트에 대해 최소 감사 필드를 의무화한다.

필수 필드:

• event_id
• event_type
• entity_type
• entity_id
• actor_type (user|partner|system|admin)
• actor_id (nullable)
• before_state (nullable)
• after_state (nullable)
• reason_code (nullable)
• occurred_at (UTC)
• request_id / idempotency_key (nullable)

3. 원칙

• 상태 변경 이벤트는 before/after를 반드시 남긴다.
• 결제/검증 이벤트도 동일 request_id로 상관관계 추적 가능해야 한다.
• 운영자 수동 조정은 별도 ops_action으로 명확히 구분한다.

Buy me a coffee