킨텍스 자동전시시스템 — 문서 인덱스 (문서 지도)
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·워커 계약 (정본 — 경계면 단일 진실원천)
2-4. 리서치·자산
2-5. 하네스
| 위치 |
담는 내용 |
../CLAUDE.md |
프로젝트 마스터 컨텍스트 — 규칙·에이전트 워크플로·하네스 이력 |
../.claude/agents/ |
전문 에이전트 17종(아키텍트·공통·코어·도메인·AI·QA·devops) + 범용(planner·designer·developer·visualizer·reviewer) |
../.claude/skills/ |
스킬(kintex-impl-orchestrator·nanobanana-visualize) |
3. 신규 개발자 시작 순서 (권장)
- 이 문서로 문서 지도 파악 →
../CLAUDE.md 규칙 숙지
ENV_SETUP.md — 로컬 개발환경 구축(JDK17·Node·PostGIS·Redis·Python 워커)PLANNING.md §1~2(배경·역할) + design.md(화면) 로 도메인 이해DEVELOPMENT_GUIDE.md + API_GUIDE.md + COMMON_CODES.md 로 개발 표준 습득IMPLEMENTATION_BACKLOG.md 에서 자기 Phase/모듈 확인 후 착수 (Phase A 아키텍처 → B 공통 → C 코어 → D 도메인 → E 배포)
중복 회피 원칙: 기획·화면·모듈 정의는 PLANNING/design/BACKLOG가 정본이다. 본 개발 문서 세트는 그 내용을 재서술하지 않고 링크·요약만 한다. 아키텍처(app/system/tech/data/network)는 Phase A 아키텍트 산출물(architecture/)이 정본이며 본 세트에서 생성하지 않는다.
zio
ca971c1cae