4.4 KiB
4.4 KiB
.agent 폴더 계획 문서 인덱스
📋 핵심 계획 문서 (*_plan.md)
1. 로그인 & 보안 계획서
- 파일:
login_security_plan.md - 최신 버전: v1.0 (2026-07-07)
- 내용:
- 계정 유형 정의 (마스터, 팀원, 시스템관리자)
- 회원가입/로그인 흐름
- 이메일 인증(MFA) 정책
- 세션 관리 (12시간 기본, 4시간 활동감지)
- DB 스키마 (users, companies, join_requests, login_logs, activity_logs 등)
- ISMS-P 보안 기초 구축
- 상태: 완결, 코드 작성 대기
2. 이메일 인프라 계획서
- 파일:
email_infrastructure_plan.md - 최신 버전: v1.0 (2026-07-07)
- 내용:
- 발송 유형 (OTP, 가입 확인, 팀원 승인 요청 등)
- Google Gmail SMTP 설정 (개발용: umsangdon@gmail.com)
- 비동기 이메일 발송 아키텍처
- common_util_email.py 모듈 예시
- 이메일 템플릿 (OTP, 팀원 승인 요청)
- Phase 2 마이그레이션 계획 (AWS SES)
- 상태: 완결, 코드 작성 대기
3. 세션 쿠키 구현 명세
- 파일:
SESSION_COOKIE_SPEC.md - 최신 버전: v1.0 (2026-07-07)
- 내용:
- 최종 확정: Secure HttpOnly 세션 쿠키 (JWT 아님)
- 쿠키 설정 상세 (name, max_age, secure, httponly, samesite)
- sessions 테이블 스키마
- 세션 검증 미들웨어 코드
- 로그아웃 및 강제 로그아웃 구현
- 만료된 세션 자동 정리
- 활성 세션 모니터링
- 테스트 방법 (수동/자동)
- 프론트엔드 연동 (credentials: "include")
- 상태: 완결, 코드 작성 대기
4. 마이그레이션 계획서
- 파일:
migration_plan.md - 내용: 프로젝트 초기 구현 단계
- 상태: 코드 구현 완료, 검증 진행 중
📚 기술 명세 문서
1. 프로젝트 구조
- 파일:
structure.md - 최신 업데이트: 2026-07-07 (A09_Security 추가)
- 내용: 전체 폴더/파일 구조, 명명 규칙
- 변경사항:
- ✅ A09_Security 폴더 추가 (보안/약관 동의 페이지)
2. 백엔드 명세
- 파일:
backend.md - 최신 업데이트: 2026-07-07 (섹션 6 추가)
- 내용: FastAPI 아키텍처, DB 관리, 워크플로우 동기화
- 변경사항:
- ✅ 섹션 6 추가: 로그인/인증 시스템 (OTP, 비밀번호, 세션, 권한, 이메일)
3. 프론트엔드 명세
- 파일:
frontend.md - 내용: UI 테마, 컴포넌트, 레이아웃 제약
- 상태: 검토 대기 (A09 페이지 가이드 추가 필요)
4. DB 스키마
- 파일:
db_schema.md - 내용: 데이터베이스 테이블 정의
- 상태: 로그인 테이블 추가 필요
💬 참고 자료
1. 로그인 대화 기록
- 파일:
login_chat_info.md - 내용: 제미나와의 로그인/보안 요구사항 논의
- 방향성:
- ✅ 개인별 계정 (공용 이메일 허용)
- ✅ 초대코드 → 사용자 요청 기반 (마스터 승인제)
- ✅ 이메일 OTP 인증 (3개월 주기)
- ✅ 세션 12시간 (4시간 활동감지)
- ✅ IP 수집 제외, User-Agent만 저장
🔄 다음 액션 아이템
Phase 1 (필수, 즉시)
- .env 파일 작성 (Google 앱 비밀번호 설정)
- common_util_email.py 코드 구현
- A07_Register_Router.py 이메일 발송 통합
- 로그인 API 구현 및 테스트
- DB 테이블 생성 (schema.sql)
- 로그인 페이지 (A06, A07, A09) 프론트엔드 구현
Phase 2 (중요)
- 3개월 재인증 로직 구현
- 로그인 이력 기록 (activity_logs)
- 마스터 대시보드 (팀원 관리)
- frontend.md 업데이트 (A06~A09 가이드)
- db_schema.md 업데이트 (모든 로그인 테이블)
Phase 3 (고급)
- 시스템관리자 포털 개발
- AWS SES 마이그레이션 준비
- ISMS-P 인증 준비 문서
📝 문서 관리 정책
규칙
- _plan.md 파일은 수정하지 않음 (새 버전 생성)
- 기술 명세 문서 (structure, backend, frontend, db_schema)는 필요시 즉시 업데이트
- 참고 자료 (chat_info 등)는 아카이브 용도
버전 관리
- 계획서 버전 변경:
v1.0→v1.1(CHANGELOG 추가) - 기술 명세는 날짜만 기록
마지막 업데이트: 2026-07-07
담당자: AI 문서 관리팀