forked from baron/baron-sso
e4680b0fe8
- switch adminfront and devfront to vite 8 - fix devfront TypeScript baseline build errors - require Node.js 24 LTS or newer in package metadata and docs Co-Authored-By: First Fluke <our.first.fluke@gmail.com>
30 lines
1.1 KiB
Markdown
30 lines
1.1 KiB
Markdown
# Admin Front (React 19 + Vite)
|
|
|
|
관리자 포털을 위한 React/Vite 기반 웹입니다. 이슈 #60 스펙을 바탕으로 라우팅, 서버 상태, 스타일 토큰을 세팅했고 특정 벤더에 종속되지 않는 IDP 연동 훅 포인트를 남겨두었습니다.
|
|
|
|
## 주요 스택
|
|
- React 19, Vite 8, TypeScript(strict)
|
|
- React Router v6 (data router)
|
|
- TanStack Query v5
|
|
- Tailwind CSS v3 + shadcn/ui 컴포넌트(seed: Button/Card/Badge/Input/Table/Avatar)
|
|
- Axios 클라이언트 스텁: Bearer + `X-Tenant-ID` 헤더 주입 준비
|
|
- React Hook Form + Zod (추가 예정)
|
|
- Biome (formatter/linter)
|
|
|
|
## 실행
|
|
```bash
|
|
npm install
|
|
npm run dev
|
|
```
|
|
|
|
## 구조
|
|
- `src/app`: 라우터, QueryClient 등 전역 설정
|
|
- `src/components/layout`: App 레이아웃/네비게이션
|
|
- `src/features`: dashboard, clients, audit, auth 등 화면 스캐폴딩
|
|
- `src/lib/apiClient.ts`: Axios 인스턴스(토큰/테넌트 헤더 주입 스텁)
|
|
|
|
## 다음 작업 가이드
|
|
- IDP 중립 Auth 레이어 추가 후 관리자 역할 가드/세션 TTL 적용
|
|
- 테넌트 선택 UI 추가 → `X-Tenant-ID` 헤더에 반영
|
|
- shadcn/ui 도입 및 폼/테이블 컴포넌트 연결
|