Skip to content

Auth UI Design

wcorn edited this page Apr 5, 2026 · 1 revision

화면 설계: 인증 모듈

이 문서는 인증 모듈(로그인·로그아웃) 의 화면만 다룬다. 로그인 이후 진입하는 메인 대시보드(/home) 화면은 메인 대시보드에서 정의한다.

1. 페이지 구성

페이지 경로 인증 설명
로그인 /login 불필요 아이디/비밀번호 입력

로그인 성공 후 이동할 /home 대시보드는 메인 대시보드 참조.

2. 화면 흐름

┌──────────┐    로그인 성공     ┌──────────────┐
│          │──────────────────▶│              │
│  로그인   │                   │  메인 대시보드 │
│  /login  │◀──────────────────│    /home     │
│          │    로그아웃         │              │
└──────────┘                   └──────────────┘
      ▲                              │
      │        AT 만료 + RT 만료      │
      └──────────────────────────────┘
  • 미인증 상태로 보호된 경로 접근 시 → /login으로 리다이렉트
  • 인증 상태로 /login 접근 시 → /home으로 리다이렉트
  • 로그인 성공 시 → /home으로 이동
  • AT 만료 시 → 자동으로 /api/auth/reissue 호출 (사용자 인지 없이 갱신)
  • RT도 만료 시 → /login으로 리다이렉트

3. 로그인 페이지

┌─────────────────────────────────────┐
│                                     │
│                                     │
│           ┌───────────────┐         │
│           │     orino     │         │
│           │               │         │
│           │  ┌──────────┐ │         │
│           │  │ 아이디    │ │         │
│           │  └──────────┘ │         │
│           │  ┌──────────┐ │         │
│           │  │ 비밀번호  │ │         │
│           │  └──────────┘ │         │
│           │               │         │
│           │  ┌──────────┐ │         │
│           │  │  로그인   │ │         │
│           │  └──────────┘ │         │
│           │               │         │
│           └───────────────┘         │
│                                     │
└─────────────────────────────────────┘

요소

요소 타입 설명
로고 텍스트 "orino"
아이디 input (text) placeholder: "아이디"
비밀번호 input (password) placeholder: "비밀번호"
로그인 버튼 button Enter 키로도 제출 가능
에러 메시지 텍스트 로그인 실패 시 폼 하단에 표시

4. FE 인증 처리

4.1 Access Token 관리

  • 로그인 응답에서 받은 AT를 메모리(JS 변수)에 저장
  • API 요청 시 Authorization: Bearer {AT} 헤더 자동 첨부
  • 페이지 새로고침 시 AT 소실 → /api/auth/reissue로 재발급

4.2 Axios 인터셉터

요청 인터셉터: AT를 헤더에 첨부
응답 인터셉터: 401 응답 시 → reissue 호출 → 성공하면 원래 요청 재시도
                                          → 실패하면 /login으로 이동

4.3 라우트 가드

타입 동작
PrivateRoute 인증 안 됨 → /login 리다이렉트
PublicRoute 인증 됨 → /home 리다이렉트

Clone this wiki locally