Feature #1256
openFeature #1226: [MDGU] 학사관리 시스템 v1 개발 (8주, 2026-11-05 시작)
Feature #1235: [MDGU-02] 보안·개인정보 (김예주, P0)
[MDGU-02-04] 역할·권한(RBAC) 구현
90%
Description
목적¶
직원마다 조회·등록·수정·삭제·출력·내보내기를 구분하고 최소권한을 적용합니다. (USR-002, NFR-SEC-005)
쉬운 설명¶
사용자 역할(관리자·교직원 등)별로 볼 수 있는 화면과 할 수 있는 작업을 제한하는 기능입니다. 다른 앱은 한 줄(mixin)만 붙여서 사용합니다.
기술 스택¶
Django Groups/Permissions, 사용자 정의 권한, 뷰 mixin·데코레이터, pytest.
예상 결과(산출물)¶
역할 정의, 권한 mixin/데코레이터, 개인정보 복호화·내보내기 권한, 사용 가이드, 테스트.
개발 작업 상세¶
- 역할 후보를 정한다(시스템 관리자, 교적 담당, 학사 담당 등). 대학의 역할 구분은 00-04 확인 후 조정한다.
- 권한 코드 규칙을 정한다:
<앱>.<행위>_<대상>(조회·등록·수정·삭제·출력·내보내기). - 뷰용 mixin과 함수형 데코레이터를 만들어 다른 팀원이 한 줄로 적용하게 한다.
- 개인정보 복호화·일괄 내보내기는 별도 권한으로 분리한다.
- 권한 없는 직접 URL·API 요청이 거부되는 테스트를 만든다.
완료 기준¶
- 권한 없는 사용자의 직접 URL 접근이 차단된다(인수 테스트 5).
- 권한 적용 방법이 문서화되었다.
충돌 방지(소유 범위)¶
security/ 안에서 작업하며 다른 앱에는 mixin 사용만 요청합니다.
선행·후행·위험¶
선행: 02-02 개인정보 분리 구조 설계·구현 골격(김예주, 11/17 종료) / 02-03 암호화·키 관리 구현(김예주, 11/19 종료) / 03-01 승인 계정 ID/PW 로그인·세션·로그인 제한(서현, 11/17 종료)
후행: 02-05 감사 로그 구현(김예주) / 02-06 보안 점검·자동 테스트 모음 정리(김예주) / 03-02 계정 승인·비활성화·직원 계정 관리 화면(서현) / 06-01 지원자 모델·지원 상태·입학 판정(김예주) / 07-01 학생 기본 모델·개인정보 참조·조회 화면(우섭) / 12-01 증빙 파일 업로드·암호화 저장·접근통제·다운로드 이력(김예주) / 12-02 Excel 가져오기·내보내기(오류 행 검증)(김예주)
위험: 이 일감이 11/24 넘으면 3~4주차 화면 작업이 권한 없이 진행됨(임시 규칙: 권한 적용은 mixin 한 줄로 후속 추가).
결과 확인 방법¶
"완료 기준"의 각 항목을 화면 또는 명령으로 직접 확인합니다.
- 권한 없는 사용자의 직접 URL 접근이 차단된다(인수 테스트 5).
- 권한 적용 방법이 문서화되었다.
- pytest가 모두 통과한다.
- 확인 결과(화면 캡처 또는 명령 출력 요약)를 일감 메모에 남긴다.
시작 전 준비¶
- 선행 일감의 결과물(문서·코드)을 먼저 읽고 약속된 이름·구조를 확인한다.
- 저장소를 최신으로 맞춘다: 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/1256-<짧은영문설명>
- "개발 작업 상세"의 번호 순서대로 한 단계씩 구현하고, 단계마다 pytest로 확인한다.
- 모델을 바꾸면 python manage.py makemigrations, 그다음 python manage.py migrate를 실행한다.
- 화면은 python manage.py runserver로 실행해 직접 열어 보고 "완료 기준"과 하나씩 대조한다.
- git add, git commit, git push 후 PR을 만든다. PR 템플릿의 체크리스트를 채우고 폴더 소유자의 리뷰를 받는다.
- 병합 후 이 일감 메모에 PR 링크와 확인 결과를 적고 상태와 진행률을 갱신한다.
막힐 때 확인¶
권한 규칙이 헷갈리면 요구사항 문서의 역할 표를 기준으로 하고, 새 역할이 필요하면 임의로 추가하지 말고 팀에 먼저 공유하세요.
그래도 해결되지 않으면 일감 메모에 "무엇을 했고, 어떤 오류가 났는지"를 붙여 담당 분류 소유자 또는 팀장에게 질문하세요.
용어 풀이¶
- RBAC(역할 기반 접근 제어): 사람마다 허용 범위를 따로 정하지 않고 "관리자·교직원" 같은 역할에 권한을 붙여, 역할을 가진 사람만 해당 화면·작업을 쓰게 하는 방식입니다.
- mixin: 여러 화면(클래스)에 "붙이기만 하면" 같은 기능이 추가되는 작은 공통 코드 조각입니다. 한 줄 추가로 권한 검사를 적용할 때 씁니다.
- pytest: Python 코드를 자동으로 검사해 주는 테스트 도구입니다. 테스트 파일은 tests/ 폴더에 둡니다.