# MD Global University 학사관리 시스템 — v1 상세 개발 요구사항

- 문서 상태: **초안 / 검토 필요**
- 대상: 대학 내부 교적·학사관리 담당자 약 3~4명
- 우선순위: **P0 = 출시 전 필수**, **P1 = v1 필수 업무 기능**, **v2 = 후속 검토**
- 범위 원칙: 본 문서는 현재까지 논의한 요구사항을 정리한 것으로 대학의 공식 학칙·증명서 서식·개인정보 처리방침을 대체하지 않는다.

## 1. 목표와 역할
**GOAL-001 [P1]** 지원·입학부터 졸업·증명서 발급까지 교적 데이터를 통합 관리한다.

**USR-001 [P0]** v1 로그인 사용자는 사전 등록·승인된 교적·학사 담당자 및 시스템 관리자에 한정한다.

**USR-002 [P0]** 관리자·담당자 등 역할별로 조회·등록·수정·삭제·출력·내보내기 권한을 구분하고 최소권한을 적용한다.

## 2. 업무 기능 요구사항

### 2.1 지원자 및 입학
- **FR-ADM-001 [P1]** 지원자 인적사항, 지원 학위과정·학과·전공, 지원 상태, 입학 판정 관리
- **FR-ADM-002 [P1]** 합격자 학생 전환 및 고유 학번 발급, 중복 발급 방지
- **FR-ADM-003 [P1]** 지원자 등록 절차를 거치지 않는 직접 입학 지원
- **FR-ADM-004 [P1]** 입학일·입학학기·입학유형 및 관련 첨부서류 관리

### 2.2 학생·학적
- **FR-STU-001 [P1]** 학생 기본정보 및 연락처·주소 등 개인정보 관리(보안 요구사항 적용)
- **FR-STU-002 [P1]** 재학, 휴학, 복학, 자퇴, 제적, 수료, 졸업 등 학적 상태 관리
- **FR-STU-003 [P1]** 학적 변동의 적용일, 사유, 처리자, 변경 전후 값 및 이력 기록
- **FR-STU-004 [P1]** 학생별 소속·학위과정·입학 및 졸업 정보 조회

### 2.3 학사 조직·학기
- **FR-ORG-001 [P1]** 단과대학, 학과, 전공, 학위과정 계층 구조 관리
- **FR-TERM-001 [P1]** 정규 학기와 별도로 개설하는 특별·사용자 정의 학기 지원
- **FR-TERM-002 [P1]** 학기별 시작·종료일 및 운영 상태 관리

### 2.4 교원·교과목·수강
- **FR-FAC-001 [P1]** 전임·비전임·겸임·시간강사 등 교원 구분 및 소속 없는 강사 등록
- **FR-FAC-002 [P1]** 학생별 지도교수 지정
- **FR-CRS-001 [P1]** 교과목 코드·명칭·학점·개설 단위 관리
- **FR-CRS-002 [P1]** 학기별 강좌/분반·담당교원 관리
- **FR-ENR-001 [P1]** 관리자가 학생의 수강 등록·변경·취소 및 이수 여부 처리

### 2.5 성적·학점
- **FR-GRD-001 [P1]** 수강 내역별 성적, 평점, 취득 학점 및 평균평점 관리
- **FR-GRD-002 [P1]** 성적 정정 사유와 이력 보존
- **FR-GRD-003 [P1]** 재수강 및 대체/인정 학점 처리
- **FR-GRD-004 [P1]** 성적표와 졸업요건 검토에 동일한 확정 성적 기준 사용
- **확인 필요:** 성적 등급표, GPA 계산 규칙, 재수강 성적 반영 규칙, 인정학점 제한

### 2.6 등록금·납부
- **FR-TUI-001 [P1]** 학기별 등록금 부과 및 납부 상태 관리
- **FR-TUI-002 [P1]** 장학금, 감면, 환불, 분할 납부 내역 관리
- **FR-TUI-003 [P1]** 원화(KRW) 또는 중국 위안화(CNY)로 금액·통화 명시
- **FR-TUI-004 [P1]** 납부·조정 처리 이력 관리
- **제외:** 온라인 결제, 회계 장부/전표 등 본격 회계 기능
- **확인 필요:** 복수 통화 간 환산 및 환율 적용 정책

