Project

General

Profile

Feature #1297

Updated by 성용 양 14 days ago

## 목적 

 테스트 환경에서 이관을 리허설하고 건수·참조 무결성·핵심 업무 시나리오를 검증해 보고합니다. (NFR-OPS-006, 인수 테스트 8) 

 ## 쉬운 설명 

 테스트 환경에서 이관을 리허설하고 건수·참조 무결성·핵심 업무 시나리오를 검증해 실제처럼 리허설하고, 원본과 이관 결과가 맞는지 정합성 보고서로 정리합니다. 

 ## 기술 스택 

 테스트 서버(Docker), SQL 검증 쿼리, 보고서(Markdown). 

 ## 예상 결과(산출물) 

 정합성 보고서(이관 전후 건수, 무결성, 핵심 시나리오 결과), 재실행 절차. 

 ## 개발 작업 상세 

 1. 분리된 테스트 환경에서 합성 또는 승인된 비식별 데이터로 이관한다. 
 2. 이관 전후 건수와 참조 무결성을 비교한다. 
 3. 핵심 시나리오(학생 조회, 성적 조회, 증명서 발급)를 이관 데이터로 확인한다. 
 4. 보고서를 작성하고 실제 이관 일정·승인 절차를 제안한다. 

 ## 완료 기준 

 - 정합성 보고서가 작성되었다. 

 ## 충돌 방지(소유 범위) 

 legacy_migration/, docs/migration/ 소유. 

 ## 선행·후행·위험 

 선행: 04-03 Dockerfile·Compose·/health/·Gunicorn·Nginx 연결·운영 설정(성용, 11/25 종료) / 14-02 이관 스크립트(합성 데이터 리허설용)(서현, 12/29 12/28 종료) 

 후행: 15-04 인수 체크리스트·운영 인계(최종)(우섭) 

 위험: 실제 데이터 이관은 대학 승인 후이므로 8주 안에 리허설까지만 포함. 

 ## 결과 확인 방법 

 "완료 기준"의 각 항목을 화면 또는 명령으로 직접 확인합니다. 

 1. 정합성 보고서가 작성되었다. 
 2. pytest가 모두 통과한다. 
 3. 확인 결과(화면 캡처 또는 명령 출력 요약)를 일감 메모에 남긴다. 리허설 결과의 건수·합계·샘플 비교가 보고서에 정리되고 불일치 항목의 원인과 조치가 적히면 완료입니다. 

 ## 시작 전 준비 

 1. 00-04의 자료 수령 상태와 05·07·08의 모델 정의를 확인한다. 
 2. 실제 개인정보 파일은 저장소에 올리지 않는다. 연습은 합성 데이터로만 한다. 
 3. 저장소 최신화 후 README 순서대로 환경을 준비한다. 

 ## 작업 진행 순서 

 1. "개발 작업 상세" 순서대로 진행하되 항상 합성 데이터와 별도 환경에서 시험한다. 
 2. 스크립트는 같은 데이터를 여러 번 실행해도 중복되지 않게 만든다. 
 3. 결과 건수와 오류 행을 보고서 형식으로 기록한다. 
 4. PR로 올려 소유자 리뷰를 받는다. 

 ## 막힐 때 확인 

 리허설은 운영 DB가 아닌 별도 환경에서 하세요. 

 그래도 해결되지 않으면 일감 메모에 "무엇을 했고, 어떤 오류가 났는지"를 붙여 담당 분류 소유자 또는 팀장에게 질문하세요. 

 ## 용어 풀이 

 - **Docker·Docker Compose**: 프로그램과 실행 환경을 한 상자(컨테이너)로 묶어 어디서나 같은 방식으로 실행하게 해 주는 도구이고, Compose는 여러 상자(앱·DB)를 한꺼번에 켜고 끄게 해 줍니다. 
 - **합성 데이터**: 실제 개인정보가 아닌, 시험용으로 만든 가짜 데이터입니다. 
 - **이관·매핑표**: 기존 자료를 새 시스템으로 옮기는 일이 이관이고, 기존 항목이 새 항목의 무엇에 해당하는지 짝지은 표가 매핑표입니다. 
 - **정합성**: 옮기기 전과 후의 건수·합계·내용이 서로 맞는지를 뜻합니다.

Back