diff --git a/docs/role-aa-legacy-analysis.md b/docs/role-aa-legacy-analysis.md new file mode 100644 index 0000000..19f8a80 --- /dev/null +++ b/docs/role-aa-legacy-analysis.md @@ -0,0 +1,89 @@ +# AA 역할 레거시 분석 보고서 + +**문서 버전**: 1.0.0 +**분석 대상**: role-aa +**작성일**: 2026-07-14 +**분석자**: AA Analyst + +--- + +## 1. 개요 + +본 문서는 `role-aa` 스코프의 레거시 전환 범위와 추적 가능한 분석 근거를 정의한다. + +--- + +## 2. 스코프 구성 요소 + +| 구분 | 항목 | 설명 | 상태 | +|------|------|------|------| +| 역할 ID | `role-aa` | 분석가(Analyst) 역할 | 활성 | +| 책임 영역 | 데이터 분석, 인사이트 도출 | 핵심 업무 | 유지 | +| 시스템 접근 | 분석 도구, 데이터 소스 | 권한 범위 | 검토 중 | + +--- + +## 3. 전환 범위 + +### 3.1 전환 대상 + +- **레거시 분석 모듈**: 기존 데이터 처리 로직 +- **보고서 생성 컴포넌트**: 정적 리포트 생성기 +- **데이터 파이프라인**: 수동 ETL 프로세스 + +### 3.2 전환 제외 + +- **핵심 분석 알고리즘**: 검증된 로직, 유지 +- **데이터 소스 연동**: 외부 의존성, 별도 관리 + +--- + +## 4. 추적 가능한 분석 근거 + +### 4.1 코드 기반 근거 + +| 파일 경로 | 변경 유형 | 근거 | +|-----------|-----------|------| +| `src/role-aa/analyzer/` | 마이그레이션 | 레거시 모듈 식별 | +| `src/role-aa/reporter/` | 재작성 | 기술 부채 감소 | +| `src/role-aa/pipeline/` | 자동화 전환 | 수동 프로세스 개선 | + +### 4.2 의존성 분석 + +```json +{ + "role": "role-aa", + "dependencies": { + "internal": ["role-bb", "role-cc"], + "external": ["data-connector-v2", "report-engine"] + }, + "legacyComponents": ["analyzer-core", "report-generator", "etl-manual"] +} +``` + +--- + +## 5. 전환 우선순위 + +| 우선순위 | 컴포넌트 | 이유 | +|----------|----------|------| +| P1 | analyzer-core | 높은 기술 부채 | +| P2 | report-generator | 빈번한 유지보수 | +| P3 | etl-manual | 자동화 여부 | + +--- + +## 6. 검증 기준 + +- [ ] 레거시 모듈 마이그레이션 완료 +- [ ] 단위 테스트 80% 이상 커버리지 +- [ ] 통합 테스트 통과 +- [ ] 문서 업데이트 완료 + +--- + +## 7. 변경 이력 + +| 날짜 | 버전 | 변경 내용 | +|------|------|----------| +| 2026-07-14 | 1.0.0 | 초기 분석 문서 작성 |