Summary
에이전트 수가 늘어날 때 WorldQuery::view()가 매번 새 std::vector를 구성하는 비용이 누적됩니다. 엔진 계층에 비할당 순회 API를 추가하고, 최소한의 적용 지점과 테스트를 통해 기존 지연 구조 변경 흐름을 유지하면서 쿼리 순회 비용을 줄입니다.
Parent Issue
Area
Engine
Target Sprint
Later
Scope
- src/engine에 WorldQuery 비할당 순회 API 추가
- 기존 �iew() 동작은 유지하고 새 순회 API를 함께 제공
- 지연 구조 변경 semantics를 해치지 않는 범위에서 최소 적용 지점 반영
- 엔진 단위 테스트 또는 통합 테스트 추가/보강
Acceptance Criteria
- WorldQuery에서 엔티티 벡터를 만들지 않고도 시그니처 기반 순회가 가능하다
- 기존 �iew() 호출 코드는 계속 동작한다
- 순회 중 WorldCommands로 예약한 구조 변경은 기존처럼 phase 경계 전까지 보이지 않는다
- 관련 테스트가 추가되거나 기존 테스트로 동작이 검증된다
Architecture / Dependency Check
- 구현은 src/engine 중심으로 유지한다
- domain/�pplication 의존을 추가하지 않는다
- include 경로는 #include engine/... 규칙을 유지한다
- 기존 command buffer + phase 기반 구조 변경 모델을 유지한다
Verification Plan
- cmake --build --preset build-engine-domain-debug
- ctest --preset test-no-app-debug
- ests/WorldQueryTests.cpp, ests/EngineIntegrationTests.cpp 중심 검증
Dependencies / Blockers
- 현재 시점의 관련 기존 이슈는 확인하지 못했으며, 구현 후 실제 병목 감소 폭은 시뮬레이션 규모별로 추가 확인이 필요합니다.
Repository Checks
Summary
에이전트 수가 늘어날 때 WorldQuery::view()가 매번 새 std::vector를 구성하는 비용이 누적됩니다. 엔진 계층에 비할당 순회 API를 추가하고, 최소한의 적용 지점과 테스트를 통해 기존 지연 구조 변경 흐름을 유지하면서 쿼리 순회 비용을 줄입니다.
Parent Issue
Area
Engine
Target Sprint
Later
Scope
Acceptance Criteria
Architecture / Dependency Check
Verification Plan
Dependencies / Blockers
Repository Checks