runtime-role-smoke-20260714.../legacy-transition-audit-evidence.md

5 KiB

레거시 전환 분석 감사 증적 정리

문서 버전: 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 플랫폼 마이그레이션
증적 감사 추적에 사용되는 근거 자료
블루-그린 배포 무중단 배포 전략

문서 종료