Feature #1254
openFeature #1226: [MDGU] 학사관리 시스템 v1 개발 (8주, 2026-11-05 시작)
Feature #1235: [MDGU-02] 보안·개인정보 (김예주, P0)
[MDGU-02-02] 개인정보 분리 구조 설계·구현 골격
100%
Description
목적¶
DB 일부가 유출돼도 이름·연락처가 학사 데이터에서 바로 식별되지 않게, 개인정보와 학사 데이터를 분리하고 무작위 내부 식별자만 연결합니다.
쉬운 설명¶
이름·연락처 등 개인정보를 일반 학적 데이터와 따로 보관하고, 다른 앱은 허용된 함수로만 읽도록 하는 구조 골격입니다.
기술 스택¶
PostgreSQL 18 스키마/롤 분리(결정 00-02에 따라 별도 DB 가능), Django 모델·서비스 함수, UUID.
예상 결과(산출물)¶
security 앱의 개인정보 저장 모델과 가명 식별자 매핑 모델, 접근 서비스 함수(get_person(uuid, actor) 등), 사용 가이드.
개발 작업 상세¶
- 00-02 결정에 맞춰 개인정보 저장 영역(스키마 또는 DB)을 정한다.
- Person 저장 모델(이름·연락처·주소 등 직접 식별정보)과 학사 데이터의 연결용 무작위 식별자 매핑을 만든다.
- 개인정보는 서비스 함수로만 읽고 쓰게 하고 모델 직접 접근을 막는 규칙을 정한다.
- DB 롤(학사 롤, 개인정보 롤)과 권한을 설계한다.
- 다른 팀원이 쓰는 방법(예: 학생 모델이 Person UUID를 참조)을 문서화한다.
완료 기준¶
- 학사 테이블만 추출했을 때 이름·연락처가 없다(인수 테스트 3).
- 서비스 함수 사용 예제가 동작한다.
충돌 방지(소유 범위)¶
security/ 앱은 김예주 소유. 다른 앱은 문자열 FK security.PersonRef와 서비스 함수만 사용합니다.
선행·후행·위험¶
선행: 00-02 DB 분리 수준 확정(김예주, 11/13 종료) / 01-02 ERD·모델 계약 초안(앱 간 FK 규칙)(우섭, 11/11 종료) / 02-01 위협모델·데이터 흐름도(김예주, 11/10 종료)
후행: 02-03 암호화·키 관리 구현(김예주) / 02-04 역할·권한(RBAC) 구현(김예주) / 05-03 교원 구분·소속 없는 강사 등록(우섭) / 06-01 지원자 모델·지원 상태·입학 판정(김예주) / 07-01 학생 기본 모델·개인정보 참조·조회 화면(우섭)
위험: 분리 결정 지연.
결과 확인 방법¶
"완료 기준"의 각 항목을 화면 또는 명령으로 직접 확인합니다.
- 학사 테이블만 추출했을 때 이름·연락처가 없다(인수 테스트 3).
- 서비스 함수 사용 예제가 동작한다.
- pytest가 모두 통과한다.
- 확인 결과(화면 캡처 또는 명령 출력 요약)를 일감 메모에 남긴다.
갱신 사항 (2026-11-04)¶
- PostgreSQL 18 기준. PersonRef 대상에 학생·지원자·교원·직원이 모두 포함된다.
- 지원자→학생 전환 시 같은 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/1254-<짧은영문설명>
- "개발 작업 상세"의 번호 순서대로 한 단계씩 구현하고, 단계마다 pytest로 확인한다.
- 모델을 바꾸면 python manage.py makemigrations, 그다음 python manage.py migrate를 실행한다.
- 화면은 python manage.py runserver로 실행해 직접 열어 보고 "완료 기준"과 하나씩 대조한다.
- git add, git commit, git push 후 PR을 만든다. PR 템플릿의 체크리스트를 채우고 폴더 소유자의 리뷰를 받는다.
- 병합 후 이 일감 메모에 PR 링크와 확인 결과를 적고 상태와 진행률을 갱신한다.
막힐 때 확인¶
분리 수준은 00-02 결정을 따릅니다. 결정이 없으면 일감 메모에 가정을 적고 진행하세요.
그래도 해결되지 않으면 일감 메모에 "무엇을 했고, 어떤 오류가 났는지"를 붙여 담당 분류 소유자 또는 팀장에게 질문하세요.
용어 풀이¶
- FK(외래 키): 한 테이블의 값이 다른 테이블의 어떤 행을 가리키게 하는 연결 값입니다. 학생이 소속 학과를 가리키는 것이 예입니다. 앱 사이에는 "앱이름.모델" 문자열로 적어 앱 간 직접 import를 피합니다.
- 이관·매핑표: 기존 자료를 새 시스템으로 옮기는 일이 이관이고, 기존 항목이 새 항목의 무엇에 해당하는지 짝지은 표가 매핑표입니다.
- 서비스 함수: 다른 앱이 직접 DB를 건드리지 않고 이 함수를 통해서만 기능을 쓰게 만든 창구입니다.
성양 Updated by 성용 양 19 days ago
- Follows Feature #1244: [MDGU-00-02] DB 분리 수준 확정 added
성양 Updated by 성용 양 19 days ago
- Follows Feature #1253: [MDGU-02-01] 위협모델·데이터 흐름도 added
성양 Updated by 성용 양 19 days ago
- Follows Feature #1250: [MDGU-01-02] ERD·모델 계약 초안(앱 간 FK 규칙) added
성양 Updated by 성용 양 19 days ago
- Precedes Feature #1255: [MDGU-02-03] 암호화·키 관리 구현 added
성양 Updated by 성용 양 19 days ago
- Precedes Feature #1271: [MDGU-05-03] 교원 구분·소속 없는 강사 등록 added
성양 Updated by 성용 양 19 days ago
- Precedes Feature #1273: [MDGU-06-01] 지원자 모델·지원 상태·입학 판정 added
성양 Updated by 성용 양 19 days ago
- Precedes Feature #1276: [MDGU-07-01] 학생 기본 모델·개인정보 참조·조회 화면 added
성양 Updated by 성용 양 14 days ago
- Precedes Feature #1256: [MDGU-02-04] 역할·권한(RBAC) 구현 added
성양 Updated by 성용 양 7 days ago
- Status changed from New to In Progress
- % Done changed from 0 to 30
[성용] 진행 상태 정리 (2026-11-11)
[반영된 것]
- PR #22 병합(커밋 bdf9687): settings의 개인정보 DB(
pii) 연결과config.db_router.PersonalDataRouter. 운영 Cloud SQL 개인정보 DB 연결 확인.
[남은 것]
- security 앱의 개인정보 저장 모델·가명 식별자 매핑 모델과 migration(개인정보 DB 대상).
- 접근 서비스 함수(
get_person(uuid, actor)등)와 사용 가이드, 인수 테스트 3(학사 테이블에 이름·연락처 없음).
성양 Updated by 성용 양 4 days ago
- Status changed from In Progress to Resolved
- % Done changed from 30 to 100
[성용] 진행 기록 (2026-11-13)
[한 일]
- PR #52 병합(main db70350): https://github.com/GilbertMoon/university-academic-system/pull/52
- 개인정보 DB의 PrivatePerson(직접 식별정보 전체 암호화)·PersonRef(업무 참조 UUID, 멱등 키 해시)
- 공개 함수 create_person·get_person(요청 필드만 복호화)·ensure_person_ref, 권한 security.add_person·decrypt_person·export_bulk, 감사 pii.create·pii.decrypt
- 리뷰 반영: 호출자 트랜잭션 안에서 부르면 거부(감사 유실 방지), 같은 멱등 키 재호출 때 빠진 등록 감사 복구, ERD·모델 계약·사용 가이드(docs/security/person-ref.md) 갱신
- 후속 PR #55 병합(main 94351f3, 우섭님): https://github.com/GilbertMoon/university-academic-system/pull/55 — DB 라우터가 화면의 request.user도 판별(actor=request.user 사용 가능)
- 후속 PR #56 병합(main 0c8ea3a): https://github.com/GilbertMoon/university-academic-system/pull/56 — #53(새 계정 비활성 기본)과 합쳐지며 깨진 테스트 계정을 승인된 활성 계정으로 수정, main CI 복구
[남은 것]
- 암호화 실키는 실제 학생·교원 데이터 입력 직전에 운영 담당이 생성(키 관리 문서 운영 반영 순서)
- 교원(05-03)·학생(07-01)에서 위 공개 함수로 연결