zio/kintex
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
63386b62aa
kintex/CLAUDE.md
zio 89d59d3093 feat(phase-b): WISE 공통/시스템관리 레이어 + 2FA/OTP + MDI 셸 표준 
공통레이어(PLANNING §5B, WISE/UIWS 이식):
- 인증강화 2FA: TotpService(RFC6238)·OTP 등록/검증/초기화·로그인 실패 잠금·admin 비번 env 주입(admin123 시드 없음). 기존 JWT/RBAC 무수정, security 패키지 레이어만 추가
- 시스템관리: 사용자·역할/권한·공통코드·메뉴·시스템설정·감사(@Audited AOP). SystemAccessGuard(전역 ADMIN/홀매니저) — EventAccessGuard와 직교 이중 RBAC
- 공통 업무기능: worklog·schedule·message·notice·opinion·meeting·report·notification(단일 채널)·stats·search
- 스키마 V7(시스템관리·보안)·V8(공통 업무모듈) 멱등, V1~V6 불변

design.md v1.2: MDI 셸 표준 §2.7(탭바·다중문서·상태보존·세션복원·단축키·역할별)
CLAUDE.md: G1·G2 게이트 해소 반영

backend gradlew build·frontend tsc EXIT 0.

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

7.3 KiB
Raw Blame History

KINTEX AI 시스템 (킨텍스 전시관리 AI)

킨텍스(KINTEX, 한국국제전시장) 전시 운영 전 과정을 AI로 자동화하는 시스템 프로젝트. 부스 배치 설계 → 인테리어/장치 공사 → 네트워크 배선 → 전기/조명 설계 → 나노바나나(Gemini 이미지 생성)로 시공 후 결과 사진 시각화까지를 하나의 파이프라인으로 다룬다.

프로젝트 구조

kintex/
├── CLAUDE.md                  # 이 파일 — 프로젝트 규칙과 에이전트 오케스트레이션
├── .claude/
│   ├── agents/                # 서브에이전트 정의 (기획/디자인/개발/시각화/검증)
│   └── skills/                # 스킬 (나노바나나 연동 등)
├── docs/
│   ├── analysis/              # 킨텍스 웹사이트 분석, ReRoomAI 소스 분석
│   ├── PLANNING.md            # 시스템 기획서 (기획 에이전트 산출물)
│   └── design.md              # UI 디자인 스펙 — Google Stitch 전달용 (디자인 에이전트 산출물)
├── tools/
│   └── nanobanana/            # Gemini 이미지 생성(나노바나나) 연동 모듈
└── src/                       # 서비스 구현 (백엔드/프론트) — 이후 단계

기술 스택 (확정 2026-07-11 · 사용자 지정)

레이어 기술
프론트엔드 React 18/19 + Vite + TypeScript (반응형: 데스크톱=설계/에디터, 모바일=조회·승인·현장)
백엔드 Spring Boot 3.x (Java 17) + MyBatis — REST + WebSocket(STOMP), 룰 엔진·배치/배선 엔진
DB PostgreSQL (+ PostGIS) — 부스 폴리곤·트렌치 포인트·배선 LineString 공간 데이터
비동기 Redis 작업 큐 (RenderJob·서류·알림)
이미지 생성 나노바나나 Python 워커 사이드카 (tools/nanobanana, google-genai + gemini-3.1-flash-image-preview) — Spring이 큐로 트리거, 결과는 오브젝트 스토리지 + WebSocket 완료 푸시
인증 행사 단위 RBAC(JWT)

GUARDiA 표준 프레임워크(Spring Boot 3.5 + React 19 + MyBatis + PostgreSQL)와 정렬. 상세 아키텍처는 docs/PLANNING.md §8. 신규 코드는 이 스택을 따른다 — developer 에이전트는 src/ 구현 시 백엔드 Spring Boot/MyBatis, 프론트 React(Vite)를 사용하고, 나노바나나 호출은 tools/nanobanana Python 워커 모듈만 경유한다.

에이전트 워크플로

작업은 아래 순서의 서브에이전트 체인으로 진행한다. 각 에이전트는 .claude/agents/에 정의되어 있다.

  1. planner (기획 에이전트) — docs/analysis/의 리서치를 근거로 docs/PLANNING.md 작성/갱신
  2. designer (디자인 에이전트) — PLANNING.md를 근거로 docs/design.md 작성 (Stitch에 바로 붙여넣을 화면별 프롬프트 포함)
  3. developer (개발 에이전트) — PLANNING.md/design.md를 근거로 src/ 구현
  4. visualizer (시각화 에이전트) — 나노바나나 스킬로 부스/공사 결과 이미지 생성 파이프라인 담당
  5. reviewer (검증 에이전트) — 산출물 교차 검증 (기획-디자인-구현 정합성)

새 기능 요청이 오면: planner로 기획 반영 → designer로 화면 반영 → developer 구현 → reviewer 검증 순으로 진행할 것.

