Project

General

Profile

Feature #1259

Updated by 성용 양 13 days ago

## 목적 

 사전 승인된 직원만 일반 로그인하게 하고, 비밀번호는 안전하게 해시하며 로그인 실패 제한·세션 만료·로그아웃을 적용합니다. (USR-001, FR-AUTH-001, 006, NFR-SEC-010 일부) 

 ## 쉬운 설명 

 승인된 계정만 ID/비밀번호로 로그인하고, 비밀번호를 여러 번 틀리면 잠깐 잠그는 기능입니다. 

 ## 기술 스택 

 Django Auth(커스텀 User), Django Sessions, 비밀번호 해시(Argon2 또는 기본 PBKDF2, 후보), django-axes 또는 직접 구현한 실패 제한(후보), Django Templates·Bootstrap 5. 

 ## 예상 결과(산출물) 

 로그인·로그아웃 화면, 실패 횟수 제한과 잠금, 세션 만료 설정, 로그인 이력 모델, 테스트. 

 ## 개발 작업 상세 

 1. 01-01에서 만든 User stub을 확장한다(직원 구분, 활성 여부, 마지막 로그인). 
 2. 로그인·로그아웃 뷰와 화면을 만든다. 로그인 후 이동 규칙(next)은 열린 리디렉션이 되지 않도록 검증한다. 
 3. 비밀번호 해시 알고리즘을 확정하고 비밀번호 규칙을 적용한다. 
 4. 로그인 실패 횟수 제한과 일정 시간 잠금을 구현한다. 
 5. 세션 만료 시간, 로그아웃 시 세션 폐기를 설정한다. 
 6. 로그인 성공·실패 이력을 저장한다(IP는 개인정보 정책에 맞게 저장 여부 확인). 
 7. 테스트: 미승인 계정 거부, 잠금, 세션 만료. 

 ## 완료 기준 

 - 직원 계정으로 로그인·로그아웃이 된다. 
 - 실패 제한과 잠금 테스트가 통과한다. 

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

 accounts/는 서현 소유. config/settings는 우섭 소유이므로 AUTH 관련 설정은 settings/base.py의 지정 구역(AUTH 블록)만 서현이 수정합니다(01-01에서 구역을 만들어 둠). 

 ## 선행·후행·위험 

 선행: 01-01 저장소·Django 골격·앱 스텁·설정 분리(우섭, 11/06 종료) 

 후행: 02-04 역할·권한(RBAC) 구현(김예주) / 03-02 계정 승인·비활성화·직원 계정 관리 화면(서현) 

 위험: User 모델 변경은 첫 migrate 전에만 안전하므로 01-01의 stub과 필드 합의 필요. 

 ## 결과 확인 방법 

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

 1. 직원 계정으로 로그인·로그아웃이 된다. 
 2. 실패 제한과 잠금 테스트가 통과한다. 
 3. pytest가 모두 통과한다. 
 4. 확인 결과(화면 캡처 또는 명령 출력 요약)를 일감 메모에 남긴다. 


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

 - 확정: 직원의 이름·이메일은 accounts에 저장하지 않고 security PersonRef를 참조한다. accounts는 username·상태 등 최소 항목만 둔다. 
 - ERD 검수 반영: 로그인 이력(login_history: user_id, 결과, IP, 시각), 직원 계정의 failed_count·locked_until·approved_at/approved_by 필드를 추가한다. django-axes를 쓰면 자체 테이블로 갈음할 수 있다. 

 ## 시작 전 준비 

 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/1259-<짧은영문설명> 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 링크와 확인 결과를 적고 상태와 진행률을 갱신한다. 

 ## 막힐 때 확인 

 비밀번호를 평문으로 저장하거나 로그에 남기지 마세요. Django 기본 해시 기능을 사용합니다. 

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

 ## 용어 풀이 

 - **세션**: 로그인한 상태를 서버가 기억하는 방식입니다. 일정 시간이 지나면 만료됩니다.

Back