Project

General

Profile

Files » REQUIREMENTS_V1 (1).md

MD Global University 학사관리 시스템 - 성용 양, 10/21/2026 06:49 AM

 

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만원
  • 유지보수: 지원 가능 범위에 따른 별도 협의; 무제한 무료 유지보수 또는 대응 시간 보장은 아님

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

(1-1/2)