Feature #1226
Updated by 성용 양 7 days ago
## 목적
MD Global University 학사관리 시스템 v1을 8주 안에 개발·검수·배포합니다. 요구사항 v1(2026-10-21)과 개발·배포 가이드 v0.2(2026-11-04)이 기준 문서입니다.
## 가정과 기준
- 시작일: 2026-11-05(목) 시작 (11/02에서 변경). 담당(4인): A=우섭, B=김예주, C=서현, D=성용.
- 배포: 배포는 가이드 기준(별도 Ubuntu 24.04 VPS + Docker Compose + Nginx + Cloud SQL로 확정(00-01 #1243, 2026-11-11). 아래 "갱신 사항 (2026-11-11)" 참조. GitHub Actions 승인형 배포). 최종 확정은 [MDGU-00]의 논의 일감에서 합니다.
- 우선순위: P0=출시 전 필수(보안·로그인), P1=v1 필수 업무 기능. v1 제외: 학생·교수 포털, 온라인 결제·수강신청, 외부 연동, OTP.
- 대학 자료(성적 규칙, 졸업 요건, 서식, 환율, 기존 데이터)가 늦으면 관련 일감 일정이 밀립니다.
## 분류 구조
[MDGU-00] 초기 논의·결정 / [MDGU-01]~[MDGU-14] 대분류 14개 / [MDGU-15] 통합 QA·UAT. A(우섭)=01·05·07·13, B(김예주)=02·06·12, C(서현)=03·09·11·14, D(성용)=04·08·10.
## 충돌 방지 규칙
1. 앱(폴더) 단위 소유권: 아래 표의 소유자만 해당 폴더를 수정합니다.
2. 01-01에서 모든 앱 스텁을 settings에 한 번에 등록하므로 이후 앱을 추가할 때 settings를 고치지 않습니다.
3. 다른 사람 앱의 모델·화면을 바꿔야 하면 그 소유자에게 요청 일감(댓글)을 남기고 소유자가 반영합니다.
4. 앱 사이 연결은 문자열 FK(예: "students.Student")와 서비스 함수로만 합니다.
5. 마이그레이션은 앱별 폴더에만 두고, 서로 다른 앱의 마이그레이션 파일을 건드리지 않습니다.
6. 브랜치 이름: feature/<일감번호>-<짧은설명>, PR은 소유자 1명 이상 리뷰 후 병합.
| 폴더·앱 | 소유자 | 비고 |
|---|---|---|
| config/, core/, 공통 템플릿·static | 우섭(A) | 변경은 PR + 우섭 리뷰 |
| accounts/ | 서현(C) | User 모델 stub만 01-01에서 우섭이 생성 후 인계 |
| security/ (개인정보·암호화·RBAC·감사) | 김예주(B) | |
| academics/ (조직·학기·교원·교과목·분반) | 우섭(A) | |
| admissions/ | 김예주(B) | |
| students/ | 우섭(A) | |
| enrollment/, grades/ | 성용(D) | |
| tuition/ | 서현(C) | |
| graduation/ | 성용(D) | |
| documents/ | 서현(C) | |
| files/, imports/ | 김예주(B) | |
| search/ | 우섭(A) | |
| legacy_migration/ | 서현(C) | |
| Dockerfile, compose*.yml, .github/, deploy/, nginx/ | 성용(D) | 인프라 |
## 일정
1주 11/05~11/11 설계·초기 환경 / 2주 11/12~11/18 인증·보안·기준 데이터 / 3주 11/19~11/25 학생·지원·권한 완성 / 4주 11/26~12/02 학적·입학·로그인 연동 / 5주 12/03~12/09 수강·성적·등록금 / 6주 12/10~12/16 성적 확정·졸업·증명서 / 7주 12/17~12/23 Excel·검색·이관 / 8주 12/24~01/06 통합 QA·UAT·인수 (영업일 기준, 12/25·1/1 휴일 제외, 선행 관계 반영 후 종료 2027-01-06).
## 갱신 사항 (2026-11-04)
- PostgreSQL은 18로 통일한다(로컬·CI·운영). 배포 가이드 v0.2에 반영 완료(GitHub PR #2).
- 소유권 표 추가: pyproject.toml, requirements*.txt, .env.example, docs/ERD.md, docs/DEVELOPMENT_STANDARDS.md는 우섭(A), docs/security/는 김예주(B).
- 공통 개발 기준(충돌 방지 규약) 문서 docs/DEVELOPMENT_STANDARDS.md를 따른다: 브랜치·PR, 앱 간 경계, 마이그레이션 순서, 개인정보 코딩 규칙, 변경 요청 절차.
- 마이그레이션 규칙: 모델 변경은 ERD 갱신 PR을 먼저 승인받고, 병합된 마이그레이션은 수정하지 않으며, 앱 마이그레이션은 해당 앱 소유자만 만든다.
- 다른 사람 폴더 변경 요청은 해당 일감 댓글에 [변경 요청] 요청자/대상/이유/원하는 형태/희망 기한/임시 우회로 형식으로 남기고, 소유자는 영업일 48시간 안에 답한다.
- 확정(2026-11-04): 지원자→학생 전환 시 같은 PersonRef 재사용, 직원 이름·이메일은 security 저장소 참조. 임시 기준: 학적·성적·납부는 물리 삭제 금지, 무효 처리(is_void+사유). 보존·파기 기간은 대학 정책 확정 후 결정.
- 공통 골격(01-01)은 main에 병합 완료됨(서현 작업).
## 갱신 사항 (2026-11-11)
- 첫 운영 배포 완료: https://g-dts.com (main d419824). 운영 구성: 기존 VPS(동백 홈페이지 dbresting.com과 같은 서버)에 Docker Compose(`compose.cloudsql.yml`, 프로젝트 university-academic-system, 내부 포트 8002)로 올리고, 호스트 Nginx가 도메인으로 구분합니다. DB는 Cloud SQL PostgreSQL 18의 학사 DB와 개인정보 DB 2개(SSL 연결)입니다.
- 현재 운영 화면: 홈·조직·학위과정·인프라 점검. 로그인은 03-01(#1259) 전까지 Django 관리자 로그인 화면을 임시로 사용합니다.
- 팀 개발 방식 확정: 팀원은 운영 Cloud SQL에 접속하지 않고 각자 PC의 로컬 PostgreSQL 18(학사 DB·개인정보 DB 2개)만 사용합니다. 기준 문서는 `docs/TEAM_LOCAL_DEV_AND_PR.md`입니다(PR #26). 이전 공유 Cloud SQL 안내(`docs/TEAM_DEV_SETUP_CLOUDSQL.md`, PR #25)는 삭제되었습니다.
- 팀원 범위: 로컬 개발·테스트·ruff → migration 파일 포함 확인 → 기능 브랜치 push → main 대상 PR(로컬 검증 결과 기록). 서버 접속·배포는 하지 않습니다.
- 운영 배포와 Cloud SQL migration은 성용만 수행합니다: PR 로컬 확인 → main 병합 → 운영 DB 백업 → main 40자리 SHA 배포 → 필요할 때만 migration → smoke test.
- 모델 변경 PR에는 migration 파일과 대상 DB(학사 default / 개인정보 pii)를 반드시 적습니다.
Back