규칙

  • 모든 문서는 한국어로 작성한다. 코드 식별자/커밋 메시지는 영어.
  • 기획/디자인 문서를 수정할 때는 반드시 해당 에이전트를 통해 수정한다 (직접 수정 금지).
  • 나노바나나 호출은 tools/nanobanana/ 모듈만 사용한다. API 키는 환경변수 GEMINI_API_KEY.
  • 파일 삭제 전에는 반드시 사용자에게 확인받는다.
  • 도메인 용어: 부스(booth), 장치공사(booth construction), 반입/반출(move-in/move-out), 주최자(organizer), 참가업체(exhibitor), 관람객(visitor).

참조 자산

  • docs/PLANNING.md — 시스템 기획서(v1.2, M1~M9 모듈·나노바나나 파이프라인). 기획 변경은 planner 경유.
  • docs/design.md — UI 디자인 스펙(14화면 Stitch 프롬프트). 디자인 변경은 designer 경유.
  • docs/IMPLEMENTATION_BACKLOG.md — 구현 백로그(Phase 0~5, 모듈별 작업·담당·의존)
  • docs/analysis/kintex-website.md — kintex.com 전체 페이지 분석
  • docs/analysis/reroomai-source.md — ReRoomAI 소스 분석(나노바나나 image-to-image·보존/교체 프롬프트 차용)
  • docs/BACKLOG.md — 검증 에이전트 지적사항 티켓 목록
  • stitch_kintex_ai_system_architect/ — Stitch 생성 화면 18종·DESIGN.md 3종(designer 학습·정합화 참조)

하네스: 구현 (kintex-impl-orchestrator)

목표: 킨텍스 자동전시시스템(Exhibition Automation Platform) — PLANNING v2.0(부스 코어 M2~M5 + 도메인 M10~M18 + WISE/UIWS 공통·시스템관리 레이어 §5B, 6역할 웹/모바일 분리)을 React(Vite)+Spring Boot 3.x(Java17)+MyBatis+PostgreSQL(PostGIS)+Redis+나노바나나 Python 워커로 구현. AI=Claude 기본+설정형 전환(AiTextRouter/AiConfig). 공통 프레임워크 레퍼런스=WISE(UIWS workspace/uiws).

트리거: 킨텍스 구현·부스 배치/설계/배선/시각화·옥션/입찰/견적서·관람객/등록/배지/리드·경영분석/BI·CMS/공개 홍보 사이트·관리자 백오피스·공통기능/시스템관리/2FA·UIWS/WISE 이식·역할별 웹/모바일·AI(Claude)·아키텍처(AA/SA/TA/DA/NA)·src 구현·배포·다시 실행·특정 모듈만 요청 시 kintex-impl-orchestrator 스킬을 사용하라.

에이전트(전문 20 + 범용): 거버넌스 kintex-pm·dev-pm·pmo / 아키텍트 kintex-aa·sa·ta·da·na / 공통 kintex-common-dev / 코어 kintex-backend-dev·frontend-dev·db-engineer / 도메인 kintex-bidding-dev·visitor-dev·cms-dev·bi-dev·admin-dev / AI·시각화 kintex-ai-dev·visualizer / 품질·배포 kintex-qa·devops-dev + planner·designer·reviewer

선행 게이트: G1·G2 모두 해소 — G1 나노바나나 Gemini 라이브(워커 env GEMINI_API_KEY+NANOBANANA_LIVE=1, gemini-3.1-flash-image-preview, 키 마스킹·미커밋). G2 개발 kintex.zioinfo.co.kr(DNS 해소 → 101.79.17.164, 포트 8021, PostGIS+Redis+Flyway) / 운영 kintex.wise.ai.kr(후속). CI/CD 라이브(deploy_server kintex 블록·Gitea webhook #47·자동배포 E2E 검증).

확보 자산: docs/assets/floorplans/ — 홀별 평면도 JPG 15장 + CAD(제1전시장 "평면,트렌치.dwg" 포함) → PLANNING R4(트렌치·CAD) 해소. 평면도 입력 포맷 = CAD(DWG) + JPG. CAD zip은 gitignore(로컬 보존).

변경 이력:

날짜 변경 내용 대상 사유
2026-07-11 구현 하네스 초기 구성 — 전문 에이전트 6종 + kintex-impl-orchestrator + 구현 백로그 전체 범용 에이전트만 존재 → 스택 확정 후 실제 구현 조율 팀 구성
2026-07-11 v2.0 재구성 — 자동전시시스템 확장(PLANNING v2.0). 신규 에이전트 11종(아키텍트 5·공통 1·도메인 5·AI 1) + 오케스트레이터·백로그 v2.0(Phase A 아키텍처→B 공통레이어→C 부스코어→D 도메인→E 배포) 전체 스코프 확장(전시 전기능·경영분석·CMS·관리자·역할분리·공사 옥션·WISE 공통레이어·AI Claude 전환)