Feature #1606
openFeature #1226: [MDGU] 학사관리 시스템 v1 개발 (8주, 2026-11-05 시작)
Feature #1601: g-dts 자료 조사 및 요구사항 정리
[자료] 기존 데이터 형태·건수·첨부 종류(샘플 구조만)
90%
Description
길문 Updated by 길래 문 6 days ago
- Assignee set to 우섭 심
- % Done changed from 0 to 90
[PM 결정] #1606 기존 데이터 조사 및 데이터 이관 개발 기준¶
결정일: 2026-11-12
결정: 합성 데이터 기반 이관 기능 개발 승인 / 실제 데이터 이관은 고객 자료 확인 후 진행
1. 결정 배경¶
현재 대학의 기존 학사 자료 보관 형태, 데이터 건수, 첨부서류 구조는 공식적으로 확인되지 않았습니다.
다만 자료 수령 지연으로 개발을 중단할 필요는 없으므로, 일반적인 대학 학사관리 데이터를 기준으로 합성 데이터를 생성하여 이관 기능을 먼저 구현합니다.
실제 고객 데이터의 구조와 건수는 확정된 것으로 간주하지 않습니다.
2. 초기 개발 대상 데이터¶
다음 자료를 개발용 이관 대상으로 설정합니다.
| 구분 | 개발용 데이터 항목 |
|---|---|
| 학생 기본정보 | 학생번호, 성명, 소속, 학위과정, 입학일 |
| 학적정보 | 재학·휴학·복학·수료·졸업 상태 및 변경 이력 |
| 수강정보 | 학기, 과목, 수강신청, 이수학점 |
| 성적정보 | 과목별 등급, 평점, GPA |
| 등록금정보 | 학기별 부과 항목, 금액, 감면 |
| 납부정보 | 납부일, 금액, 통화, 납부 상태 |
| 첨부서류 | 서류 종류, 파일명, 파일 형식, 파일 크기 |
위 항목은 개발용 예시이며 실제 대학 자료 구조와 다를 수 있습니다.
3. 데이터 형식 및 합성 데이터¶
다음 형식을 우선 지원합니다.
- Excel(.xlsx)
- CSV(.csv)
- 첨부서류: PDF, JPG, PNG
- 기타 파일 형식은 고객 자료 확인 후 추가
초기 테스트는 100건, 500건, 1,000건의 합성 학생 데이터로 진행합니다.
성적·수강·납부·첨부 데이터는 학생 및 학위과정과 연결된 관계형 합성 데이터로 생성합니다.
실제 개인정보는 사용하지 않습니다.
4. 관리자 매핑 관리¶
앞서 확정한 공통 관리자 관리 원칙을 적용합니다.
관리자는 다음 항목을 직접 관리할 수 있어야 합니다.
- 기존 데이터 열과 신규 시스템 필드 매핑 추가
- 기존 매핑 수정
- 매핑 사용 중지 및 재활성화
- 필수값·기본값·변환 규칙 설정
- 매핑 버전 및 변경 이력 조회
예시:
- 기존
학생번호→ 신규student_number - 기존
학과명→ 신규 학과 코드 참조 - 기존
납부금액→ 신규 납부 금액 필드
실제 매핑 대상 필드명은 기존 구현의 모델 및 스키마를 확인하여 사용합니다.
새로운 열이 발견될 때마다 소스코드를 수정하지 않도록, 가능한 범위에서 설정 기반 매핑을 지원합니다.
5. 이관 검증¶
다음 항목을 검증합니다.
- 필수값 누락
- 학생번호 등 식별값 중복
- 날짜 및 숫자 형식 오류
- 학과·학위과정 참조 관계
- 성적·수강·납부 데이터 연결 관계
- 첨부파일 형식 및 크기
- 전체 행 수와 성공·실패 건수
- 중복 이관 방지
- 실패 행별 오류 사유
이관 전 미리보기와 검증 결과를 제공하고, 오류 데이터를 수정한 후 재검증할 수 있도록 합니다.
실제 데이터 반영은 검증 및 승인 절차를 거쳐 진행합니다.
6. 운영 서버 및 실제 데이터 정책¶
확정된 운영 서버에서 합성 데이터 기반 이관 테스트를 진행할 수 있습니다.
단, 다음 조건을 준수합니다.
- 합성 데이터와 실제 운영 데이터 구분
- 실제 개인정보 사용 금지
- 테스트 데이터 정리 및 재생성 가능
- 기존 운영 데이터 덮어쓰기 금지
- 실제 데이터 이관 전 백업 및 복구 절차 확인
- 실제 이관은 고객 자료 수령·매핑 검증·PM 승인 후 진행
7. 고객 자료 수령 후 처리¶
고객으로부터 다음 정보를 확보하면 실제 이관 계획에 반영합니다.
- 기존 자료 보관 형태
- 학생·성적·납부 등 자료별 대략적인 건수
- Excel·CSV 등 샘플 열 구조
- 첨부서류 종류 및 평균·최대 용량
- 기존 코드 체계 및 데이터 관계
실제 개인정보가 포함된 원본 자료는 별도의 안전한 전달 및 보관 절차를 통해 취급합니다.
8. 담당자 요청¶
우섭님은 위 결정사항을 데이터 이관 담당 서현님에게 공유해 주세요.
기존 데이터 모델과 구현 기능을 우선 확인하고, 필요한 기능만 추가하도록 합니다.
특히 다음 결과를 보고해 주세요.
- 기존 구현 재사용 가능 범위
- 합성 데이터 및 샘플 파일 구조
- 이관 매핑표 초안
- 데이터 검증 결과
- 추가 구현이 필요한 기능
- 고객에게 추가로 요청할 자료
최종 결정: 합성 데이터 기반 이관 기능 개발을 승인합니다. 실제 데이터 구조와 건수는 고객 자료 수령 후 확정하고, 실제 이관은 별도 검증 및 승인 후 진행합니다.