Actions
Feature #1261
open
성양
서임
Feature #1226: [MDGU] 학사관리 시스템 v1 개발 (8주, 2026-11-05 시작)
Feature #1236: [MDGU-03] 로그인·계정 (서현)
[MDGU-03-03] 카카오 로그인 연동(승인 계정 연결)
Feature #1261:
[MDGU-03-03] 카카오 로그인 연동(승인 계정 연결)
Start date:
12/01/2026
Due date:
12/02/2026 (Due in 15 days)
% Done:
0%
Estimated time:
Description
목적¶
카카오 계정으로 로그인하되 사전 승인된 직원 계정에만 연결합니다. 이메일 문자열만으로 자동 연결하지 않습니다. (FR-AUTH-002, 004, 005, 007, P1)
쉬운 설명¶
카카오 계정으로 로그인하되, 이미 승인된 계정에만 연결하는 기능입니다. 승인 없이 새 계정이 만들어지면 안 됩니다.
기술 스택¶
django-allauth 또는 authlib(후보), 카카오 OAuth 2.0/OIDC, Django 세션.
예상 결과(산출물)¶
카카오 로그인 버튼·콜백, 제공자 고유 식별자 기반 연결 모델, 연결·해제 재인증, 테스트.
개발 작업 상세¶
- 00-05에서 등록한 카카오 앱 정보(비밀키는 환경변수)를 설정한다.
- 콜백에서 제공자 고유 식별자(sub)로만 계정을 찾는다. 이메일로 자동 연결하지 않는다.
- 로그인된 승인 계정이 설정 화면에서 연결·해제할 때 비밀번호 재입력(재인증)과 관리자 승인 절차를 적용한다.
- 승인되지 않은 카카오 계정은 로그인 거부 화면으로 보낸다.
- 테스트: 미승인 거부, 이메일 일치만으로 연결 불가.
완료 기준¶
- 미승인 카카오 계정으로 로그인할 수 없다(인수 테스트 1).
- 연결·해제가 감사 로그에 남는다.
충돌 방지(소유 범위)¶
accounts/ 소유.
선행·후행·위험¶
선행: 00-05 카카오·Google OAuth 앱 등록 담당·일정 확인(서현, 11/11 종료) / 03-02 계정 승인·비활성화·직원 계정 관리 화면(서현, 11/30 종료)
후행: 03-04 Google 로그인 연동(OIDC) 및 계정 연결 통합 점검(서현)
위험: 카카오 앱 승인이 늦으면 v1에서 후순위(P1).
결과 확인 방법¶
"완료 기준"의 각 항목을 화면 또는 명령으로 직접 확인합니다.
- 미승인 카카오 계정으로 로그인할 수 없다(인수 테스트 1).
- 연결·해제가 감사 로그에 남는다.
- pytest가 모두 통과한다.
- 확인 결과(화면 캡처 또는 명령 출력 요약)를 일감 메모에 남긴다.
갱신 사항 (2026-11-04)¶
- ERD 검수 반영: 외부 계정 연결은 (provider, provider_subject) unique, 연결 승인자·승인 시각·해제 시각을 기록한다. 이메일 문자열로 자동 연결하지 않는다.
시작 전 준비¶
- 선행 일감의 결과물(문서·코드)을 먼저 읽고 약속된 이름·구조를 확인한다.
- 저장소를 최신으로 맞춘다: 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/1261-<짧은영문설명>
- "개발 작업 상세"의 번호 순서대로 한 단계씩 구현하고, 단계마다 pytest로 확인한다.
- 모델을 바꾸면 python manage.py makemigrations, 그다음 python manage.py migrate를 실행한다.
- 화면은 python manage.py runserver로 실행해 직접 열어 보고 "완료 기준"과 하나씩 대조한다.
- git add, git commit, git push 후 PR을 만든다. PR 템플릿의 체크리스트를 채우고 폴더 소유자의 리뷰를 받는다.
- 병합 후 이 일감 메모에 PR 링크와 확인 결과를 적고 상태와 진행률을 갱신한다.
막힐 때 확인¶
앱 등록(00-05)과 리디렉션 주소가 틀리면 오류가 납니다. 개발용/운영용 주소를 각각 등록했는지 확인하세요.
그래도 해결되지 않으면 일감 메모에 "무엇을 했고, 어떤 오류가 났는지"를 붙여 담당 분류 소유자 또는 팀장에게 질문하세요.
용어 풀이¶
- 감사 로그: 누가 언제 무엇을 했는지 남기는 변경 불가 기록입니다. 문제가 생겼을 때 추적하는 근거가 됩니다.
- OAuth·OIDC: Google이나 카카오 같은 외부 서비스의 계정으로 우리 시스템에 로그인하게 해 주는 표준 방식입니다.
- 세션: 로그인한 상태를 서버가 기억하는 방식입니다. 일정 시간이 지나면 만료됩니다.
성양 Updated by 성용 양 19 days ago
- Due date changed from 11/24/2026 to 11/13/2026
- Start date changed from 11/23/2026 to 11/12/2026
- Follows Feature #1260: [MDGU-03-02] 계정 승인·비활성화·직원 계정 관리 화면 added
성양 Updated by 성용 양 19 days ago
- Follows Feature #1247: [MDGU-00-05] 카카오·Google OAuth 앱 등록 담당·일정 확인 added
성양 Updated by 성용 양 14 days ago
- Precedes Feature #1262: [MDGU-03-04] Google 로그인 연동(OIDC) 및 계정 연결 통합 점검 added
Actions