레거시 전환 분석 증적 정리 (role-aa-001)

legacy-transition-audit-evidence.md

@@ -0,0 +1,137 @@
+# 레거시 전환 분석 감사 증적 정리
+
+**문서 버전**: 1.0  
+**작성일**: 2025-07-14  
+**분석 대상**: 레거시 시스템 전환 프로젝트
+
+---
+
+## 1. 입력 소스 (Input Sources)
+
+| 구분 | 소스명 | 위치 | 유형 | 검증 기준 |
+|------|--------|------|------|----------|
+| IN-001 | 기존 데이터베이스 스키마 | `/legacy/db/schema/` | DDL 스크립트 | 무결성 제약조건 |
+| IN-002 | API 명세서 | `/legacy/api/specs/` | OpenAPI/Swagger | 버전 관리 여부 |
+| IN-003 | 배치 잡 정의 | `/legacy/batch/jobs/` | XML/JSON | 스케줄 주기 |
+| IN-004 | 설정 파일 | `/legacy/config/` | Properties/YAML | 암호화 여부 |
+| IN-005 | 업무 흐름도 | `/legacy/docs/workflows/` | BPMN/Visio | 버전 관리 여부 |
+
+---
+
+## 2. 업무 규칙 (Business Rules)
+
+### 2.1 핵심 업무 규칙 검증 목록
+
+| 규칙 ID | 규칙명 | 현재 구현 | 전환 후 기대값 | 검증 방법 |
+|---------|--------|-----------|----------------|----------|
+| BR-001 | 결제 정산 로직 | 일 1회 배치 | 실시간 처리 | 결과 비교 |
+| BR-002 | 회원 등급 산정 | 월 1회 갱신 | 이벤트 트리거 | 등급 변경 이력 |
+| BR-003 | 재고 차감 정책 | 선점 방식 | 낙관적 잠금 | 동시성 테스트 |
+| BR-004 | 알림 발송 규칙 | 즉시 발송 | 큐 기반 처리 | 발송 순서 |
+| BR-005 | 데이터 보존 정책 | 무제한 | 7년 보존 | 삭제 검증 |
+
+### 2.2 데이터 변환 규칙
+
+| 규칙 ID | 소스 필드 | 대상 필드 | 변환 로직 | 예외 처리 |
+|----------|-----------|-----------|-----------|-----------|
+| TR-001 | `OLD_STATUS_CD` | `new_status` | 매핑 테이블 참조 | 미매핑 시 DEFAULT |
+| TR-002 | `REG_DT` (YYYYMMDD) | `created_at` (TIMESTAMP) | 포맷 변환 | NULL 허용 |
+| TR-003 | `AMT` (원 단위) | `amount` (원 단위) | 소수점 처리 | 반올림 |
+
+---
+
+## 3. 위험 영역 (Risk Areas)
+
+### 3.1 고위험 항목
+
+| 위험 ID | 위험 설명 | 발생 가능성 | 영향도 | 완화 방안 |
+|---------|-----------|-------------|--------|----------|
+| RK-001 | 데이터 손실 | 높음 | 심각 | 이중 백업 + 검증 쿼리 |
+| RK-002 | 서비스 중단 | 중간 | 심각 | 블루-그린 배포 |
+| RK-003 | 성능 저하 | 중간 | 보통 | 부하 테스트 |
+
+### 3.2 중위험 항목
+
+| 위험 ID | 위험 설명 | 발생 가능성 | 영향도 | 완화 방안 |
+|---------|-----------|-------------|--------|----------|
+| RK-004 | 호환성 불일치 | 중간 | 보통 | API 게이트웨이 |
+| RK-005 | 설정 누락 | 낮음 | 보통 | 설정 검증 체크리스트 |
+
+---
+
+## 4. 증적 위치 (Evidence Locations)
+
+### 4.1 전환 전 증적
+
+| 증적 ID | 증적 유형 | 파일 경로 | 보존 기간 | 접근 권한 |
+|---------|-----------|-----------|-----------|-----------|
+| EV-001 | 원본 소스 | `/archive/legacy/v1.0/` | 전환 완료 후 5년 | 감사팀 |
+| EV-002 | 데이터 스냅샷 | `/archive/snapshot/20250701/` | 5년 | DBA |
+| EV-003 | 설정 백업 | `/archive/config/backup/` | 영구 | 보안팀 |
+| EV-004 | 로그 아카이브 | `/archive/logs/legacy/` | 3년 | 운영팀 |
+
+### 4.2 전환 후 검증 증적
+
+| 증적 ID | 증적 유형 | 파일 경로 | 생성 시점 | 검증 주기 |
+|---------|-----------|-----------|-----------|-----------|
+| EV-101 | 전환 보고서 | `/transition/report/` | 전환 완료 시 | 일회성 |
+| EV-102 | 비교 검증 결과 | `/transition/validation/` | 전환 후 24시간 | 전환 후 7일 |
+| EV-103 | 모니터링 대시보드 | `/monitoring/dashboard/` | 실시간 | 상시 |
+| EV-104 | 감사 로그 | `/audit/logs/` | 실시간 | 상시 |
+
+---
+
+## 5. 검증 체크리스트
+
+### 5.1 데이터 무결성 검증
+
+- [ ] 원본 데이터 건수 vs 전환 데이터 건수 일치
+- [ ] 필수 필드 NULL 체크
+- [ ] 외래 키 참조 무결성
+- [ ] 인덱스 재생성 여부
+- [ ] 통계 정보 업데이트 여부
+
+### 5.2 기능 검증
+
+- [ ] 핵심 API 응답 동일성
+- [ ] 배치 잡 실행 결과 동일성
+- [ ] 예외 처리 동작 동일성
+- [ ] 로그 출력 형식 동일성
+
+### 5.3 성능 검증
+
+- [ ] 응답 시간 기준 충족 (P95 < 500ms)
+- [ ] 동시 접속자 수 기준 충족 (1000명)
+- [ ] 배치 처리 시간 기준 충족 (기존 대비 ±10%)
+
+---
+
+## 6. 승인 체계
+
+| 단계 | 역할 | 담당자 | 승인 기한 | 서명 위치 |
+|------|------|--------|-----------|-----------|
+| 1차 검토 | 분석가 | TBD | 전환 3일 전 | `/approval/analyst/` |
+| 2차 검토 | 아키텍트 | TBD | 전환 2일 전 | `/approval/architect/` |
+| 최종 승인 | 프로젝트 매니저 | TBD | 전환 1일 전 | `/approval/pm/` |
+
+---
+
+## 7. 부록
+
+### A. 참조 문서
+
+- 레거시 시스템 구성도: `/legacy/docs/architecture.png`
+- 데이터 사전: `/legacy/docs/data-dictionary.xlsx`
+- 인터페이스 목록: `/legacy/docs/interfaces.csv`
+
+### B. 용어 정의
+
+| 용어 | 정의 |
+|------|------|
+| 전환 | Legacy → Modern 플랫폼 마이그레이션 |
+| 증적 | 감사 추적에 사용되는 근거 자료 |
+| 블루-그린 배포 | 무중단 배포 전략 |
+
+---
+
+**문서 종료**