kintex/.claude/skills/kintex-impl-orchestrator/SKILL.md
zio 9987d958db feat(v2.0): 자동전시시스템 하네스 재구성 + PLANNING v2.0 + 백엔드 스캐폴드 + 평면도 자산
PLANNING v2.0: 자동전시시스템 재정의, 6역할 웹/모바일 분리, 도메인 M10~M18(옥션 M15·관람객 M10·마케팅/공개사이트 M12·BI M16(운영사 ROI 포함)·CMS M17·관리자 M18), WISE/UIWS 공통·시스템관리 레이어 §5B(2FA OTP), 옥션/견적서/역경매, M2/M3 3안 생성→선택/병합. design.md v1.1(Stitch 정합·SCR 매핑).

하네스 재구성: 전문 에이전트 17종(아키텍트 AA·SA·TA·DA·NA / 공통 common-dev / 코어 backend·frontend·db / 도메인 bidding·visitor·cms·bi·admin / AI ai-dev·visualizer / QA·devops) + kintex-impl-orchestrator v2.0(Phase A~E) + IMPLEMENTATION_BACKLOG v2.0 + CLAUDE.md.

백엔드 스캐폴드: Spring Boot 3.2.5(com.zioinfo.kintex) + JWT/RBAC + WebSocket + 버전형 룰엔진 + M2~M5 컨트롤러(M3 사전검증·M4 견적·M5 RenderJob 실구현, 공간경로 501 대기). compileJava SUCCESS.

자산: 평면도 JPG 15장 + 매니페스트(R4 트렌치·CAD 해소). CAD 93MB·build는 gitignore.

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

6.3 KiB

name description
kintex-impl-orchestrator 킨텍스 자동전시시스템 구현 오케스트레이터. React(Vite)+Spring Boot 3.x(Java17)+MyBatis+PostgreSQL(PostGIS)+Redis+나노바나나 Python 워커로 PLANNING v2.0(부스 코어 M2~M5 + 도메인 M10~M18 + UIWS/WISE 공통·시스템관리 레이어 §5B)을 구현하도록 아키텍트·공통·코어·도메인·AI·QA·DevOps 전문 에이전트 팀을 조율한다. "킨텍스 구현/개발", "부스 배치·설계·배선·시각화", "옥션/입찰/견적서", "관람객·등록·배지·리드", "경영분석/BI", "CMS/공개 홍보 사이트", "관리자 백오피스", "공통기능/시스템관리/2차인증 OTP", "UIWS/WISE 이식", "역할별 웹/모바일", "AI 기능(Claude)", "아키텍처(AA/SA/TA/DA/NA)", "Stitch 화면 이식", "src 구현", "구현 백로그", "배포", "다시 실행/재실행/업데이트/보완", "특정 모듈만(M2~M18)" 요청 시 반드시 이 스킬을 사용하라. (기획=planner, 디자인=designer 경유.)

킨텍스 자동전시시스템 — 구현 오케스트레이터

docs/PLANNING.md(v2.0)·docs/design.md·docs/IMPLEMENTATION_BACKLOG.md를 근거로 구현(src/)을 에이전트 팀으로 조율한다. 실행 모드: 에이전트 팀. 모든 Agent 호출은 model: "opus".

확정 스택 (불변)

React 18/19(Vite·TS) · Spring Boot 3.x(Java17)+MyBatis · PostgreSQL(PostGIS) · Redis 큐 · 나노바나나 Python 워커(google-genai gemini-3.1-flash-image-preview). AI 지능=Claude 기본+설정형 모델 전환(AiTextRouter/AiConfig, Ollama 폴백). 레퍼런스 공통 프레임워크=WISE(UIWS, workspace/uiws).

에이전트 로스터

그룹 에이전트 역할
아키텍트(설계·표준·검수) kintex-aa·kintex-sa·kintex-ta·kintex-da·kintex-na 앱/시스템/기술/데이터/네트워크 아키텍처·NFR·표준
공통 레이어 kintex-common-dev WISE(UIWS) 시스템관리+공통 업무기능+JWT/2FA(OTP) 이식(전 모듈 선행)
코어 kintex-backend-dev·kintex-frontend-dev·kintex-db-engineer Spring/MyBatis API·React·PostGIS 스키마
도메인 kintex-bidding-dev(M15 옥션)·kintex-visitor-dev(M10 관람객)·kintex-cms-dev(M12/M17 CMS·공개사이트)·kintex-bi-dev(M16 경영분석)·kintex-admin-dev(M18 관리자) 도메인 서브시스템(백+프론트 슬라이스)
AI·시각화 kintex-ai-dev(Claude 기반 AI)·visualizer(나노바나나 워커) AI 지능·시공 예상 이미지
품질·배포 kintex-qa(general-purpose)·kintex-devops-dev 점진 경계면 QA·빌드/CI/CD
기획·디자인·검증 planner·designer·reviewer PLANNING·design.md·교차 검증

