Repository navigation
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) |
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 대기)