trex-core/docs/batches/bat-037_20260612_slots-rpc-available-slots/planning.md

BAT-037 Planning

• Status: confirmed
• Batch: BAT-037
• Profile: standard

Included REQ

• REQ-073 (CHG-20260612-01): 응답에 available_slots: int|null 추가, AC-3 반전, AC-6 신규

Delivery Plan

1. messaging_handlers.py — make_slots_rpc_handler 에서 compute_slot_capacity 호출 후 available_slots 를 응답에 포함
2. tests/application/test_slots_handler.py — AC-3 키 집합 검사 갱신(available_slots 포함), AC-6 값 검증 케이스 추가

Dependencies

• Internal:
  • trex_core/domain/slot/service.py — SlotService.compute_slot_capacity(max_active_slots) 이미 존재, 재활용
  • make_slots_rpc_handler 에 max_active_slots: Optional[int] 파라미터가 이미 있는지 확인 필요
• External: 없음

Design Gate

• Design Required Before Implementation: yes
• Reason: 응답 스키마 변경(인터페이스 계약) — AC-3 반전 근거와 available_slots 계산 경로를 design 에서 명확히 한 뒤 구현한다.

Milestones

1. Design confirmed — 계산 경로 확정
2. Implementation — 핸들러 수정 + 테스트 갱신
3. Verification — AC 전체 매핑 확인

Risks

• make_slots_rpc_handler 에 max_active_slots 가 전달되지 않는 경로가 있으면 null fallback 처리 필요 — design 에서 확인.