Phase 0: 컨텍스트·게이트

  1. _workspace/·src/·docs/IMPLEMENTATION_BACKLOG.md 확인 → 초기/부분 재실행/새 실행 판별.
  2. 선행 게이트: G1 나노바나나(Gemini) 외부 호출 승인(PLANNING R12) — M5 실호출·배포 전. G2 배포 대상 서버·포트(GUARDiA 인프라와 별개 도메인). 미확정 시 해당 트랙 코드/구조만.

Phase A: 아키텍처·거버넌스 (아키텍트 팀 + reviewer)

kintex-aa/sa/ta/da/na가 docs/architecture/에 앱·시스템·기술·데이터·네트워크 아키텍처·NFR·표준·전사 ERD를 확정. 이후 전 구현이 이 표준을 준수. reviewer가 PLANNING 정합 검증. (설계 산출물이므로 병렬, 배리어 후 다음 Phase.)

Phase B: 공통/시스템관리 레이어 (선행 기반, PLANNING §5B)

전 도메인 모듈의 선행 기반이다. kintex-common-dev가 WISE(UIWS) 이식: 인증(JWT+2FA OTP·실패 잠금·admin env 주입)·시스템관리(사용자·RBAC·공통코드·메뉴·감사로그·설정)·공통 업무기능(worklog·schedule·message·stats·notice·opinion·search·meeting·report·notification·audit). kintex-db-engineer(TB_* 멱등 스키마)·kintex-admin-dev(백오피스 정합, 중복 제거)·kintex-backend-dev(인증 코어) 협업. kintex-qa 점진 검증(2FA 왕복·RBAC·비번 미노출).

Phase C: P0 부스 코어 (M2·M3·M4·M5)

공통 레이어 위에서 부스 시공 코어 구현(기존 백로그 P0). db→backend→frontend/visualizer→qa 파이프라인, 모듈 독립 병렬. AI 자동배치·3안 생성/병합은 kintex-ai-dev(Claude), 시공 예상 이미지는 visualizer(G1 게이트). Stitch 화면 이식은 designer SCR 매핑 기준 kintex-frontend-dev.

Phase D: P1 도메인 (역할별 포털)

병렬 도메인 파이프라인 — M15 옥션(kintex-bidding-dev: AI자료 열람→견적서→역경매→낙찰), M10 관람객(kintex-visitor-dev: 등록·배지·리드·매칭·wayfinding), M12/M17 마케팅·공개사이트·CMS(kintex-cms-dev: SEO·다국어), M16 경영분석(kintex-bi-dev), M18 관리자(kintex-admin-dev). 각 도메인 dev가 백+프론트 슬라이스, db-engineer(스키마)·ai-dev(AI 기능)·qa(점진) 공유. 역할별 웹/모바일 분리(PLANNING §2-1).

Phase E: P2 + 빌드·배포

M11 비즈매칭·M13 wayfinding·M14 현장운영. kintex-devops-dev: 역할별 프론트 번들 + Spring jar + 워커 서비스 빌드, Gitea zio/kintex CI/CD. G1·G2 확정 후 실배포.

데이터 전달 / 에러

태스크(조율)+파일(_workspace/{phase}_{agent}_{artifact})+메시지(실시간). 1회 재시도 후 누락 명시, 상충은 출처 병기, QA/빌드 실패는 통과까지 반려. 최종물 src/·docs/, 중간물 _workspace/ 보존.

보안 불변

자격증명·PII·스택트레이스 미노출. AI 이미지 워터마크 강제. 외부 API 금지(예외: Claude api.anthropic.com·나노바나나 Gemini는 G1 승인). admin 비번 env(AES-256-GCM), admin123 시드 금지. 등록업체만 옥션 응찰.

테스트 시나리오

  • 정상: "킨텍스 구현 착수" → Phase0 게이트 → A(아키텍처) → B(공통레이어·2FA) → C(M2~M5) → D(옥션·관람객·BI·CMS·관리자) → E(배포) 각 Phase QA 통과.
  • 부분: "옥션 견적서 화면만 다시" → Phase0 부분 재실행 → kintex-bidding-dev(+backend 계약) → qa.
  • 에러: G1 미승인 "M5 구현" → 실호출 제외·구조만, 승인 요청 에스컬레이션.

후속 작업

description 후속 키워드로 재실행/부분수정 트리거. Phase 0 컨텍스트 확인이 초기/새/부분 판별.