Actions
Feature #1295
open
성양
서임
Feature #1226: [MDGU] 학사관리 시스템 v1 개발 (8주, 2026-11-05 시작)
Feature #1231: [MDGU-14] 초기 데이터 이관 (C 서현)
[MDGU-14-01] 기존 자료 인벤토리·이관 매핑표·검증 기준
Feature #1295:
[MDGU-14-01] 기존 자료 인벤토리·이관 매핑표·검증 기준
Start date:
11/23/2026
Due date:
11/25/2026 (Due in 8 days)
% Done:
0%
Estimated time:
Description
목적¶
기존 데이터가 오기 전에 이관 방식을 설계하고, 받은 자료의 형태와 규모를 파악합니다. (FR-MIG-001, NFR-OPS-006)
쉬운 설명¶
기존 데이터가 오기 전에 이관 방식을 설계하고, 받은 자료의 형태와 규모를 파악합니다. 기존 항목이 새 시스템 항목의 무엇에 해당하는지 짝지은 매핑표와 검증 기준을 만듭니다.
기술 스택¶
CSV/Excel 분석(pandas 후보), 매핑 표, 검증 기준 문서.
예상 결과(산출물)¶
기존 자료 인벤토리, 필드 매핑표(기존 항목 ↔ 새 모델), 중복·누락·정합성 검증 기준.
개발 작업 상세¶
- 00-04에서 받은 기존 데이터의 파일 형태·규모·첨부 종류를 파악한다.
- 기존 항목을 새 모델 필드에 매핑한다(개인정보 영역과 학사 영역을 나눠 표시).
- 중복·누락·참조 무결성·건수 검증 기준을 정한다.
- 운영 개인정보는 개발 노트북에 복사하지 않는다(합성 데이터로 스크립트 개발).
완료 기준¶
- 매핑표와 검증 기준이 팀 리뷰를 받았다.
충돌 방지(소유 범위)¶
legacy_migration/ 앱은 서현 소유. 문서는 docs/migration/ 에 둡니다.
선행·후행·위험¶
선행: 00-04 대학 자료 요청과 수령 관리(우섭, 11/18 종료) / 01-02 ERD·모델 계약 초안(앱 간 FK 규칙)(우섭, 11/11 종료)
후행: 14-02 이관 스크립트(합성 데이터 리허설용)(서현)
위험: 자료 미수령 시 매핑 틀만 완성하고 실제 매핑은 수령 후.
결과 확인 방법¶
"완료 기준"의 각 항목을 화면 또는 명령으로 직접 확인합니다.
- 매핑표와 검증 기준이 팀 리뷰를 받았다.
- pytest가 모두 통과한다.
- 확인 결과(화면 캡처 또는 명령 출력 요약)를 일감 메모에 남긴다.
갱신 사항 (2026-11-04)¶
- ERD 검수 반영: legacy_id_map(source_system, source_id, target_type, target_id)과 이관 결과용 migration_run을 설계한다.
시작 전 준비¶
- 00-04의 자료 수령 상태와 05·07·08의 모델 정의를 확인한다.
- 실제 개인정보 파일은 저장소에 올리지 않는다. 연습은 합성 데이터로만 한다.
- 저장소 최신화 후 README 순서대로 환경을 준비한다.
작업 진행 순서¶
- "개발 작업 상세" 순서대로 진행하되 항상 합성 데이터와 별도 환경에서 시험한다.
- 스크립트는 같은 데이터를 여러 번 실행해도 중복되지 않게 만든다.
- 결과 건수와 오류 행을 보고서 형식으로 기록한다.
- PR로 올려 소유자 리뷰를 받는다.
막힐 때 확인¶
실제 자료는 개인정보입니다. 저장소에 올리지 말고 매핑표에는 항목 이름만 적으세요.
그래도 해결되지 않으면 일감 메모에 "무엇을 했고, 어떤 오류가 났는지"를 붙여 담당 분류 소유자 또는 팀장에게 질문하세요.
용어 풀이¶
- 합성 데이터: 실제 개인정보가 아닌, 시험용으로 만든 가짜 데이터입니다.
- 이관·매핑표: 기존 자료를 새 시스템으로 옮기는 일이 이관이고, 기존 항목이 새 항목의 무엇에 해당하는지 짝지은 표가 매핑표입니다.
- 정합성: 옮기기 전과 후의 건수·합계·내용이 서로 맞는지를 뜻합니다.
- openpyxl: Python에서 Excel(.xlsx) 파일을 읽고 쓰는 라이브러리입니다.
성양 Updated by 성용 양 19 days ago
- Precedes Feature #1296: [MDGU-14-02] 이관 스크립트(합성 데이터 리허설용) added
성양 Updated by 성용 양 14 days ago
- Due date changed from 11/25/2026 to 11/23/2026
- Start date changed from 11/23/2026 to 11/19/2026
- Follows Feature #1246: [MDGU-00-04] 대학 자료 요청과 수령 관리 added
성양 Updated by 성용 양 14 days ago
- Follows Feature #1250: [MDGU-01-02] ERD·모델 계약 초안(앱 간 FK 규칙) added
Actions