From c4fb886f9f3a74eb49397556e2b29a68f39ba87e Mon Sep 17 00:00:00 2001 From: forge-bot Date: Tue, 14 Jul 2026 11:06:16 +0000 Subject: [PATCH] =?UTF-8?q?AA=20=EC=97=AD=ED=95=A0=20=EB=A0=88=EA=B1=B0?= =?UTF-8?q?=EC=8B=9C=20=EB=B6=84=EC=84=9D=20smoke=20(runtime-role-matrix-l?= =?UTF-8?q?ive-20260714105818-v9-aa-001)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- docs/audit/role-aa-legacy-analysis.md | 68 +++++++++++++++++++++++++++ 1 file changed, 68 insertions(+) create mode 100644 docs/audit/role-aa-legacy-analysis.md diff --git a/docs/audit/role-aa-legacy-analysis.md b/docs/audit/role-aa-legacy-analysis.md new file mode 100644 index 0000000..1de4597 --- /dev/null +++ b/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 | + +--- + +**문서 종료**