docs/audit/role-aa-legacy-analysis.md

@@ -0,0 +1,68 @@
+# AA 역할 레거시 전환 분석
+
+**문서 버전**: v1.1
+**작성일**: 2025-07-14
+**대상 역할**: AA
+**분석 목적**: 레거시 시스템 전환을 위한 입력 소스, 업무 규칙, 위험 영역, 증적 위치 정리
+
+---
+
+## 1. 입력 소스 참조 테이블
+
+| ID | 소스 유형 | 파일 경로 | 설명 | 상태 |
+|-----|----------|-----------|------|------|
+| IN-001 | 설정 파일 | `scope/role-aa/config.yaml` | 역할 기본 설정 | 활성 |
+| IN-002 | 스키마 | `scope/role-aa/schema.json` | 데이터 스키마 정의 | 활성 |
+| IN-003 | 매핑 규칙 | `scope/role-aa/mapping-rules.yaml` | 필드 매핑 규칙 | 활성 |
+| IN-004 | 의존성 정의 | `scope/role-aa/dependencies.yaml` | 외부 의존성 선언 | **비활성/미포함** |
+| IN-005 | 검증 스크립트 | `scope/role-aa/validation.sql` | 데이터 검증 쿼리 | 활성 |
+
+### 1.1 비활성 항목 사유 (IN-004)
+
+- **참조 파일**: `scope/role-aa/dependencies.yaml`
+- **비활성 사유**: 해당 파일이 현재 배포 배치에 포함되지 않음
+- **대응 조치**: 참조 상태를 "비활성/미포함"으로 변경
+- **후속 필요 작업**: 의존성 관리가 별도 패키지로 분리될 경우 해당 파일 생성 또는 경로 갱신 필요
+
+---
+
+## 2. 업무 규칙
+
+| 규칙 ID | 규칙명 | 설명 | 적용 조건 |
+|---------|--------|------|----------|
+| BR-001 | 역할 활성화 | AA 역할은 명시적 활성화 명령 없이는 비활성 상태 | 기본값 |
+| BR-002 | 데이터 검증 | 모든 입력 데이터는 schema.json 검증 통과 필요 | IN-002 활성 시 |
+| BR-003 | 매핑 순서 | mapping-rules.yaml의 순서대로 필드 매핑 수행 | IN-003 활성 시 |
+
+---
+
+## 3. 위험 영역
+
+| 위험 ID | 위험명 | 영향도 | 완화 조치 |
+|---------|--------|--------|----------|
+| RK-001 | 입력 소스 누락 | 높음 | IN-004 비활성 상태로 문서화, 배치 완료 후 재평가 |
+| RK-002 | 검증 실패 | 중간 | validation.sql 사전 실행 |
+| RK-003 | 매핑 불일치 | 중간 | mapping-rules.yaml 버전 관리 |
+
+---
+
+## 4. 증적 위치
+
+| 증적 유형 | 위치 | 회수 방법 |
+|-----------|------|----------|
+| 설정 증적 | `scope/role-aa/config.yaml` | 파일 직접 참조 |
+| 스키마 증적 | `scope/role-aa/schema.json` | JSON 파싱 |
+| 검증 로그 | `logs/validation-*.log` | 로그 파일 분석 |
+
+---
+
+## 5. 감사 추적
+
+| 일자 | 작업자 | 변경 내용 | 버전 |
+|------|--------|----------|------|
+| 2025-07-14 | AA | 초기 문서 작성 | v1.0 |
+| 2025-07-14 | AA | IN-004 참조 무결성 수정 (비활성 처리) | v1.1 |
+
+---
+
+**문서 종료**