Actions
Feature #1274
open
성양
예김
Feature #1226: [MDGU] 학사관리 시스템 v1 개발 (8주, 2026-11-05 시작)
Feature #1239: [MDGU-06] 지원·입학 (김예주)
[MDGU-06-02] 합격자 학생 전환·학번 발급(중복 방지)
Feature #1274:
[MDGU-06-02] 합격자 학생 전환·학번 발급(중복 방지)
Start date:
12/01/2026
Due date:
12/03/2026 (Due in 16 days)
% Done:
0%
Estimated time:
Description
목적¶
합격자를 학생으로 전환하고 고유 학번을 발급하며 중복 발급을 막습니다. 학번은 비식별 키가 아니라 별도 필드로 둡니다. (FR-ADM-002)
쉬운 설명¶
합격한 지원자를 학생 레코드로 전환하고 학번을 부여하는 기능입니다. 한 번 부여한 학번은 바뀌면 안 됩니다.
기술 스택¶
Django 트랜잭션·select_for_update 또는 DB 제약, students 앱의 서비스 함수, pytest.
예상 결과(산출물)¶
전환 서비스 함수 convert_applicant_to_student, 학번 발급 규칙, 동시성 테스트.
개발 작업 상세¶
- 학번 규칙(형식)을 00-04 입력 또는 가정으로 정한다.
- DB 고유 제약과 트랜잭션으로 중복 발급을 막는다.
- 학생 생성은 07-01의 서비스 함수를 호출한다(students 앱 코드를 직접 수정하지 않음).
- 전환 이력을 감사 로그에 남긴다.
- 동시 전환 테스트(같은 학번 중복 불가).
완료 기준¶
- 합격자 전환 시 학생이 만들어지고 학번이 중복되지 않는다.
충돌 방지(소유 범위)¶
admissions/ 안에서 작업. students 모델에는 07-01에서 제공하는 서비스 함수만 호출합니다.
선행·후행·위험¶
선행: 06-01 지원자 모델·지원 상태·입학 판정(김예주, 11/30 종료) / 07-01 학생 기본 모델·개인정보 참조·조회 화면(우섭, 11/27 종료)
후행: 06-03 직접 입학·입학 정보·첨부 연결(김예주)
위험: 07-01이 11/27 넘으면 이 일감이 밀림.
결과 확인 방법¶
"완료 기준"의 각 항목을 화면 또는 명령으로 직접 확인합니다.
- 합격자 전환 시 학생이 만들어지고 학번이 중복되지 않는다.
- pytest가 모두 통과한다.
- 확인 결과(화면 캡처 또는 명령 출력 요약)를 일감 메모에 남긴다.
갱신 사항 (2026-11-04)¶
- 확정: 전환 시 지원자와 같은 PersonRef를 재사용하고 student.applicant_id(nullable, unique)로 연결한다. 직접 입학은 applicant_id가 비어 있다.
- 학번 발급은 트랜잭션 안에서 select_for_update로 직렬화하고 student_number에 DB unique 제약을 둔다. 학번 형식은 대학 확인 필요.
시작 전 준비¶
- 선행 일감의 결과물(문서·코드)을 먼저 읽고 약속된 이름·구조를 확인한다.
- 저장소를 최신으로 맞춘다: 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/1274-<짧은영문설명>
- "개발 작업 상세"의 번호 순서대로 한 단계씩 구현하고, 단계마다 pytest로 확인한다.
- 모델을 바꾸면 python manage.py makemigrations, 그다음 python manage.py migrate를 실행한다.
- 화면은 python manage.py runserver로 실행해 직접 열어 보고 "완료 기준"과 하나씩 대조한다.
- git add, git commit, git push 후 PR을 만든다. PR 템플릿의 체크리스트를 채우고 폴더 소유자의 리뷰를 받는다.
- 병합 후 이 일감 메모에 PR 링크와 확인 결과를 적고 상태와 진행률을 갱신한다.
막힐 때 확인¶
학번 규칙이 불명확하면 00-04로 확인하고, 동시에 두 명이 전환해도 중복되지 않도록 DB 제약을 사용하세요.
그래도 해결되지 않으면 일감 메모에 "무엇을 했고, 어떤 오류가 났는지"를 붙여 담당 분류 소유자 또는 팀장에게 질문하세요.
용어 풀이¶
- 감사 로그: 누가 언제 무엇을 했는지 남기는 변경 불가 기록입니다. 문제가 생겼을 때 추적하는 근거가 됩니다.
- pytest: Python 코드를 자동으로 검사해 주는 테스트 도구입니다. 테스트 파일은 tests/ 폴더에 둡니다.
- 트랜잭션: 여러 DB 작업을 "전부 성공하거나 전부 취소"로 묶는 기능입니다.
- 서비스 함수: 다른 앱이 직접 DB를 건드리지 않고 이 함수를 통해서만 기능을 쓰게 만든 창구입니다.
성양 Updated by 성용 양 19 days ago
- Due date changed from 11/25/2026 to 11/18/2026
- Start date changed from 11/23/2026 to 11/16/2026
- Follows Feature #1276: [MDGU-07-01] 학생 기본 모델·개인정보 참조·조회 화면 added
성양 Updated by 성용 양 19 days ago
- Follows Feature #1273: [MDGU-06-01] 지원자 모델·지원 상태·입학 판정 added
성양 Updated by 성용 양 19 days ago
- Precedes Feature #1275: [MDGU-06-03] 직접 입학·입학 정보·첨부 연결 added
Actions