버전: v5.0 | 최종 업데이트: 2026-02-12
이 문서들만 읽으면 WebPilot Engine 프로젝트의 모든 것을 파악할 수 있습니다.
| # |
문서 |
주요 내용 |
| 01 |
프로젝트 개요 |
미션, 기술 스택, 셀 아키텍처, A2A, 통계 |
| 02 |
시스템 아키텍처 |
셀 아키텍처 + A2A + Director-Architect-Renderer |
| 03 |
AI 파이프라인 |
7-Step 파이프라인 + 18개 서비스 |
| 04 |
기하학적 시스템 |
OBB 15축 SAT, NavMesh, Raycasting, BVH |
| 05 |
스케일링 정책 |
SEMANTIC_ALPHA_TABLE, 상대적 스케일 공식 |
| 06 |
에셋 관리 |
3,477 에셋 + 벡터 검색 + 29개 카테고리 |
| 07 |
사용자 흐름 |
UX 시나리오, UI 구성, 성능 지표 |
| 08 |
코드 구조 |
셀/에이전트/서비스 의존성, 모듈 그래프 |
| 09 |
배포 운영 |
Vercel CLI, CI/CD, 환경 변수, 모니터링 |
| 10 |
API 레퍼런스 |
REST API, 서비스 클래스, 유틸리티 함수 |
01_PROJECT_OVERVIEW → 02_ARCHITECTURE → 08_CODE_STRUCTURE
03_AI_PIPELINE → 04_GEOMETRY_SYSTEMS → 05_SCALING_POLICY
08_CODE_STRUCTURE → 10_API_REFERENCE → 06_ASSET_MANAGEMENT
09_DEPLOYMENT → 07_USER_FLOW
❌ 하드코딩된 규칙 금지 → ✅ AI가 규칙을 동적 생성
❌ 키워드 매칭 금지 → ✅ Vector DB 시맨틱 검색
❌ 일괄 스케일 금지 → ✅ 개별 오브젝트 AI 추론
❌ 직접 좌표 생성 금지 → ✅ MCTS 기반 최적 배치
| 역할 |
파일 |
크기 |
| 중추 지휘 |
src/cells/cortex/CommanderCell.ts |
23KB |
| 파이프라인 조율 |
src/services/ai-pipeline/AIPipelineOrchestrator.ts |
33KB |
| MCTS 배치 |
src/services/ai-pipeline/MCTSPlacementService.ts |
64KB |
| 벡터 검색 |
src/services/VectorSearchService.ts |
36KB |
| 에셋 사냥 |
src/cells/musculoskeletal/AssetHunterCell.ts |
24KB |
| 씬 구축 |
src/cells/musculoskeletal/ConstructorSquad.ts |
20KB |
| Director 에이전트 |
src/services/a2a/DirectorAgent.ts |
11KB |
| Blackboard |
src/services/a2a/Blackboard.ts |
9KB |
| MCTS Worker |
src/workers/mcts.worker.ts |
9KB |
| 항목 |
수치 |
| src/ 하위 디렉토리 |
19개 |
| 셀 (cells/) |
15개 (7계층) |
| A2A 에이전트 |
5 + 3 인프라 |
| AI 파이프라인 서비스 |
18개 |
| 총 에셋 |
3,477개 |
| GLB 모델 |
2,632개 |