Feature #1259
Updated by 성용 양 14 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 종료)
01-01. 후행: 02-04 역할·권한(RBAC) 구현(김예주) / 03-02 계정 승인·비활성화·직원 계정 관리 화면(서현)
02-04, 03-02, 03-03. 위험: User 모델 변경은 첫 migrate 전에만 안전하므로 01-01의 stub과 필드 합의 필요.
## 결과 확인 방법
올바른 계정은 로그인되고, 미승인·비활성 계정은 거부되며, 5회 등 설정된 횟수 실패 시 잠금이 걸리는 테스트가 있으면 완료입니다.
## 시작 전 준비
1. 선행 일감의 결과물(문서·코드)을 먼저 읽고 약속된 이름·구조를 확인한다.
2. 저장소를 최신으로 맞춘다: git switch main 후 git pull
3. 저장소 README(01-01 결과) 순서대로 환경을 준비한다. 보통 python -m venv .venv, 가상환경 켜기, pip install -r requirements.txt, docker compose up -d db(DB 실행), python manage.py migrate 순서이다.
4. #1226의 폴더 소유 표에서 내가 고칠 수 있는 폴더를 확인한다.
## 작업 진행 순서
1. 브랜치를 만든다: git switch -c 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