Skip to content

Task-엔진 월드 쿼리 비할당 순회 지원 #233

@muzygosu

Description

@muzygosu

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

  • I checked for an existing related issue or epic before creating this task.
  • I will keep the issue title aligned with the repository naming convention.

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions