7.0 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) — 백엔드 모듈뿐 아니라 웹 기능 화면도 uiws frontend(pages/worklog·schedule·message·stats·notice·report·approval·meeting·system) 패턴을 차용한다(재발명 금지). 디자인은 Stitch 경유(designer → design.md → Stitch → 이식).
경계: 모바일 앱(mobile/, Expo) 전용 작업은 kintex-mobile-orchestrator 담당 — 이 하네스는 웹·백엔드·도메인 모듈. 모바일이 요구하는 백엔드 API 확장은 양쪽 어디서든 kintex-backend-dev 단일 창구로 처리한다.
에이전트 로스터
| 그룹 | 에이전트 | 역할 |
|---|---|---|
| 아키텍트(설계·표준·검수) | 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-mobile-dev | mobile/(Expo) — 전용 트랙은 kintex-mobile-orchestrator 경유, 여기선 계약 협의만 |
| 도메인 | 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: 컨텍스트·게이트
_workspace/·src/·docs/IMPLEMENTATION_BACKLOG.md확인 → 초기/부분 재실행/새 실행 판별.- 선행 게이트: 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 컨텍스트 확인이 초기/새/부분 판별.