Feature #1285
openFeature #1226: [MDGU] 학사관리 시스템 v1 개발 (8주, 2026-11-05 시작)
Feature #1227: [MDGU-10] 졸업·학위 (성용)
[MDGU-10-01] 졸업요건 설정(학위과정별 필요 학점 등)
70%
Description
목적¶
학위과정별 졸업요건을 설정 데이터로 관리하고, 충족 여부 확인의 기반을 만듭니다. (FR-GRAD-001)
쉬운 설명¶
학위과정별 졸업요건(필요 학점 등)을 설정 데이터로 관리하는 기능입니다. 10-02 졸업 판정의 기반입니다.
기술 스택¶
Django 모델(규칙 테이블), 업무 화면, 서비스 함수, pytest.
예상 결과(산출물)¶
graduation 앱의 Requirement 모델(학위과정별 필요 학점·필수 과목 등), 설정 화면, 테스트.
개발 작업 상세¶
- Requirement 모델: 학위과정(05-01), 필요 총 학점, 필수 과목 목록, 최소 평점 등(항목은 00-04 학칙 수령 후 조정).
- 설정·조회 화면과 권한 적용.
- 충족 여부 계산 인터페이스(함수 시그니처)를 먼저 정의한다. 실제 계산은 10-02에서 구현.
- 합성 데이터로 시드 명령을 만든다.
완료 기준¶
- 학위과정별 졸업요건을 등록·수정할 수 있다.
충돌 방지(소유 범위)¶
graduation/ 앱은 성용 소유.
선행·후행·위험¶
선행: 05-01 조직 구조(단과대학·학과·전공·학위과정) 모델·관리 화면(우섭, 11/13 종료) / 05-04 교과목·학기별 강좌(분반)·담당교원(우섭, 11/23 종료)
후행: 10-02 졸업·수료 판정·학위명·학위번호·판정 근거 이력(성용)
위험: 학칙·졸업 기준 미수령.
결과 확인 방법¶
"완료 기준"의 각 항목을 화면 또는 명령으로 직접 확인합니다.
- 학위과정별 졸업요건을 등록·수정할 수 있다.
- pytest가 모두 통과한다.
- 확인 결과(화면 캡처 또는 명령 출력 요약)를 일감 메모에 남긴다.
갱신 사항 (2026-11-04)¶
- ERD 검수 반영: 졸업 판정 테이블 이름을 graduation_review로 통일하고, 판정은 적용 시점의 요건 version을 참조한다. 졸업 예외 승인 규정은 확정 전까지 exception_note 한 필드로 둔다.
시작 전 준비¶
- 선행 일감의 결과물(문서·코드)을 먼저 읽고 약속된 이름·구조를 확인한다.
- 저장소를 최신으로 맞춘다: git switch main 후 git pull --ff-only origin main
- 저장소 README 8번과 팀 로컬 세팅 안내 순서대로 환경을 준비한다. 보통 py -3.12 -m venv .venv, 가상환경 켜기, python -m pip install -r requirements-dev.txt, Windows에 설치한 PostgreSQL 18에서 개인 로컬 DB(university_dev) 생성, .env.local 설정(DB_NAME, DB_USER, DB_PASSWORD, DB_HOST, DB_PORT), python manage.py check, python manage.py migrate 순서이다. 최초 실행에 makemigrations는 필요 없고, .env.local과 비밀번호는 공유·커밋하지 않는다.
- #1226의 폴더 소유 표에서 내가 고칠 수 있는 폴더를 확인한다.
작업 진행 순서¶
- 브랜치를 만든다: git switch -c feature/1285-<짧은영문설명>
- "개발 작업 상세"의 번호 순서대로 한 단계씩 구현하고, 단계마다 pytest로 확인한다.
- 모델을 바꾸면 python manage.py makemigrations, 그다음 python manage.py migrate를 실행한다.
- 화면은 python manage.py runserver로 실행해 직접 열어 보고 "완료 기준"과 하나씩 대조한다.
- git add, git commit, git push 후 PR을 만든다. PR 템플릿의 체크리스트를 채우고 폴더 소유자의 리뷰를 받는다.
- 병합 후 이 일감 메모에 PR 링크와 확인 결과를 적고 상태와 진행률을 갱신한다.
막힐 때 확인¶
졸업 기준은 대학 자료(00-04)가 필요합니다. 임시 값은 가정으로 표시하세요.
그래도 해결되지 않으면 일감 메모에 "무엇을 했고, 어떤 오류가 났는지"를 붙여 담당 분류 소유자 또는 팀장에게 질문하세요.
용어 풀이¶
- pytest: Python 코드를 자동으로 검사해 주는 테스트 도구입니다. 테스트 파일은 tests/ 폴더에 둡니다.
- 합성 데이터: 실제 개인정보가 아닌, 시험용으로 만든 가짜 데이터입니다.
- 서비스 함수: 다른 앱이 직접 DB를 건드리지 않고 이 함수를 통해서만 기능을 쓰게 만든 창구입니다.
성양 Updated by 성용 양 19 days ago
- Due date changed from 12/03/2026 to 11/13/2026
- Start date changed from 11/30/2026 to 11/10/2026
- Follows Feature #1269: [MDGU-05-01] 조직 구조(단과대학·학과·전공·학위과정) 모델·관리 화면 added
성양 Updated by 성용 양 19 days ago
- Precedes Feature #1286: [MDGU-10-02] 졸업·수료 판정·학위명·학위번호·판정 근거 이력 added
성양 Updated by 성용 양 14 days ago
- Due date changed from 12/08/2026 to 11/27/2026
- Start date changed from 12/03/2026 to 11/24/2026
- Follows Feature #1272: [MDGU-05-04] 교과목·학기별 강좌(분반)·담당교원 added
성양 Updated by 성용 양 7 days ago
- Status changed from New to In Progress
- % Done changed from 0 to 30
[성용] 진행 상태 정리 (2026-11-11)
[반영된 것] PR #20 병합(main 987000a)
graduation.calculation.evaluate_graduation: 총 학점·이수 구분별 학점·최저 GPA·필수 과목·미확정 성적을 항목별로 판정하는 순수 함수와 근거 JSON. (10-02 #1286 판정 서비스가 그대로 사용)
[남은 것]
- GraduationRule(학위과정별 요건) 모델과 설정 화면. 선행 05-01(#1269)이 병합되어 이제 착수 가능.
- 실제 학점 기준·필수 과목·최저 GPA는 00-04 대학 자료 수령 후.
성양 Updated by 성용 양 6 days ago
- % Done changed from 30 to 70
[성용] 진행 기록 (2026-11-11)
[한 일]
- PR #37 병합(https://github.com/GilbertMoon/university-academic-system/pull/37):
GraduationRule졸업요건 버전 모델·migration 0001. 과정 내 버전 유일, 입학연도·적용 기간 순서, 음수 학점·GPA 거부, 승인·폐지 기록 필수(DB CHECK), 승인·폐지 버전 수정·삭제 금지, 기존 판정 함수 입력 변환 - PR #39 병합(https://github.com/GilbertMoon/university-academic-system/pull/39): 승인·폐지 서비스(
graduation.approve_graduationrule권한·사유 필수, advisory lock으로 동시 승인 직렬화, 같은 과정에서 입학연도·기간이 겹치는 승인 거부), 적용 규정 조회get_effective_graduation_rule(기본은 대학 승인 버전만). migration 0002(권한만). 우섭 리뷰 승인 - PR #40 병합(https://github.com/GilbertMoon/university-academic-system/pull/40): 시스템 관리자 전용 Django Admin에서 초안 입력·수정, 사유를 받는 승인·폐지 화면. 승인·폐지 버전 읽기 전용, 단건·일괄 삭제 차단, 저장 직전 행 잠금. 우섭 리뷰 승인
- 각 PR CI 통과, 로컬 PostgreSQL 18 전체 pytest 통과
[남은 것]
성양 Updated by 성용 양 5 days ago
[성용] 진행 기록 (2026-11-12)
[한 일]
- PR #47 병합(main 6473221): https://github.com/GilbertMoon/university-academic-system/pull/47
- 졸업요건 승인 화면에서 확인한 내용과 다른 초안이 승인되지 않게 보완(내용 지문 비교). 이수 구분 이름이 "items"일 때 화면 오류가 나던 문제 수정
- PR #51로 졸업요건 승인·폐지가 감사 로그에 같은 트랜잭션으로 기록됨
[남은 것]
- 대학 확정 졸업요건 자료 반영. 진척도는 그대로(70%)