Project

General

Profile

Feature #1262

Updated by 성용 양 13 days ago

## 목적 

 Google 계정도 승인된 직원 계정에만 연결하고, 일반·카카오·Google이 하나의 직원 계정에 안전하게 묶이는지 검증합니다. (FR-AUTH-003, 004, 005, 007, P1) 

 ## 쉬운 설명 

 Google 로그인(OIDC)을 연결하고, 세 가지 로그인 방식(ID/PW·카카오·Google)이 같은 계정에 안전하게 연결되는지 통합 점검합니다. 

 ## 기술 스택 

 django-allauth 또는 authlib(후보), Google OpenID Connect, pytest. 

 ## 예상 결과(산출물) 

 Google 로그인, 연결·해제, 세 로그인 수단 통합 테스트. 

 ## 개발 작업 상세 

 1. 00-05의 Google 앱 정보(환경변수)를 설정한다. 
 2. 03-03과 같은 규칙(고유 식별자 기반, 이메일 자동 연결 금지)으로 연결한다. 
 3. 일반·카카오·Google이 한 계정에 연결되는 시나리오를 테스트한다(인수 테스트 2). 
 4. 연결 해제·계정 잠금 시 모든 수단에서 로그인 불가인지 확인한다. 

 ## 완료 기준 

 - 인수 테스트 1·2가 통과한다. 

 ## 충돌 방지(소유 범위) 

 accounts/ 소유. 

 ## 선행·후행·위험 

 선행: 03-03 카카오 로그인 연동(승인 계정 연결)(서현, 12/02 종료) 

 후행: 없음 

 위험: Google 동의 화면 승인 지연. 

 ## 결과 확인 방법 

 "완료 기준"의 각 항목을 화면 또는 명령으로 직접 확인합니다. 

 1. 인수 테스트 1·2가 통과한다. 
 2. pytest가 모두 통과한다. 
 3. 확인 결과(화면 캡처 또는 명령 출력 요약)를 일감 메모에 남긴다. 


 ## 갱신 사항 (2026-11-04) 

 - ERD 검수 반영: 외부 계정 연결은 (provider, provider_subject) unique, 연결 승인자·승인 시각·해제 시각을 기록한다. 이메일 문자열로 자동 연결하지 않는다. 

 ## 시작 전 준비 

 1. 선행 일감의 결과물(문서·코드)을 먼저 읽고 약속된 이름·구조를 확인한다. 
 2. 저장소를 최신으로 맞춘다: git switch main 후 git pull --ff-only origin main 
 3. 저장소 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과 비밀번호는 공유·커밋하지 않는다. 
 4. #1226의 폴더 소유 표에서 내가 고칠 수 있는 폴더를 확인한다. 

 ## 작업 진행 순서 

 1. 브랜치를 만든다: git switch -c feature/1262-<짧은영문설명> feature/MDGU-번호-짧은이름 
 2. "개발 작업 상세"의 번호 순서대로 한 단계씩 구현하고, 단계마다 pytest로 확인한다. 
 3. 모델을 바꾸면 python manage.py makemigrations, 그다음 python manage.py migrate를 실행한다. 
 4. 화면은 python manage.py runserver로 실행해 직접 열어 보고 "완료 기준"과 하나씩 대조한다. 
 5. git add, git commit, git push 후 PR을 만든다. PR 템플릿의 체크리스트를 채우고 폴더 소유자의 리뷰를 받는다. 
 6. 병합 후 이 일감 메모에 PR 링크와 확인 결과를 적고 상태와 진행률을 갱신한다. 

 ## 막힐 때 확인 

 Google 클라이언트 키는 환경 변수로만 관리하고 저장소에 올리지 마세요. 

 그래도 해결되지 않으면 일감 메모에 "무엇을 했고, 어떤 오류가 났는지"를 붙여 담당 분류 소유자 또는 팀장에게 질문하세요. 

 ## 용어 풀이 

 - **OAuth·OIDC**: Google이나 카카오 같은 외부 서비스의 계정으로 우리 시스템에 로그인하게 해 주는 표준 방식입니다. 
 - **pytest**: Python 코드를 자동으로 검사해 주는 테스트 도구입니다. 테스트 파일은 tests/ 폴더에 둡니다.

Back