History

Mina Choi 0f10b6a70f [feat] negodata·공급사포털: 상품 필드 숨김 설정·용어 카탈로그 확장·로그인 전 브랜딩·모바일 대응 - 회사 설정 hidden_fields 신설: 상품 목록·등록폼·엑셀 양식에서 감추고 목표가 후보에서도 제외 - 용어 카탈로그 9→37개(상품·협력사·견적 그룹), 목록·폼·엑셀 헤더 배선 - 엑셀 '최저한도' → '인터넷 최저가' 표기 정정(구양식 헤더는 alias 유지), 공급사 컬럼 검증 유지 - 목표가 산정내역에 적용 모드·숨김 필드 반영, 목표가 상한 라벨에 산식(상품단가×2) 표기 - 공급사 포털: 초청 링크 session_id 로 로그인 전 회사 브랜딩 조회(무인증 엔드포인트), 기본 브랜드 negotium 워드마크, negotium·AI O2O 크레딧 표기 - 목록 테이블 뷰포트 기준 전환·툴바 줄바꿈·협상현황 카드뷰로 모바일/태블릿 대응 - 이용안내 FAQ 탭 추가, 이용안내·회사설정 탭 URL 쿼리 동기화 및 빠른이동 등록		2026-07-23 11:29:35 +09:00
..
public	[update] 상단의 문구 및 아이콘 변경	2026-06-24 09:46:29 +09:00
src	[feat] negodata·공급사포털: 상품 필드 숨김 설정·용어 카탈로그 확장·로그인 전 브랜딩·모바일 대응	2026-07-23 11:29:35 +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