Merge pull request 'AA 역할 레거시 분석 smoke' (#4) from forge/role-aa-live-v2-001-attempt-1-run-de657bad1198 into main

.forge/role-aa-live-v2-001-attempt-1-run-de657bad1198.md

@@ -0,0 +1,3 @@
+# role-aa-live-v2-001-attempt-1-run-de657bad1198
+
+Forge 이슈 작업 브랜치 `forge/role-aa-live-v2-001-attempt-1-run-de657bad1198`.

audit/AA-legacy-analysis-evidence.json

@@ -0,0 +1,162 @@
+{
+  "auditId": "AUDIT-AA-LEGACY-001",
+  "project": "runtime-role-matrix-live-202607141522-v2",
+  "role": "AA",
+  "analysisDate": "2025-07-14",
+  "version": "1.0",
+  "inputSources": [
+    {
+      "id": "IS-001",
+      "name": "역할 매트릭스 원본 데이터",
+      "type": "data",
+      "location": "data/role-matrix-source.csv",
+      "collectedDate": "2025-07-14",
+      "status": "verified"
+    },
+    {
+      "id": "IS-002",
+      "name": "런타임 역할 매트릭스 설정",
+      "type": "config",
+      "location": "config/runtime-role-matrix.json",
+      "collectedDate": "2025-07-14",
+      "status": "verified"
+    },
+    {
+      "id": "IS-003",
+      "name": "AA 역할 정의 스키마",
+      "type": "schema",
+      "location": "schema/role-aa-schema.yaml",
+      "collectedDate": "2025-07-14",
+      "status": "verified"
+    },
+    {
+      "id": "IS-004",
+      "name": "전환 요구사항 명세",
+      "type": "document",
+      "location": "docs/migration-requirements.md",
+      "collectedDate": "2025-07-14",
+      "status": "reviewing"
+    }
+  ],
+  "businessRules": [
+    {
+      "id": "BR-001",
+      "name": "역할 상속 규칙",
+      "description": "AA 역할은 상위 역할을 상속 가능",
+      "condition": "role_type = 'AA'",
+      "priority": "high"
+    },
+    {
+      "id": "BR-002",
+      "name": "권한 위임 규칙",
+      "description": "AA 역할은 지정된 권한만 위임 가능",
+      "condition": "delegation_flag = true",
+      "priority": "high"
+    },
+    {
+      "id": "BR-003",
+      "name": "매트릭스 검증 규칙",
+      "description": "런타임 매트릭스는 소스와 일치해야 함",
+      "condition": "matrix_version 변경시",
+      "priority": "medium"
+    },
+    {
+      "id": "BR-004",
+      "name": "상태 전이 규칙",
+      "description": "역할 상태는 유효한 상태 전이만 허용",
+      "condition": "state_machine 정의 기준",
+      "priority": "medium"
+    },
+    {
+      "id": "BR-005",
+      "name": "감사 로깅 규칙",
+      "description": "모든 역할 변경은 감사 로그에 기록",
+      "condition": "변경 이벤트 발생시",
+      "priority": "high"
+    },
+    {
+      "id": "BR-006",
+      "name": "만료 처리 규칙",
+      "description": "만료된 역할은 자동 비활성화",
+      "condition": "expiry_date 도달시",
+      "priority": "low"
+    }
+  ],
+  "riskAreas": [
+    {
+      "id": "RA-001",
+      "name": "데이터 불일치 위험",
+      "description": "소스와 런타임 매트릭스 간 데이터 불일치",
+      "impact": "high",
+      "likelihood": "medium",
+      "mitigation": "주기적 동기화 검증"
+    },
+    {
+      "id": "RA-002",
+      "name": "권한 상승 위험",
+      "description": "잘못된 역할 상속으로 권한 과다 부여",
+      "impact": "high",
+      "likelihood": "low",
+      "mitigation": "역할 상속 검증 로직"
+    },
+    {
+      "id": "RA-003",
+      "name": "감사 추적 단절 위험",
+      "description": "로그 기록 누락으로 감사 증거 미흡",
+      "impact": "medium",
+      "likelihood": "medium",
+      "mitigation": "이중 로깅机制"
+    }
+  ],
+  "evidenceLocations": [
+    {
+      "id": "EL-001",
+      "location": "logs/audit/role-change-*.log",
+      "type": "audit_log",
+      "retention": "7년",
+      "access": ["AA", "Admin"]
+    },
+    {
+      "id": "EL-002",
+      "location": "data/role-matrix-source.csv",
+      "type": "source_data",
+      "retention": "영구",
+      "access": ["AA", "Admin"]
+    },
+    {
+      "id": "EL-003",
+      "location": "data/runtime-snapshot/",
+      "type": "runtime_snapshot",
+      "retention": "3년",
+      "access": ["AA"]
+    },
+    {
+      "id": "EL-004",
+      "location": "reports/validation/*.report",
+      "type": "validation_report",
+      "retention": "5년",
+      "access": ["AA", "Auditor"]
+    },
+    {
+      "id": "EL-005",
+      "location": "archive/legacy-config/",
+      "type": "legacy_archive",
+      "retention": "10년",
+      "access": ["Admin"]
+    }
+  ],
+  "followUpActions": [
+    {
+      "id": "ACT-001",
+      "description": "BR-004 상태 전이 규칙 상세 검증",
+      "assignee": "AA",
+      "dueDate": "2025-07-15"
+    },
+    {
+      "id": "ACT-002",
+      "description": "RA-001 데이터 불일치 자동 감지 스크립트 작성",
+      "assignee": "AA",
+      "dueDate": "2025-07-16"
+    }
+  ]
+}

audit/AA-legacy-analysis-smoke-20260714.md

@@ -0,0 +1,82 @@
+# AA 역할 레거시 분석 감사 추적 문서
+
+**문서 ID**: AUDIT-AA-LEGACY-001  
+**버전**: 1.0  
+**작성일**: 2025-07-14  
+**분석 역할**: AA (Analyst)  
+**프로젝트**: runtime-role-matrix-live-202607141522-v2
+
+---
+
+## 1. 개요
+
+본 문서는 레거시 시스템 전환 분석을 위한 감사 추적(Evidence Trail) 문서로, 입력 소스, 업무 규칙, 위험 영역, 증적 위치를 체계적으로 정리한다.
+
+---
+
+## 2. 입력 소스 (Input Sources)
+
+| ID | 소스명 | 유형 | 위치 | 수집일 | 상태 |
+|----|--------|------|------|--------|------|
+| IS-001 | 역할 매트릭스 원본 데이터 | 데이터 | `data/role-matrix-source.csv` | 2025-07-14 | 검증됨 |
+| IS-002 | 런타임 역할 매트릭스 설정 | 설정파일 | `config/runtime-role-matrix.json` | 2025-07-14 | 검증됨 |
+| IS-003 | AA 역할 정의 스키마 | 스키마 | `schema/role-aa-schema.yaml` | 2025-07-14 | 검증됨 |
+| IS-004 | 전환 요구사항 명세 | 문서 | `docs/migration-requirements.md` | 2025-07-14 | 검토중 |
+
+---
+
+## 3. 업무 규칙 (Business Rules)
+
+| ID | 규칙명 | 설명 | 적용 조건 | 우선순위 |
+|----|--------|------|----------|----------|
+| BR-001 | 역할 상속 규칙 | AA 역할은 상위 역할을 상속 가능 | role_type = 'AA' | 높음 |
+| BR-002 | 권한 위임 규칙 | AA 역할은 지정된 권한만 위임 가능 | delegation_flag = true | 높음 |
+| BR-003 | 매트릭스 검증 규칙 | 런타임 매트릭스는 소스와 일치해야 함 | matrix_version 변경시 | 중간 |
+| BR-004 | 상태 전이 규칙 | 역할 상태는 유효한 상태 전이만 허용 | state_machine 정의 기준 | 중간 |
+| BR-005 | 감사 로깅 규칙 | 모든 역할 변경은 감사 로그에 기록 | 변경 이벤트 발생시 | 높음 |
+| BR-006 | 만료 처리 규칙 | 만료된 역할은 자동 비활성화 | expiry_date 도달시 | 낮음 |
+
+---
+
+## 4. 위험 영역 (Risk Areas)
+
+| ID | 위험명 | 설명 | 영향도 | 발생가능성 | 완화措施 |
+|----|--------|------|--------|------------|----------|
+| RA-001 | 데이터 불일치 위험 | 소스와 런타임 매트릭스 간 데이터 불일치 | 높음 | 중간 | 주기적 동기화 검증 |
+| RA-002 | 권한 상승 위험 | 잘못된 역할 상속으로 권한 과다 부여 | 높음 | 낮음 | 역할 상속 검증 로직 |
+| RA-003 | 감사 추적 단절 위험 | 로그 기록 누락으로 감사 증거 미흡 | 중간 | 중간 | 이중 로깅机制 |
+
+---
+
+## 5. 증적 위치 (Evidence Locations)
+
+| ID | 위치 | 증적 유형 | 보존 기간 | 접근 권한 |
+|----|------|----------|----------|----------|
+| EL-001 | `logs/audit/role-change-*.log` | 감사 로그 | 7년 | AA, Admin |
+| EL-002 | `data/role-matrix-source.csv` | 원본 데이터 | 영구 | AA, Admin |
+| EL-003 | `data/runtime-snapshot/` | 런타임 스냅샷 | 3년 | AA |
+| EL-004 | `reports/validation/*.report` | 검증 보고서 | 5년 | AA, Auditor |
+| EL-005 | `archive/legacy-config/` | 레거시 설정 아카이브 | 10년 | Admin |
+
+---
+
+## 6. 검증 체크리스트
+
+- [x] 입력 소스 수집 완료
+- [x] 업무 규칙 문서화 완료
+- [x] 위험 영역 식별 완료
+- [x] 증적 위치 매핑 완료
+- [ ] 추가 검증 필요 (BR-004 상태 전이 규칙)
+
+---
+
+## 7. 후속 조치
+
+| 조치 ID | 설명 | 담당자 | 기한 |
+|---------|------|--------|------|
+| ACT-001 | BR-004 상태 전이 규칙 상세 검증 | AA | 2025-07-15 |
+| ACT-002 | RA-001 데이터 불일치 자동 감지 스크립트 작성 | AA | 2025-07-16 |
+
+---
+
+**문서 종료**

audit/AA-legacy-analysis-summary.yaml

@@ -0,0 +1,57 @@
+---
+# AA 역할 레거시 분석 요약
+audit_id: AUDIT-AA-LEGACY-001
+project: runtime-role-matrix-live-202607141522-v2
+role: AA
+analysis_date: 2025-07-14
+version: 1.0
+
+# 수집 현황
+input_sources:
+  total: 4
+  verified: 3
+  reviewing: 1
+
+business_rules:
+  total: 6
+  high_priority: 3
+  medium_priority: 2
+  low_priority: 1
+
+risk_areas:
+  total: 3
+  high_impact: 2
+  medium_impact: 1
+
+evidence_locations:
+  total: 5
+  audit_logs: 1
+  source_data: 1
+  snapshots: 1
+  reports: 1
+  archives: 1
+
+# 검증 상태
+verification_status:
+  input_sources_collected: true
+  business_rules_documented: true
+  risk_areas_identified: true
+  evidence_locations_mapped: true
+  additional_verification_needed: true
+  pending_item: BR-004 상태 전이 규칙
+
+# 후속 조치
+follow_up_actions:
+  - id: ACT-001
+    status: pending
+    due_date: 2025-07-15
+  - id: ACT-002
+    status: pending
+    due_date: 2025-07-16
+
+# 결론
+conclusion: |
+  레거시 전환 분석을 위한 감사 추적 문서 작성을 완료함.
+  입력 소스 4건, 업무 규칙 6건, 위험 영역 3건, 증적 위치 5건을
+  식별하고 체계적으로 정리함. BR-004 상태 전이 규칙에 대한
+  추가 검증이 필요하며, 2025-07-15까지 완료 예정.