Project

General

Profile

Feature #1295

Updated by 성용 양 14 days ago

## 목적 

 기존 데이터가 오기 전에 이관 방식을 설계하고, 받은 자료의 형태와 규모를 파악합니다. (FR-MIG-001, NFR-OPS-006) 

 ## 쉬운 설명 

 기존 데이터가 오기 전에 이관 방식을 설계하고, 받은 자료의 형태와 규모를 파악합니다. 기존 항목이 학생·성적 자료가 어떤 형태인지 목록으로 만들고, 새 시스템 항목의 무엇에 해당하는지 짝지은 매핑표와 항목과 1:1로 대응시키는 표(매핑표)와 검증 기준을 만듭니다. 

 ## 기술 스택 

 CSV/Excel 분석(pandas 후보), 매핑 표, 검증 기준 문서. 

 ## 예상 결과(산출물) 

 기존 자료 인벤토리, 필드 매핑표(기존 항목 ↔ 새 모델), 중복·누락·정합성 검증 기준. 

 ## 개발 작업 상세 

 1. 00-04에서 받은 기존 데이터의 파일 형태·규모·첨부 종류를 파악한다. 
 2. 기존 항목을 새 모델 필드에 매핑한다(개인정보 영역과 학사 영역을 나눠 표시). 
 3. 중복·누락·참조 무결성·건수 검증 기준을 정한다. 
 4. 운영 개인정보는 개발 노트북에 복사하지 않는다(합성 데이터로 스크립트 개발). 

 ## 완료 기준 

 - 매핑표와 검증 기준이 팀 리뷰를 받았다. 

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

 legacy_migration/ 앱은 서현 소유. 문서는 docs/migration/ 에 둡니다. 

 ## 선행·후행·위험 

 선행: 00-04 대학 자료 요청과 수령 관리(우섭, 11/18 종료) / 01-02 ERD·모델 계약 초안(앱 간 FK 규칙)(우섭, 11/11 종료) 

 후행: 14-02 이관 스크립트(합성 데이터 리허설용)(서현) 

 위험: 자료 미수령 시 매핑 틀만 완성하고 실제 매핑은 수령 후. 

 ## 결과 확인 방법 

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

 1. 매핑표와 자료 목록 / 새 시스템 항목 / 변환 규칙 / 검증 기준이 팀 리뷰를 받았다. 
 2. pytest가 모두 통과한다. 
 3. 확인 결과(화면 캡처 또는 명령 출력 요약)를 일감 메모에 남긴다. 담긴 표가 있고 빠진 항목이 표시되면 완료입니다. 

 ## 시작 전 준비 

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

 ## 작업 진행 순서 

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

 ## 막힐 때 확인 

 실제 자료는 개인정보입니다. 저장소에 올리지 말고 매핑표에는 항목 이름만 적으세요. 

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

 ## 용어 풀이 

 - **합성 데이터**: 실제 개인정보가 아닌, 시험용으로 만든 가짜 데이터입니다. 
 - **이관·매핑표**: 기존 자료를 새 시스템으로 옮기는 일이 이관이고, 기존 항목이 새 항목의 무엇에 해당하는지 짝지은 표가 매핑표입니다. 
 - **정합성**: 옮기기 전과 후의 건수·합계·내용이 서로 맞는지를 뜻합니다. 
 - **openpyxl**: Python에서 Excel(.xlsx) 파일을 읽고 쓰는 라이브러리입니다.

Back