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