Feature #1296
Updated by 성용 양 13 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-03 이관 리허설·정합성 보고서(서현)
## 결과 확인 방법
"완료 기준"의 각 항목을 화면 또는 명령으로 직접 확인합니다.
1. 합성 데이터로 드라이런·실행이 성공하고 보고가 출력된다.
2. pytest가 모두 통과한다.
3. 확인 결과(화면 캡처 또는 명령 출력 요약)를 일감 메모에 남긴다.
## 갱신 사항 (2026-11-04)
- ERD 검수 반영: legacy_id_map에 이관 대응 관계를 기록한다. 리허설은 합성 데이터로만 한다.
## 시작 전 준비
1. 00-04의 자료 수령 상태와 05·07·08의 모델 정의를 확인한다.
2. 실제 개인정보 파일은 저장소에 올리지 않는다. 연습은 합성 데이터로만 한다.
3. 저장소 최신화 후 README 순서대로 환경을 준비한다.
## 작업 진행 순서
1. "개발 작업 상세" 순서대로 진행하되 항상 합성 데이터와 별도 환경에서 시험한다.
2. 스크립트는 같은 데이터를 여러 번 실행해도 중복되지 않게 만든다.
3. 결과 건수와 오류 행을 보고서 형식으로 기록한다.
4. PR로 올려 소유자 리뷰를 받는다.
## 막힐 때 확인
이관 순서는 의존 관계(조직→학생→수강→성적)를 따릅니다.
그래도 해결되지 않으면 일감 메모에 "무엇을 했고, 어떤 오류가 났는지"를 붙여 담당 분류 소유자 또는 팀장에게 질문하세요.
## 용어 풀이
- **pytest**: Python 코드를 자동으로 검사해 주는 테스트 도구입니다. 테스트 파일은 tests/ 폴더에 둡니다.
- **합성 데이터**: 실제 개인정보가 아닌, 시험용으로 만든 가짜 데이터입니다.
- **이관·매핑표**: 기존 자료를 새 시스템으로 옮기는 일이 이관이고, 기존 항목이 새 항목의 무엇에 해당하는지 짝지은 표가 매핑표입니다.
- **서비스 함수**: 다른 앱이 직접 DB를 건드리지 않고 이 함수를 통해서만 기능을 쓰게 만든 창구입니다.
Back