### 2.7 졸업·학위
- **FR-GRAD-001 [P1]** 학위과정별 졸업요건(필요 학점 등) 설정 및 충족 여부 확인
- **FR-GRAD-002 [P1]** 졸업/수료 판정, 졸업일, 학위명 및 학위번호 관리
- **FR-GRAD-003 [P1]** 졸업 판정 근거 및 처리 이력 보존
- **확인 필요:** 과정별 학칙, 졸업요건, 예외 승인 규정

### 2.8 증명서·출력
- **FR-DOC-001 [P1]** 재학·휴학·수료·졸업 증명서, 성적증명서, 학위 관련 문서 출력
- **FR-DOC-002 [P1]** 한국어·영어·중국어(간체) 서식 지원
- **FR-DOC-003 [P1]** PDF 생성 및 인쇄 지원
- **FR-DOC-004 [P1]** 발급 기록(문서 종류, 대상 내부 식별자, 발급자, 시각) 관리
- **확인 필요:** 대학 공식 서식, 직인/서명, 번역 명칭, 발급번호 정책

### 2.9 첨부·검색·이관·운영
- **FR-FILE-001 [P1]** 지원자·학생 관련 증빙파일 업로드, 접근통제, 다운로드 이력
- **FR-EXCEL-001 [P1]** 승인된 항목의 Excel 가져오기·내보내기, 오류 행 검증
- **FR-MIG-001 [P1]** 기존 자료의 초기 이관, 중복·누락·정합성 검증 및 이관 결과 보고
- **FR-SEARCH-001 [P1]** 학생·학적·수강·성적·납부 현황 검색 및 업무 대시보드
- **FR-OPS-001 [P1]** 계정·코드·기본 설정 및 업무 처리 감사 로그

## 3. 보안 및 개인정보 보호 (최우선)

### 3.1 데이터 유출 시 개인 식별 위험 최소화
**NFR-SEC-001 [P0]** 데이터베이스 또는 백업 일부가 유출되어도 해당 데이터만으로 특정 학생·교원·지원자를 식별하기 어렵도록 **개인정보 분리, 가명처리, 암호화, 최소 수집**을 기본 설계 원칙으로 한다.

**NFR-SEC-002 [P0]** 학사 업무 데이터는 이름·연락처·주민/여권번호 등 직접 식별정보 대신 무작위 내부 식별자를 참조한다. 학번은 대외적으로 사용되거나 다른 데이터와 결합해 식별될 수 있으므로 보안상 가명 식별자와 구분한다.

**NFR-SEC-003 [P0]** 직접 식별정보와 학사정보는 별도 스키마/저장 영역 및 별도 접근권한으로 분리한다. **물리적 DB 또는 별도 서비스 분리 여부는 위협모델 검토 후 확정**한다.

**NFR-SEC-004 [P0]** 개인정보 및 민감한 첨부문서는 저장 시 강력한 암호화를 적용하고, 암호화 키는 데이터베이스·백업과 분리하여 관리한다. 전송 시 TLS를 사용한다.

**NFR-SEC-005 [P0]** 복호화는 인가된 업무 기능과 최소권한 사용자에게만 허용하며, 열람·내보내기·복호화 행위를 감사한다.

**NFR-SEC-006 [P0]** 로그, 오류 보고, 캐시, 임시파일, Excel 내보내기 및 백업에 평문 개인정보가 불필요하게 남지 않도록 보호한다.

**NFR-SEC-007 [P0]** 백업 암호화, 접근 제한, 복원 테스트, 키 분실 대응 및 키 교체 절차를 정의한다.

**NFR-SEC-008 [P0]** 개인정보 수집 항목·보존 기간·파기 및 권리 요청 처리는 적용 법령과 대학 정책에 따라 확정한다.

