Skip to content

Auth and Demo Account

mini edited this page Aug 10, 2026 · 4 revisions

로그인/회원가입 흐름과 데모 계정

fowoco-server의 실제 Auth API(JWT access token + HttpOnly refresh token 쿠키)에 연동되어 있습니다. (src/store/authStore.ts)

데모 계정

실제로 로그인되는 계정 — 서버 DEMO_SEED_ENABLED=true일 때 기본으로 시드되는 계정입니다. 로그인 폼에 직접 입력해서 사용하세요.

이메일 비밀번호
demo.admin@example.com DEMO_SEED_ADMIN_PASSWORD 값 (로컬 데모 예: fowoco-demo-1234)

⚠️ 알려진 버그: LoginPage의 "데모로 시작" 버튼은 src/store/authStore.ts의 DEMO_ACCOUNT 상수 (mini@naver.com / fowoco-demo-1234)를 그대로 호출하는데, 이 이메일은 서버가 실제로 시드하는 계정과 다릅니다. 버튼을 누르면 로그인 실패합니다 — 위 표의 계정으로 직접 로그인 폼을 채워야 합니다. DEMO_ACCOUNT를 demo.admin@example.com으로 수정하거나, 서버 시드를 DEMO_SEED_ADMIN_EMAIL=mini@naver.com으로 맞추는 두 방법 중 하나로 고쳐야 합니다 (아직 미해결).

동작 방식

  • 로그인 성공 시 서버가 access token(짧은 만료, 메모리 보관)과 refresh token(HttpOnly 쿠키, 자동 전송)을 내려줍니다.
  • 새로고침해도 로그인이 유지됩니다. RequireAuth(src/components/auth/RequireAuth.tsx)가 마운트 시 authStore.restoreSession()을 호출해 refresh 쿠키로 조용히 세션을 복원합니다. 쿠키가 없거나 만료됐으면 로그인 화면으로 보냅니다.
  • access token 만료 시 API 클라이언트(src/api/client.ts)가 401을 감지해 자동으로 refresh를 시도하고, 실패하면 로그아웃 처리합니다 (setAuthExpiredHandler 콜백).
  • 로그인 성공 시 /dashboard로 이동, 실패 시 "이메일 또는 비밀번호가 올바르지 않습니다." 에러 메시지를 표시합니다.
  • RequireAuth가 AppLayout 하위 전체 라우트(/dashboard, /workers, /tasks, /documents, /profile 등)와 /onboarding/import를 보호합니다. 비로그인 상태로 접근하면 로그인 화면(/login)으로 리다이렉트됩니다. 루트(/)는 별도의 인트로/랜딩 페이지이며 로그인 화면이 아닙니다.
  • 로그인 후에는 사이드바 하단 "로그아웃" 버튼으로 로그아웃할 수 있습니다. 그 옆 "? 도움말" 버튼을 누르면 자주 쓰는 흐름·FAQ·데모 계정 안내를 보여주는 모달이 열립니다 (Component-Library의 Modal 참고).
  • 상단바 프로필 드롭다운에는 로그인한 사용자의 이름·역할만 간단히 표시됩니다(김민지 HR 형식). 사업장명은 더 이상 헤더에 노출하지 않고, 내 프로필 화면(/profile)에서 확인합니다.
  • 설정(SettingsPage)은 제거되었습니다. 사이드바 "설정" 메뉴와 프로필 드롭다운 모두 /profile(내 프로필)로 연결됩니다. 예전에 SettingsPage 안에 있던 구성원 초대·보안 링크 재발급 기능은 현재 앱 어디에도 진입점이 없는 상태입니다 (이슈 #211 참고 — 처리 방향 결정 대기).

회원가입 · 비밀번호 재설정

  • /signup — 실제 POST /api/v1/auth/signup 연동, 서버 필드 검증 오류를 폼에 매핑해서 보여줍니다.
  • /forgot-password → /email-sent → /reset-password → /reset-complete — 비밀번호 재설정 플로우. 서버 쪽 재설정 API(server#55)가 아직 없어 정적 UI만 존재합니다.

남은 작업

  • 보안 링크 재발급 기능 복구 위치 결정 (#211)
  • 서버 비밀번호 재설정 API 연동 (server#55 대기)

Clone this wiki locally