Project

General

Profile

Feature #1296

Updated by 성용 양 14 days ago

## 목적 

 기존 자료를 새 시스템에 옮기는 스크립트를 만들고 합성 데이터로 반복 실행해 안전하게 검증합니다. 

 ## 쉬운 설명 

 매핑표대로 데이터를 변환해 넣는 이관 스크립트를 만듭니다. 연습용 합성(가짜) 데이터로만 시험합니다. 

 ## 기술 스택 

 Django management command, 각 앱의 서비스 함수(직접 SQL 대신), pytest, 합성 데이터 생성. 

 ## 예상 결과(산출물) 

 `import_legacy` 관리 명령, 건수·무결성 보고 출력, 합성 데이터 샘플, 테스트. 

 ## 개발 작업 상세 

 1. 각 앱이 제공하는 생성 서비스 함수를 호출하는 방식으로 이관한다(다른 앱 모델 직접 저장 금지). 
 2. 개인정보는 security 서비스 함수로 저장하고 첨부는 12-01 서비스를 사용한다. 
 3. 드라이런 모드(저장 없이 검증만)와 실제 실행 모드를 분리한다. 
 4. 결과 보고(이관 건수, 실패 행, 중복)를 출력한다. 

 ## 완료 기준 

 - 합성 데이터로 드라이런·실행이 성공하고 보고가 출력된다. 

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

 legacy_migration/ 소유. 

 ## 선행·후행·위험 

 선행: 07-01 학생 기본 모델·개인정보 참조·조회 화면(우섭, 11/27 종료) / 12-01 증빙 파일 업로드·암호화 저장·접근통제·다운로드 이력(김예주, 12/18 종료) / 12-02 Excel 가져오기·내보내기(오류 행 검증)(김예주, 12/23 종료) / 14-01 기존 자료 인벤토리·이관 매핑표·검증 기준(서현, 11/25 종료) 

 14-01, 12-01, 12-02, 07-01. 후행: 14-03 이관 리허설·정합성 보고서(서현) 

 ## 결과 확인 방법 

 합성 데이터로 스크립트를 실행하면 건수가 일치하고 오류 행이 따로 보고되며 여러 번 실행해도 중복되지 않으면 완료입니다. 

 ## 시작 전 준비 

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

 ## 작업 진행 순서 

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

 ## 막힐 때 확인 

 이관 순서는 의존 관계(조직→학생→수강→성적)를 따릅니다. 

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

 ## 용어 풀이 

 - **pytest**: Python 코드를 자동으로 검사해 주는 테스트 도구입니다. 테스트 파일은 tests/ 폴더에 둡니다. 
 - **합성 데이터**: 실제 개인정보가 아닌, 시험용으로 만든 가짜 데이터입니다. 
 - **이관·매핑표**: 기존 자료를 새 시스템으로 옮기는 일이 이관이고, 기존 항목이 새 항목의 무엇에 해당하는지 짝지은 표가 매핑표입니다. 
 - **서비스 함수**: 다른 앱이 직접 DB를 건드리지 않고 이 함수를 통해서만 기능을 쓰게 만든 창구입니다. 14-03.

Back