kintex/docs

킨텍스 자동전시시스템 — 문서 인덱스 (문서 지도)

WISE(UIWS) 참조 — 본 문서 세트는 GUARDiA 표준 프레임워크 정본 workspace/uiws(UIMS/WISE)의 개발 문서 구성을 레퍼런스로 킨텍스에 맞게 구성했다. 목적: 처음 합류하는 개발자가 "어떤 문서가 무엇을 담는지" 한눈에 파악하고, 중복 없이 정본 문서로 이동하게 한다.

---

1. 프로젝트 한 줄 요약

킨텍스(한국국제전시장) 전시 운영 전 과정 — 부스 배치 → 부스/장치 설계 → 유틸리티 배선 → 나노바나나(Gemini) 시공 후 사진 시각화 → 공사 옥션 → 관람객·경영분석·공개사이트 — 을 AI로 자동화하는 자동전시시스템(Exhibition Automation Platform).

• 스택: React(Vite·TS) + Spring Boot 3.x(Java 17)·MyBatis + PostgreSQL(PostGIS) + Redis + 나노바나나 Python 워커
• 패키지: com.zioinfo.kintex · DB: kintex_db
• AI: Claude 기본 + 설정형 프로바이더 전환(AiTextRouter/AiConfig) — GUARDiA 표준 프레임워크 준수
• 공통 레이어(인증 2FA·시스템관리·업무기능) 레퍼런스: WISE(UIWS) workspace/uiws

---

2. 문서 지도

2-1. 기획·설계 (정본 — 해당 에이전트 경유로만 수정)

문서	담는 내용	수정 경로
PLANNING.md	시스템 기획서 v2.0 — 배경·역할/페르소나·모듈(M1~M18)·역할별 포털 분리·아키텍처 개요·나노바나나 파이프라인·리스크(R1~R12)	planner 에이전트
design.md	UI 디자인 스펙 v1.1 — 화면(SCR-*) Stitch 프롬프트·화면 흐름·컴포넌트	designer 에이전트
IMPLEMENTATION_BACKLOG.md	구현 백로그 v2.0 — Phase A~E, 모듈별 작업·담당 에이전트·완료 기준·선행 게이트(G1/G2)	kintex-impl-orchestrator
BACKLOG.md	검증(reviewer) 지적사항 티켓 목록	reviewer 에이전트
architecture/ (Phase A 예정)	애플리케이션·시스템·기술·데이터·네트워크 아키텍처 — kintex-aa/sa/ta/da/na 산출 예정	아키텍트 팀 (Phase A)

2-2. 개발·온보딩·표준 (본 세트 — WISE 참조로 신규 작성)

문서	담는 내용
README.md	(이 문서) 문서 인덱스·문서 지도
DEVELOPMENT_GUIDE.md	개발 표준 — 패키지/레이어·코딩 규약·인증(JWT+2FA/OTP)·보안 불변·브랜치/커밋(conventional)·테스트·PR
ENV_SETUP.md	개발환경 구축 — JDK17·Node·PostgreSQL+PostGIS·Redis·Python 워커 설치·실행·환경변수 목록
COMMON_CODES.md	공통코드 정의 — WISE 공통코드 체계 + 킨텍스 도메인 코드(역할·부스타입·상태·규정 심각도·옥션 상태 등)
API_GUIDE.md	API 규약 — 경로·응답 봉투·오류 코드·인증 헤더·RBAC. 상세 계약은 백엔드 계약서 링크
BUILD_DEPLOY.md	빌드/실행 개요 — gradlew·vite·나노바나나 워커·단일 산출물. 상세 CI/CD는 Phase E devops

2-3. API·워커 계약 (정본 — 경계면 단일 진실원천)

문서	담는 내용
../_workspace/01_backend_contracts.md	P0 백엔드 API 계약 — 인증·M2~M5 엔드포인트·응답 shape·오류 코드·DB 매퍼 인수 목록 (frontend·db·qa 대조용)
../tools/nanobanana/_workspace/01_worker_contract.md	나노바나나 워커 계약 — RenderJob 큐·scene 스키마·콜백

2-4. 리서치·자산

위치	담는 내용
analysis/kintex-website.md	kintex.com 전 페이지 + 주최자/참가업체 매뉴얼 분석
analysis/reroomai-source.md	ReRoomAI 소스 분석(나노바나나 image-to-image 패턴)
assets/floorplans/	홀별 평면도 JPG 15장 + CAD(트렌치 DWG, gitignore·로컬 보존)

2-5. 하네스

위치	담는 내용
../CLAUDE.md	프로젝트 마스터 컨텍스트 — 규칙·에이전트 워크플로·하네스 이력
../.claude/agents/	전문 에이전트 17종(아키텍트·공통·코어·도메인·AI·QA·devops) + 범용(planner·designer·developer·visualizer·reviewer)
../.claude/skills/	스킬(kintex-impl-orchestrator·nanobanana-visualize)

---

3. 신규 개발자 시작 순서 (권장)

1. 이 문서로 문서 지도 파악 → ../CLAUDE.md 규칙 숙지
2. ENV_SETUP.md — 로컬 개발환경 구축(JDK17·Node·PostGIS·Redis·Python 워커)
3. PLANNING.md §1~2(배경·역할) + design.md(화면) 로 도메인 이해
4. DEVELOPMENT_GUIDE.md + API_GUIDE.md + COMMON_CODES.md 로 개발 표준 습득
5. IMPLEMENTATION_BACKLOG.md 에서 자기 Phase/모듈 확인 후 착수 (Phase A 아키텍처 → B 공통 → C 코어 → D 도메인 → E 배포)

중복 회피 원칙: 기획·화면·모듈 정의는 PLANNING/design/BACKLOG가 정본이다. 본 개발 문서 세트는 그 내용을 재서술하지 않고 링크·요약만 한다. 아키텍처(app/system/tech/data/network)는 Phase A 아키텍트 산출물(architecture/)이 정본이며 본 세트에서 생성하지 않는다.