**NFR-SEC-009 [P0]** 개발·테스트 환경에서는 원칙적으로 합성/비식별 데이터를 사용하며 운영 개인정보의 무단 복제를 금지한다.

**NFR-SEC-010 [P0]** SQL Injection, XSS, CSRF, 파일 업로드 악용, 권한 우회, 대량 추출에 대한 방어와 보안 테스트를 수행한다.

> **보안 한계:** DB, 암호화 키, 애플리케이션 및 권한이 동시에 침해되거나 외부 자료와 결합되는 경우 완전한 비식별성을 보장할 수 없다. 목표는 식별 위험과 피해를 실질적으로 낮추는 것이다. 개인정보와 학사정보의 연결 기능은 정상적인 교적 업무에 필요하므로 권한 통제된 연결 매핑을 별도로 보호한다.

### 3.2 로그인 및 계정
- **FR-AUTH-001 [P0]** 아이디/비밀번호 기반 일반 로그인 지원. 비밀번호는 복호화 가능한 형태로 저장하지 않고 안전한 해시 알고리즘 사용
- **FR-AUTH-002 [P1]** 카카오 계정 로그인(OAuth 2.0 / 제공 기능 범위 내 OIDC) 지원
- **FR-AUTH-003 [P1]** Google 계정 로그인(OIDC; Gmail 계정 포함) 지원
- **FR-AUTH-004 [P0]** 모든 로그인 수단은 **사전 승인된 내부 계정에만 연결**한다. 소셜 로그인 성공만으로 자동 직원 계정을 생성하거나 권한을 부여하지 않는다
- **FR-AUTH-005 [P0]** 외부 계정 연결·해제 시 재인증과 관리자 승인 등 계정 탈취 방지 절차 적용
- **FR-AUTH-006 [P0]** 로그인 실패 횟수 제한, 세션 만료, 로그아웃, 계정 잠금/비활성화 및 로그인 이력 기록
- **FR-AUTH-007 [P0]** 소셜 계정 식별은 검증된 제공자 고유 식별자 기반으로 하며 이메일 문자열만으로 기존 직원 계정과 자동 연결하지 않는다
- **FR-AUTH-008 [v2]** TOTP 기반 OTP 2차 인증. **v1 구현 범위에서 제외**하되 향후 추가 가능한 구조 고려

## 4. 비기능 요구사항
- **NFR-OPS-001 [P0]** HTTPS 강제, 비밀값 환경변수/보안 저장소 관리, 운영 서버 접근 최소화
- **NFR-OPS-002 [P1]** 소수 직원이 사용하는 반응형 관리자 UI, 입력값 검증 및 오류 메시지 제공
- **NFR-OPS-003 [P0]** 감사 로그의 위변조 위험을 줄이고 변경자·시간·대상·행위 기록
- **NFR-OPS-004 [P1]** 정기 백업, 장애 복구 및 배포/롤백 절차 마련
- **NFR-OPS-005 [P1]** 한국어/영어/중국어(간체) 증명서 글꼴·인쇄 결과 검증
- **NFR-OPS-006 [P1]** 초기 데이터 이관 전후 건수·참조무결성·핵심 업무 시나리오 검증

## 5. 권장 구현 기술
- Backend: Python + Django
- UI: Django Templates + Bootstrap 5
- DB: PostgreSQL
- 인증: Django Auth + 검증된 Kakao/Google OAuth/OIDC 라이브러리
- 배포: Linux VPS + Gunicorn + Nginx + HTTPS
- 문서: PDF 출력, Excel 입출력 라이브러리(세부 선정은 설계 단계)
- 저장/보안: 보호된 파일 저장소, 별도 키 관리 방안, 암호화 백업

## 6. v1 제외 범위
- 학생·교수 로그인/포털, LMS
- 학생 직접 온라인 수강신청, 온라인 입학지원
- 온라인 결제, 회계 시스템
- 모바일 전용 앱, 전자결재
- 외부 시스템 연동, 온라인 증명서 진위확인
- OTP 기반 2차 인증

