59 lines
7.0 KiB
Markdown
59 lines
7.0 KiB
Markdown
---
|
|
name: kintex-impl-orchestrator
|
|
description: 킨텍스 자동전시시스템 구현 오케스트레이터. 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: 컨텍스트·게이트
|
|
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 컨텍스트 확인이 초기/새/부분 판별.
|