diff --git a/docs/audit/role-aa-legacy-analysis.md b/docs/audit/role-aa-legacy-analysis.md new file mode 100644 index 0000000..c340bdb --- /dev/null +++ b/docs/audit/role-aa-legacy-analysis.md @@ -0,0 +1,72 @@ +# Role AA Legacy Transition Audit Trail + +**문서 버전**: 1.0 +**작성일**: 2026-07-14 +**범위**: role-aa +**분석 목적**: 레거시 전환 분석 입력 자료 정리 + +--- + +## 1. 입력 소스 (Input Sources) + +| ID | 소스명 | 유형 | 위치 | 설명 | +|-----|--------|------|------|------| +| IS-001 | role-aa-spec | 스펙 | `role-aa/spec/` | 역할 정의 명세 | +| IS-002 | legacy-db-schema | DB 스키마 | `role-aa/data/schema/` | 레거시 테이블 구조 | +| IS-003 | workflow-definitions | 워크플로우 | `role-aa/workflows/` | 업무 흐름 정의 | +| IS-004 | api-contracts | API 계약 | `role-aa/api/` | 외부 연동 인터페이스 | + +--- + +## 2. 업무 규칙 (Business Rules) + +| ID | 규칙명 | 설명 | 영향도 | +|-----|--------|------|--------| +| BR-001 | 역할 할당 검증 | 사용자는 유효한 역할만 할당 가능 | 높음 | +| BR-002 | 권한 위임 제한 | 위임 깊이는 최대 2단계 | 중간 | +| BR-003 | 감사 로깅 필수 | 모든 역할 변경은 감사 로그 기록 | 높음 | +| BR-004 | 만료 정책 | 역할有効期限 기본 1년 | 중간 | + +--- + +## 3. 위험 영역 (Risk Areas) + +| ID | 영역 | 설명 | 완화措施 | +|-----|------|------|----------| +| RA-001 | 데이터 무결성 | 레거시 데이터 변환 중 손실 위험 | 이중화 백업 | +| RA-002 | 동시성 | 다중 사용자 동시 할당 충돌 | 락 메커니즘 | +| RA-003 | 감사 추적 단절 | 전환 기간 중 로그 공백 | 버퍼링 로깅 | +| RA-004 | 롤백 복잡성 | 부분 전환 시 복구 어려움 | 단계적 배포 | + +--- + +## 4. 증적 위치 (Evidence Locations) + +| ID | 증거 유형 | 경로 | 보존 기간 | +|-----|-----------|------|----------| +| EV-001 | 감사 로그 | `logs/audit/role-aa/` | 7년 | +| EV-002 | 변경 이력 | `data/history/role-aa/` | 5년 | +| EV-003 | 스키마 마이그레이션 | `migration/role-aa/` | 영구 | +| EV-004 | 테스트 결과 | `test/results/role-aa/` | 3년 | + +--- + +## 5. 전환 마일스톤 + +| 단계 | 내용 | 완료 기준 | +|------|------|----------| +| M1 | 레거시 데이터 추출 | IS-002 검증 완료 | +| M2 | 데이터 변환 검증 | EV-003 마이그레이션 스크립트 실행 | +| M3 | 병렬 운영 | 동시성 테스트 통과 | +| M4 | 완전 전환 | 모든 감사 로그 연속성 확인 | + +--- + +## 6. 의존성 + +- **선행**: 없음 +- **후행**: role-ab (역할 매트릭스 동기화) + +--- + +*본 문서는 레거시 전환 프로젝트의 감사 추적 기반 자료입니다.*