## 7. 개발 단계 및 검수 기준(제안)
| 단계 | 주요 작업 | 결과물/검수 |
| --- | --- | --- |
| 1주차 | 요구사항 확정, 업무 규칙/서식 확인, 위협모델·ERD·권한 설계 | 요구사항 승인본, ERD, 개인정보 흐름도 |
| 2주차 | 개발환경·인증·조직/학기·지원/입학 기반 | 직원 로그인 및 기본 등록 시나리오 |
| 3주차 | 학생·학적·교원/지도교수 | 학적 변동 이력과 접근권한 검증 |
| 4주차 | 교과목·분반·수강·성적 | 성적/GPA 테스트 케이스 |
| 5주차 | 등록금·장학·환불·졸업요건 | 납부/졸업 판정 테스트 |
| 6주차 | 3개 언어 증명서·첨부·Excel | 샘플 증명서 PDF 및 이관 리허설 |
| 7주차 | 통합 테스트·보안 테스트·초기 데이터 이관 | 취약점 점검, 정합성 보고서 |
| 8주차 | 담당자 UAT·배포·교육·안정화 | 인수 체크리스트, 운영/복구 매뉴얼 |

**일정 위험:** 8주는 병렬 개발, 초기 요구사항 동결, 대학의 서식·규정·이관 데이터 조기 제공을 전제로 한 도전적 목표다. P0 보안 검증에 실패하면 일정 단축보다 출시 연기를 우선한다.

### 필수 인수 테스트 예시
1. 승인되지 않은 카카오/Google 계정으로 로그인할 수 없어야 한다.
2. 일반 로그인·카카오·Google 계정이 하나의 승인된 직원 계정에 안전하게 연결되어야 한다.
3. 학사 데이터 테이블만 추출해도 이름·연락처 등 직접 식별정보가 포함되지 않아야 한다.
4. 암호화된 개인정보 저장소/백업만 탈취한 상황에서 별도 키 없이 평문 복원이 불가능해야 한다.
5. 권한 없는 직원은 개인정보 복호화·일괄 내보내기·증명서 출력이 차단되어야 한다.
6. 성적 정정, 학적 변경, 납부 수정은 감사 이력으로 추적 가능해야 한다.
7. 국문·영문·중문(간체) 증명서의 이름/학위/날짜/학점 표기가 검증되어야 한다.
8. 백업 복원과 초기 데이터 이관 정합성 검증을 통과해야 한다.

## 8. 추후 대학 측 확인 사항
1. 정식 대학·학과·학위 명칭 및 조직 구조
2. 학칙: 학기·학점·성적/GPA·재수강·졸업 기준
3. 공식 증명서 3개 언어 서식 및 직인/서명
4. 등록금/장학/환불/분납·KRW/CNY 환율 정책
5. 기존 데이터 형태, 파일 규모, 첨부서류 종류
6. 개인정보 처리 근거, 보존 기간, 삭제·파기 정책
7. 운영 서버 지역/관리 주체, 키 관리 및 백업 책임
8. 카카오/Google OAuth 앱 등록 및 승인 담당자
9. 8주 내 우선 제공할 기능과 검수 책임자

## 9. 개발·비용 참고 (기존 논의안)
- 직접 개발 제안: 문길래 PM(인건비 제외), 개발자 3명 × 월 100만원 × 2개월 = 개발 인건비 600만원
- 연간 운영 인프라 추정: 약 100만원(실제 서비스 견적 확인 필요)
- 일반 비교안: 개발 약 5개월, 개발·구축비 약 4,000만원
- 유지보수: 지원 가능 범위에 따른 별도 협의; 무제한 무료 유지보수 또는 대응 시간 보장은 아님

---
변경 관리: 요구사항 확정 이후 신규 기능·업무 규칙 변경은 별도 변경 이력과 영향도 검토를 거친다.
