# 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 |

---

**문서 종료**