zio/kintex
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
eccbeb1337
kintex/src/frontend/README.md
zio eccbeb1337 feat(v2.0): Phase A 아키텍처 + WISE 개발문서 + PM/PMO + DB 계층 + 프론트 착수 
- 거버넌스: kintex-pm·dev-pm·pmo 에이전트
- Phase A 아키텍처 5종: docs/architecture/{app,system,tech,data,network}.md (성문화·NFR·SRID0 공간표준·M16 스타스키마·보안영역)
- WISE(UIWS) 참조 개발문서 6종: README·DEVELOPMENT_GUIDE·ENV_SETUP·COMMON_CODES·API_GUIDE·BUILD_DEPLOY
- DB 계층: PostGIS 스키마 V1~V6(홀·트렌치 가정그리드·GiST) + MyBatis 매퍼 5종(ST_* 공간쿼리) + Flyway. gradlew build SUCCESS
- 프론트 착수: React/Vite 스캐폴드 + design.md 토큰 + SCR-01 로그인·SCR-03 부스 에디터. tsc/vite build EXIT 0
- R-T1 수정: 나노바나나 워커 큐키 kintex:renderjob:queue 통일(백엔드 정합, silent no-op 방지)
- 도메인/게이트: G2 해소(dev kintex.zioinfo.kr·prod kintex.wise.ai.kr), CLAUDE.md 로스터 20종

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-07-11 18:10:01 +09:00

1.4 KiB
Raw Blame History

KINTEX AI 전시관리 — Frontend

React 18 + Vite 5 + TypeScript. 백엔드(Spring Boot :8080) 계약(_workspace/01_backend_contracts.md) 기반.

개발

npm install
npm run dev        # Vite 개발 서버 :5173 (/api·/ws → :8080 프록시)
npm run typecheck  # tsc -b (타입 체크)
npm run build      # tsc -b && vite build

.env.example → .env 복사. VITE_BACKEND_ORIGIN으로 백엔드 오리진 지정(기본 http://localhost:8080).

구조

  • src/styles/tokens.css — 디자인 토큰 단일 출처(design.md §1). 하드코딩 금지, 이 변수만 참조.
  • src/api/ — client(JWT·봉투·오류코드), endpoints(계약 래퍼), types(응답 shape), websocket(STOMP RenderJob).
  • src/store/authStore.ts — 인증/워크스페이스 상태(zustand).
  • src/components/ui/ — StatusBadge·DdayChip·AiLabel·Button·AiImage(워터마크 상시)·States.
  • src/components/layout/AppShell.tsx — 인증 셸(사이드바+상단바).
  • src/screens/login/ — SCR-01 로그인·워크스페이스·초대(등록업체 차단).
  • src/screens/floorplan/ — SCR-03 배치 에디터(SVG 캔버스·AI 자동배치·검증).

원칙

  • 백엔드 응답 shape과 정확히 일치. 불일치는 _workspace/02_frontend_progress.md에 기록.
  • AI 생성 이미지 워터마크·고지문 제거 불가. 접근성 WCAG AA.
  • 캔버스 편집은 데스크톱 전용(모바일은 뷰어+승인).