History

hbyang 7e0f88ca03 [fix] 견적 자동마감 동시성·정합성 + 프론트 안정화 (코드리뷰 후속) 백엔드 close_and_decide 경로: - 동시 이중 마감 가드: 마감 판정 전 원자적 CLOSED 선점(claim)으로 두 크론 잡·수동마감 경합 직렬화 - 재생성 실패 표면화: regenerate_next_round 결과 검사 → 실패 시 REGEN_FAILED 반환(체인 끊김 은폐 방지) - 차수 충돌 방지: 다음 라운드 = 체인 최신 round+1(chain_max_round 기준) - 재생성 사유 집계 정밀화: 미참여/동가를 양성 표식으로 구분(단독낙찰·거부 오집계 제거) - 재생성 라운드 최소 협상기간 하한(즉시 재마감 캐스케이드 방지) - 잡 루프 per-item 예외 격리(한 건 실패가 배치 전체를 멈추지 않음) 프론트: - useChatController: 무권한 가드를 sessionId 별로 추적해 세션 변경 시 자연 해제 - useScrollLock: 마지막 해제를 rAF 로 지연해 재마운트 사이 일시적 잠금 해제 방지 - quotation 상세 쿼리 placeholderData 로 라운드 전환 중 시트 유지 테스트: - 신규 test_close_and_decide_fixes.py(동시성·차수·집계·기간 하한 검증) - conftest 결함 수정(존재하지 않는 tbl_account TRUNCATE 제거, companies.status 명시) - stale 테스트 갱신(test_quotation_create 를 타입드 Req/신규 응답 형식에 맞게 재작성) Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>		2026-06-25 17:22:21 +09:00
..
public	[update] 상단의 문구 및 아이콘 변경	2026-06-24 09:46:29 +09:00
src	[fix] 견적 자동마감 동시성·정합성 + 프론트 안정화 (코드리뷰 후속)	2026-06-25 17:22:21 +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	[update] 상단의 문구 및 아이콘 변경	2026-06-24 09:46:29 +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

README.md

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