다른 공급사 소유(또는 없는) session_id 로 /chat 진입 시 일반 에러+재시도 대신 '잘못된 접근입니다.' 토스트를 띄우고 협상 목록(/list)으로 돌려보낸다. 로그인은 유효하므로 로그아웃하지 않는다(인증≠인가 — 로그아웃은 401/403/43x 토큰 오류에서만, 기존 인터셉터 동작 유지). - useChatController: 진입 로드(init/messages) 에러가 NEGO_FORBIDDEN(1300)/ NEGO_NOT_FOUND(1304) 이면 토스트 후 /list 로 replace 이동(ref 가드로 1회). 리다이렉트 동안 스피너 유지(ErrorPage 깜빡임 방지), 그 외 서버/네트워크 에러는 기존 ErrorPage(재시도) 유지. - chat.queries: init/messages 쿼리에 retry 추가 — 1300/1304 는 재시도해도 안 바뀌어 즉시 실패시켜 목록 복귀 지연 제거(그 외 에러는 기존 재시도 유지). Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com> |
||
|---|---|---|
| .. | ||
| public | ||
| src | ||
| .dockerignore | ||
| .env.sample | ||
| .gitignore | ||
| Dockerfile | ||
| eslint.config.js | ||
| index.html | ||
| package-lock.json | ||
| package.json | ||
| README.md | ||
| tsconfig.app.json | ||
| tsconfig.json | ||
| tsconfig.node.json | ||
| vite.config.ts | ||
Negosium Front
React + TypeScript + Vite 기반 프론트엔드.
기술 스택
- 빌드/런타임: Vite 8, React 19, TypeScript 6
- 상태/데이터: TanStack Query(서버 상태), Zustand(클라이언트 상태)
- HTTP: axios
- 에디터: Slate (
slate/slate-react/slate-history) - 스타일: Tailwind CSS v4 (
@tailwindcss/vite) - 경로 alias:
@/*→src/*
요구 사항
- Node.js
20.19+또는22.12+(Vite 8 요구 사항, 개발은 24.x 기준) - npm
로컬 세팅
# 1. 프로젝트로 이동
cd front
# 2. 의존성 설치
npm install
# 3. env 파일 준비 (.env.sample 복사 후 값 채우기)
cp .env.sample .env.local
# 4. 로컬 개발 서버 실행 (기본 http://localhost:5173)
npm run dev
백엔드 API 는 negosium 백엔드(기본
http://localhost:9300)를 바라본다..env.local의VITE_API_BASE_URL로 조정한다.
환경 변수 (.env)
Vite 의 mode 기능으로 환경별 env 파일을 매핑한다. 클라이언트 번들에 노출되는 변수는 반드시 VITE_ 접두사를 붙인다.
| 파일 | 사용 시점 | git |
|---|---|---|
.env.sample |
템플릿 (키 목록 공유용) | ✅ 커밋 |
.env.local |
로컬 개발 (npm run dev, Vite 가 자동 로드) |
🚫 ignore |
.env.dev |
--mode dev (개발 서버) |
🚫 ignore |
.env.prod |
--mode prod (운영) |
🚫 ignore |
새 환경 세팅 시 .env.sample 을 복사해 환경별 파일을 만들고 값을 채운다. 코드에서는 import.meta.env.VITE_API_BASE_URL 처럼 접근한다.
참고: Vite 8 부터
local은 모드 이름으로 사용할 수 없다(.env.local의.local접미사와 충돌). 그래서 로컬 개발은 별도 모드 없이 기본vite(mode:development)로 실행하고, 로컬 값은.env.local에 둔다 — Vite 는.env.local을 모든 모드에서 항상 자동 로드한다(개인 로컬 오버라이드 용도). 우선순위는.env.[mode]>.env.local>.env이므로, 각 env 파일에 동일한 키 집합을 유지하면 mode 파일 값이 항상 이긴다. 특정 mode 에만 있어야 할 키를.env.local에 두면 다른 mode 로 새어 들어갈 수 있으니 주의.
실행 / 빌드
--mode <name> 으로 .env.[name] 파일이 선택된다(로컬은 모드 없이 .env.local 자동 로드).
npm run dev # 로컬 개발 서버 (mode: development → .env.local 자동 로드)
npm run dev:dev # 개발 서버를 dev 환경 변수로 실행 (mode: dev → .env.dev)
npm run build # 운영 빌드 (mode: prod → .env.prod), build:prod 와 동일
npm run build:dev # 개발 빌드 (mode: dev → .env.dev)
npm run build:prod # 운영 빌드 (mode: prod → .env.prod)
npm run preview # 직전 빌드 결과 로컬 미리보기
npm run lint # ESLint