Feature #1276
openFeature #1226: [MDGU] 학사관리 시스템 v1 개발 (8주, 2026-11-05 시작)
Feature #1240: [MDGU-07] 학생·학적 (우섭)
[MDGU-07-01] 학생 기본 모델·개인정보 참조·조회 화면
0%
Description
목적¶
학생 기본정보를 만들되 이름·연락처·주소는 개인정보 영역(PersonRef)에 두고, 학사 데이터는 무작위 내부 식별자로만 연결합니다. (FR-STU-001, 004, NFR-SEC-002)
쉬운 설명¶
학생의 기본 정보 모델과 조회 화면을 만듭니다. 이름·연락처 등은 직접 저장하지 않고 개인정보 보관소(02-02)를 참조합니다.
기술 스택¶
Django 모델(UUID 기본키, 학번 별도 필드), 02-02 서비스 함수, 업무 화면, pytest.
예상 결과(산출물)¶
students 앱의 Student 모델, 생성 서비스 함수, 학생 목록·상세 화면, 테스트.
개발 작업 상세¶
- Student 모델: UUID, 학번(고유, 별도 필드), PersonRef, 소속·학위과정(05-01), 입학·졸업 정보.
- 개인정보 조회는 security 서비스 함수로만 하고 복호화는 권한·감사와 연결한다.
- 학생 생성 서비스 함수를 만든다(06-02가 호출).
- 목록·상세 화면과 02-04 권한 적용, 소속별 필터.
- 테스트: 학사 테이블에 개인정보 없음, 권한 없는 사용자 차단.
완료 기준¶
- 학생을 등록하고 목록·상세를 볼 수 있다.
- 학사 테이블만 추출했을 때 개인정보가 없다.
충돌 방지(소유 범위)¶
students/ 앱은 우섭 소유.
선행·후행·위험¶
선행: 02-02 개인정보 분리 구조 설계·구현 골격(김예주, 11/17 종료) / 02-03 암호화·키 관리 구현(김예주, 11/19 종료) / 02-04 역할·권한(RBAC) 구현(김예주, 11/24 종료) / 05-01 조직 구조(단과대학·학과·전공·학위과정) 모델·관리 화면(우섭, 11/13 종료)
후행: 06-02 합격자 학생 전환·학번 발급(중복 방지)(김예주) / 07-02 학적 상태·변동 이력(적용일·사유·처리자·전후값)(우섭) / 07-03 지도교수 지정·학생 상세 통합 화면(우섭) / 08-01 수강 등록·변경·취소·이수 처리(성용) / 09-01 등록금 부과·납부 상태·통화(KRW/CNY)(서현) / 14-02 이관 스크립트(합성 데이터 리허설용)(서현)
위험: 02-03·02-04 지연 시 임시로 평문 필드 없이 PersonRef만 연결하고 화면 권한은 후속 적용.
결과 확인 방법¶
"완료 기준"의 각 항목을 화면 또는 명령으로 직접 확인합니다.
- 학생을 등록하고 목록·상세를 볼 수 있다.
- 학사 테이블만 추출했을 때 개인정보가 없다.
- pytest가 모두 통과한다.
- 확인 결과(화면 캡처 또는 명령 출력 요약)를 일감 메모에 남긴다.
갱신 사항 (2026-11-04)¶
- ERD 검수 반영: 학생에 admission_date, admission_type, applicant_id(nullable)가 필요하다. 이름·연락처 등 직접 식별정보는 PersonRef로만 접근한다.
시작 전 준비¶
- 선행 일감의 결과물(문서·코드)을 먼저 읽고 약속된 이름·구조를 확인한다.
- 저장소를 최신으로 맞춘다: 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/1276-<짧은영문설명>
- "개발 작업 상세"의 번호 순서대로 한 단계씩 구현하고, 단계마다 pytest로 확인한다.
- 모델을 바꾸면 python manage.py makemigrations, 그다음 python manage.py migrate를 실행한다.
- 화면은 python manage.py runserver로 실행해 직접 열어 보고 "완료 기준"과 하나씩 대조한다.
- git add, git commit, git push 후 PR을 만든다. PR 템플릿의 체크리스트를 채우고 폴더 소유자의 리뷰를 받는다.
- 병합 후 이 일감 메모에 PR 링크와 확인 결과를 적고 상태와 진행률을 갱신한다.
막힐 때 확인¶
개인정보를 students 앱 테이블에 복사하지 마세요. 참조 ID만 저장합니다.
그래도 해결되지 않으면 일감 메모에 "무엇을 했고, 어떤 오류가 났는지"를 붙여 담당 분류 소유자 또는 팀장에게 질문하세요.
용어 풀이¶
- FK(외래 키): 한 테이블의 값이 다른 테이블의 어떤 행을 가리키게 하는 연결 값입니다. 학생이 소속 학과를 가리키는 것이 예입니다. 앱 사이에는 "앱이름.모델" 문자열로 적어 앱 간 직접 import를 피합니다.
- pytest: Python 코드를 자동으로 검사해 주는 테스트 도구입니다. 테스트 파일은 tests/ 폴더에 둡니다.
- 서비스 함수: 다른 앱이 직접 DB를 건드리지 않고 이 함수를 통해서만 기능을 쓰게 만든 창구입니다.