Feature #1286
openFeature #1226: [MDGU] 학사관리 시스템 v1 개발 (8주, 2026-11-05 시작)
Feature #1227: [MDGU-10] 졸업·학위 (성용)
[MDGU-10-02] 졸업·수료 판정·학위명·학위번호·판정 근거 이력
0%
Description
목적¶
졸업요건 충족 여부를 확정 성적 기준으로 판정하고 졸업·수료, 졸업일, 학위명, 학위번호와 판정 근거를 보존합니다. (FR-GRAD-001~003)
쉬운 설명¶
학생이 졸업요건을 충족했는지 판정하고 학위명·학위번호를 부여하며 판정 근거를 이력으로 남깁니다.
기술 스택¶
Django 서비스 함수, 08-03 GPA·확정 성적 서비스 함수 호출, 07-02 학적 상태 변경 서비스 함수 호출, 02-05 감사 로그, pytest.
예상 결과(산출물)¶
evaluate_graduation(student), 판정 기록 모델(근거 스냅샷 포함), 판정·학위 정보 화면, 테스트.
개발 작업 상세¶
- 08-03의 확정 성적·GPA 함수를 호출해 요건(10-01)과 비교한다.
- 판정 결과와 근거(사용한 성적·학점 스냅샷)를 저장한다.
- 졸업·수료 판정 시 학적 상태 변경은 07-02 서비스 함수를 호출한다(students 코드를 직접 수정하지 않음).
- 학위명·학위번호 발급 규칙을 적용한다(번호 정책은 00-04 확인).
- 화면, 감사 로그, 테스트.
완료 기준¶
- 졸업 판정이 확정 성적 기준으로 계산되고 근거가 보존된다.
- 예외 승인(학칙 확인 필요)은 이력으로 남긴다.
충돌 방지(소유 범위)¶
graduation/ 소유.
선행·후행·위험¶
선행: 07-02 학적 상태·변동 이력(적용일·사유·처리자·전후값)(우섭, 12/04 종료) / 08-03 평균평점(GPA) 계산·확정 성적 기준(성용, 12/15 종료) / 08-04 성적 정정 이력·재수강·대체/인정 학점(성용, 12/17 종료) / 10-01 졸업요건 설정(학위과정별 필요 학점 등)(성용, 12/08 종료)
후행: 11-03 성적증명서·졸업·학위 관련 문서·발급 기록(서현)
위험: 08-03이 늦으면 일정이 밀림.
결과 확인 방법¶
"완료 기준"의 각 항목을 화면 또는 명령으로 직접 확인합니다.
- 졸업 판정이 확정 성적 기준으로 계산되고 근거가 보존된다.
- 예외 승인(학칙 확인 필요)은 이력으로 남긴다.
- pytest가 모두 통과한다.
- 확인 결과(화면 캡처 또는 명령 출력 요약)를 일감 메모에 남긴다.
갱신 사항 (2026-11-04)¶
- ERD 검수 반영: degree_number에 unique 제약을 둔다. 판정과 학위 수여의 참조 이름을 통일한다(graduation_review).
시작 전 준비¶
- 선행 일감의 결과물(문서·코드)을 먼저 읽고 약속된 이름·구조를 확인한다.
- 저장소를 최신으로 맞춘다: 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/1286-<짧은영문설명>
- "개발 작업 상세"의 번호 순서대로 한 단계씩 구현하고, 단계마다 pytest로 확인한다.
- 모델을 바꾸면 python manage.py makemigrations, 그다음 python manage.py migrate를 실행한다.
- 화면은 python manage.py runserver로 실행해 직접 열어 보고 "완료 기준"과 하나씩 대조한다.
- git add, git commit, git push 후 PR을 만든다. PR 템플릿의 체크리스트를 채우고 폴더 소유자의 리뷰를 받는다.
- 병합 후 이 일감 메모에 PR 링크와 확인 결과를 적고 상태와 진행률을 갱신한다.
막힐 때 확인¶
판정 근거(어떤 학점이 어떻게 계산됐는지)를 저장해야 나중에 재확인할 수 있습니다.
그래도 해결되지 않으면 일감 메모에 "무엇을 했고, 어떤 오류가 났는지"를 붙여 담당 분류 소유자 또는 팀장에게 질문하세요.
용어 풀이¶
- 감사 로그: 누가 언제 무엇을 했는지 남기는 변경 불가 기록입니다. 문제가 생겼을 때 추적하는 근거가 됩니다.
- pytest: Python 코드를 자동으로 검사해 주는 테스트 도구입니다. 테스트 파일은 tests/ 폴더에 둡니다.
- GPA(평균평점): 과목별 평점에 학점을 곱해 더한 뒤 총 학점으로 나눈 평균입니다.
- 서비스 함수: 다른 앱이 직접 DB를 건드리지 않고 이 함수를 통해서만 기능을 쓰게 만든 창구입니다.