Feature #1244
openFeature #1226: [MDGU] 학사관리 시스템 v1 개발 (8주, 2026-11-05 시작)
Feature #1233: [MDGU-00] 초기 논의·결정 (착수 전 확정 항목)
[MDGU-00-02] DB 분리 수준 확정
100%
Description
목적¶
가이드는 개인정보와 학사정보의 분리를 요구하지만 물리적 DB·서비스 분리 여부는 위협모델 후 결정하도록 남겨 두었습니다. 위협모델(MDGU-02-01) 결과로 분리 수준을 확정합니다.
쉬운 설명¶
대학 학생 개인정보(이름·연락처 등)를 같은 DB 안에서 분리할지, 별도 DB로 나눌지 정하는 일입니다. 02-02 보안 설계가 이 결정을 따라갑니다.
기술 스택¶
PostgreSQL 18(별도 스키마 vs 별도 DB vs 별도 서비스), 위협모델 문서.
예상 결과(산출물)¶
분리 수준 결정서(선택지 비교, 선택 이유, 비용·운영 영향).
개발 작업 상세¶
- 위협모델 1차 결과에서 유출 시나리오별 피해를 정리한다.
- 세 가지 분리 수준의 보안 효과, 구현 난이도, 운영 부담을 표로 비교한다.
- 팀 논의 후 결정하고 댓글에 기록한다.
- MDGU-02-02, MDGU-04-03에 반영한다.
완료 기준¶
- 결정서가 있다.
- 02-02 설계가 결정에 맞다.
충돌 방지(소유 범위)¶
개발 코드를 만들지 않는 논의·문서 일감이라 파일 충돌이 없습니다. 결정은 이 일감의 댓글에 기록합니다.
선행·후행·위험¶
선행: 02-01 위협모델·데이터 흐름도(김예주, 11/10 종료)
후행: 02-02 개인정보 분리 구조 설계·구현 골격(김예주) / 04-03 Dockerfile·Compose·/health/·Gunicorn·Nginx 연결·운영 설정(성용)
결과 확인 방법¶
"완료 기준"의 각 항목을 화면 또는 명령으로 직접 확인합니다.
- 결정서가 있다.
- 02-02 설계가 결정에 맞다.
- 확인 결과(화면 캡처 또는 명령 출력 요약)를 일감 메모에 남긴다.
갱신 사항 (2026-11-04)¶
- 확정(2026-11-04): PostgreSQL 18로 통일. 이 일감의 선택지 비교는 18 기준으로 한다.
- 분리 대상에는 학생·지원자·교원뿐 아니라 직원 계정 본인의 이름·이메일도 포함한다(확정).
시작 전 준비¶
- 관련 일감과 요구사항 문서(REQUIREMENTS_V1_1)·개발 가이드의 해당 절을 읽는다.
- 선택지와 장단점을 표로 적을 준비를 한다.
- 결정 회의 참석자와 일시를 정한다.
작업 진행 순서¶
- 선택지와 장단점·비용·위험을 표로 정리한다.
- 회의(또는 채팅)에서 결정하고 결정한 사람을 정한다.
- 일감 메모에 "결정 / 이유 / 결정자 / 날짜 / 영향받는 일감"을 적는다.
- 영향받는 일감 담당자에게 알리고 필요하면 해당 일감 설명을 고친다.
- 상태를 완료로 바꾼다.
막힐 때 확인¶
대학 정책 자료(00-04)가 아직 없으면 "같은 DB 안 분리 + 나중에 별도 DB로 옮길 수 있는 서비스 경계"를 가정으로 먼저 적고, 자료 수령 후 재검토하세요.
그래도 해결되지 않으면 일감 메모에 "무엇을 했고, 어떤 오류가 났는지"를 붙여 담당 분류 소유자 또는 팀장에게 질문하세요.
용어 풀이¶
- 위협모델: 어떤 정보를 누가 어떤 방식으로 위협할 수 있는지 미리 목록으로 만드는 보안 분석입니다.
성양 Updated by 성용 양 19 days ago
- Precedes Feature #1254: [MDGU-02-02] 개인정보 분리 구조 설계·구현 골격 added
성양 Updated by 성용 양 14 days ago
- Due date changed from 11/11/2026 to 11/13/2026
- Start date changed from 11/09/2026 to 11/11/2026
- Follows Feature #1253: [MDGU-02-01] 위협모델·데이터 흐름도 added
성양 Updated by 성용 양 14 days ago
- Precedes Feature #1265: [MDGU-04-03] Dockerfile·Compose·/health/·Gunicorn·Nginx 연결·운영 설정 added
성양 Updated by 성용 양 8 days ago
[성용] 결정 내용이 저장소 문서에 이미 반영되어 있어 일감에 정리해 둡니다. (2026-11-09)
- 결정: 한 PostgreSQL 18 인스턴스 안의 별도 데이터베이스 + 최소 권한 앱 계정 + 백업 분리. 초기화·마이그레이션 관리자 계정은 Django 런타임에 전달하지 않음.
- 근거 문서: docs/security/threat-model.md 7절(선택지 비교), docs/MODEL_CONTRACT.md 5.2절, docs/DEVELOPMENT_STANDARDS.md 표 5번(환경변수 계약).
- 환경변수 계약: 학사 DB는 DB_, 개인정보 DB는 PII_DB_, DATABASE_URL 미사용.
- 업무 모델의 person_ref_id는 UUID 값이며 개인정보 DB를 향한 물리 FK가 아님.
- 영향받는 일감: 02-02(#1254)에서 pii 연결·모델 라우터 구현, 04-03(#1265)에서 Compose·production settings·.env.example에 반영.
예주님은 위 내용이 맞는지 확인해 주시고, 정정할 부분이 없으면 이 일감 상태를 처리해 주세요.
성양 Updated by 성용 양 7 days ago
- Status changed from New to Resolved
- % Done changed from 0 to 100
[성용] 운영 적용 확인 (2026-11-11)
- 11/09 기록한 결정(한 PostgreSQL 18 인스턴스 안 별도 DB + 최소 권한 앱 계정 + 마이그레이션 계정 분리)이 결정 문서 PR #14로 병합되었고, 운영에 그대로 적용됨.
- 운영: Cloud SQL 학사 DB
g_dts(웹 계정 g_dts_web), 개인정보 DBg_dts_personal(웹 계정 g_dts_personal_web), 둘 다 SSL. 웹 컨테이너에는 웹 계정만, migration 계정은 일회성 migrate 작업에만 전달. - 개인정보 DB 라우터는 PR #22(02-02 #1254 일부)로 구현.
- 완료 기준을 충족해 Resolved로 바꿉니다. 정정할 내용이 있으면 예주님이 다시 열어 주세요.
성양 Updated by 성용 양 6 days ago
[성용] 변경 기록 (2026-11-11)
- PR #36 병합(https://github.com/GilbertMoon/university-academic-system/pull/36, 예주): DB 분리 결정서(ADR-001)에 결정자·날짜 기록. 상태·진척도 변경 없음