o2o-negosium-original/frontend
Mina Choi e1e519c20c [fix] negosium/backend·front: 마감된 협상이 '협상 대기'로 보이던 문제 + 종료 협상 결과 보기
- 목록 상태를 파생 계산(_effective_status): 견적 마감/마감시간 경과 + 협상생성(1) → 미참여(4).
  표시·상태필터·기본정렬 그룹에 같이 적용해 탭·KPI 카운트가 배지와 어긋나지 않게 함(DB 쓰기 없음).
  마감 일괄정리 이후 생긴 세션이 '협상 대기'에 남아 눌러도 마감 에러가 나던 헛클릭 제거.
- 미참여·협상거부 세션도 채팅 init 허용 → '결과 보기'로 지난 대화 열람. 대화 재개는 send 가
  협상중만 허용해 읽기 전용. 열 게 없는 건은 목록 has_chat(대화 이력 유무)으로 버튼 자체를 감춤.
- 종료 건은 참여 API 를 타지 않고 채팅으로 직행, 채팅 액션바는 목록 복귀만 남겨 입력 잠금.
- chain_max_round 가 단일컬럼 select 결과를 행 튜플로 읽어 매 목록 호출마다 예외 → 체인 최대차수
  0 → 옛 라운드에도 재협상 요청이 뜨고 통과되던 버그 수정(+ABC 에 중복된 죽은 구현 제거).
2026-08-10 13:57:30 +09:00
..
public [update] 상단의 문구 및 아이콘 변경 2026-06-24 09:46:29 +09:00
src [fix] negosium/backend·front: 마감된 협상이 '협상 대기'로 보이던 문제 + 종료 협상 결과 보기 2026-08-10 13:57:30 +09:00
.dockerignore feat(docker): negosium 프론트 컨테이너화(:3300) + backend CORS 3300 허용 2026-06-18 15:50:04 +09:00
.env.sample update(front): front 폴더명 frontend로 변경 2026-06-18 11:30:26 +09:00
.gitignore [feat] vite 캐시 제거 2026-06-19 13:36:56 +09:00
Dockerfile feat(docker): negosium 프론트 컨테이너화(:3300) + backend CORS 3300 허용 2026-06-18 15:50:04 +09:00
eslint.config.js update(front): front 폴더명 frontend로 변경 2026-06-18 11:30:26 +09:00
index.html [fix] negosium·negodata·landing: 채팅 진입·부가정보 저장 오류 수정, 모바일 여백·스크롤·노치 대응 2026-07-23 12:50:40 +09:00
package-lock.json feat(frontend): 공통 토스트(sonner)·모달 컴포넌트 추가 2026-06-18 13:12:16 +09:00
package.json feat(frontend): 공통 토스트(sonner)·모달 컴포넌트 추가 2026-06-18 13:12:16 +09:00
README.md update(front): front 폴더명 frontend로 변경 2026-06-18 11:30:26 +09:00
tsconfig.app.json update(front): front 폴더명 frontend로 변경 2026-06-18 11:30:26 +09:00
tsconfig.json update(front): front 폴더명 frontend로 변경 2026-06-18 11:30:26 +09:00
tsconfig.node.json update(front): front 폴더명 frontend로 변경 2026-06-18 11:30:26 +09:00
vite.config.ts update(front): front 폴더명 frontend로 변경 2026-06-18 11:30:26 +09:00

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.localVITE_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