사요자 대시보드 추가

.agent/frontend.md

@@ -32,4 +32,57 @@
 export const ui_locales = {
   A01_Home_Title: ["반갑습니다", "Welcome"],
   B04_wf1_Surface_Btn: ["지표면 분석 실행", "Run Surface Analysis"]
-};
+};
+```
+
+---
+
+## 5. 인증, 인가, 역할 및 라우팅 (Authentication, Authorization, Roles & Routing)
+
+### 5.1 세션 쿠키 기반 인증
+* **방식:** HttpOnly Secure 세션 쿠키 (localStorage 토큰 미사용)
+* **API 통신:** 모든 API 요청에 `credentials: "include"` 설정으로 쿠키 자동 전송
+* **로그아웃:** `/auth/logout` API 호출 → 서버 세션 삭제 → 쿠키 자동 제거
+* **인증 갱신:** 로그인 시 `users.auth_expires_at = NOW() + 3개월` 자동 설정
+  - 유효한 인증: `auth_expires_at > NOW()` → 바로 대시보드 이동
+  - 만료된 인증: `auth_expires_at <= NOW()` → 재인증 모달 표시
+
+### 5.1.1 역할 기반 대시보드 렌더링
+* **USER 역할:**
+  - 프로젝트 리스트 섹션
+  - 회사 정보 섹션 (회사 생성/연결 팝업)
+  - 기본정보 & 보안 섹션
+
+* **ADMIN 역할:**
+  - 프로젝트 리스트 섹션 (회사 전체 프로젝트)
+  - 회사 정보 섹션
+  - 팀원 관리 섹션
+  - 가입 요청 섹션
+  - 기본정보 & 보안 섹션
+
+* **SYSTEM_ADMIN 역할:**
+  - 리소스 현황 섹션 (CPU, MEM, DISK, 활성 사용자/프로젝트)
+  - 회사 관리 섹션 (전체 회사 리스트 + 추가/수정/삭제)
+  - 사용자 관리 섹션 (전체 사용자 + 역할 변경 + 회사 할당)
+  - 가입 요청 관리 섹션 (전체 가입 신청 + 승인/거절)
+  - 시스템 로그 섹션 (필터링 지원)
+  - 리소스 모니터링 그래프 (시계열 데이터)
+  - 기본정보 & 보안 섹션
+
+### 5.2 라우팅 가드
+* **인증 확인:** `isAuthenticated()` 함수로 세션 유효성 검사 (PROTECTED_ROUTES 진입 전)
+* **회사 연결 확인:** B02~B11 워크플로우 진입 시 `fetchDashboardMe()` 호출 → `company_id` + `status` 확인
+  - `status` 확인:
+    - NO_COMPANY: B01_Dashboard로 강제 리다이렉트 (회사 연결 필요)
+    - PENDING: B01_Dashboard로 강제 리다이렉트 (승인 대기 중)
+    - ACTIVE: 워크플로우 진입 허용
+  - `company_id` 없으면 B01_Dashboard로 리다이렉트
+* **역할 기반 라우팅:**
+  - SYSTEM_ADMIN: 모든 페이지 접근 가능
+  - ADMIN: B01_Dashboard (관리 섹션) + B02~B11 워크플로우 접근 가능
+  - USER: B01_Dashboard (사용자 섹션) + B02~B11 워크플로우 접근 가능
+* **상태 전이:**
+  - 회원가입 후 이메일 인증 완료: `users.status = 'NO_COMPANY'` (로그인 가능, 회사 미연결)
+  - 회사 생성: `users.status = 'ACTIVE'`, `company_id` 세팅, `role = 'ADMIN'`, `is_master = TRUE`
+  - 회사 참여 신청: `users.status = 'PENDING'` (관리자 승인 대기)
+  - 관리자 승인: `users.status = 'ACTIVE'`, `company_id` 세팅