From 7d91e204cc077212a71a15ad41203187345af59a Mon Sep 17 00:00:00 2001
From: tolelom <98kimsungmin@naver.com>
Date: Wed, 25 Mar 2026 10:27:13 +0900
Subject: [PATCH] docs: add Phase 5-1 collision detection status and deferred
 items

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
---
 docs/DEFERRED.md |  7 +++++++
 docs/STATUS.md   | 21 +++++++++++++++------
 2 files changed, 22 insertions(+), 6 deletions(-)

diff --git a/docs/DEFERRED.md b/docs/DEFERRED.md
index 615bedf..cd735ea 100644
--- a/docs/DEFERRED.md
+++ b/docs/DEFERRED.md
@@ -42,6 +42,13 @@
 - **Irradiance/Prefiltered Map 컨볼루션** → 프로시저럴 근사.
 - **GPU 컴퓨트 BRDF LUT** → CPU 생성 (256x256).
 
+## Phase 5-1
+
+- **Capsule, Convex Hull 콜라이더** — Sphere + Box만 구현. 추후 GJK/EPA와 함께 추가.
+- **OBB (회전된 박스) 충돌** — 축 정렬 AABB만 지원. OBB는 GJK/EPA로 대체 예정.
+- **Incremental BVH 업데이트** — 매 프레임 전체 rebuild. 성능 이슈 시 incremental update 적용.
+- **연속 충돌 감지 (CCD)** — 이산 충돌만. 빠른 물체의 터널링 미처리.
+
 ## 렌더링 한계
 
 - **per-entity dynamic UBO** — 수천 개 이상은 인스턴싱 필요.
diff --git a/docs/STATUS.md b/docs/STATUS.md
index f9743b0..d70b808 100644
--- a/docs/STATUS.md
+++ b/docs/STATUS.md
@@ -55,26 +55,35 @@
 - IBL merged into shadow bind group (group 3) due to max_bind_groups=4
 - examples/ibl_demo
 
+### Phase 5-1: Collision Detection
+- voltex_math: AABB type (new, from_center_half_extents, intersects, merged, surface_area)
+- voltex_physics: Collider enum (Sphere, Box), ContactPoint
+- voltex_physics: BVH broad phase (median split, longest axis)
+- voltex_physics: Narrow phase — sphere_vs_sphere, sphere_vs_box, box_vs_box (SAT)
+- voltex_physics: detect_collisions(world) ECS integration
+
 ## Crate 구조
 
 ```
 crates/
-├── voltex_math      — Vec2, Vec3, Vec4, Mat4
+├── voltex_math      — Vec2, Vec3, Vec4, Mat4, AABB
 ├── voltex_platform  — VoltexWindow, InputState, GameTimer
 ├── voltex_renderer  — GPU, Mesh, OBJ, Camera, Material, PBR, Shadow, IBL, Sphere
 ├── voltex_ecs       — Entity, SparseSet, World, Transform, Hierarchy, Scene, WorldTransform
-└── voltex_asset     — Handle<T>, AssetStorage<T>, Assets
+├── voltex_asset     — Handle<T>, AssetStorage<T>, Assets
+└── voltex_physics   — Collider, ContactPoint, BvhTree, detect_collisions
 ```
 
-## 테스트: 105개 전부 통과
+## 테스트: 136개 전부 통과
 
 - voltex_asset: 14
 - voltex_ecs: 39
-- voltex_math: 29 (28 + orthographic)
+- voltex_math: 35 (29 + AABB 6)
+- voltex_physics: 25 (collider 2 + narrow 11 + bvh 5 + collision 7)
 - voltex_platform: 3
 - voltex_renderer: 20
 
-## Examples (8개)
+## Examples (9개)
 
 - triangle — Phase 1 삼각형
 - model_viewer — OBJ 큐브 + Blinn-Phong
@@ -86,7 +95,7 @@ crates/
 - shadow_demo — Directional Light 그림자
 - ibl_demo — Normal map + IBL
 
-## 다음: Phase 5 (물리 엔진)
+## 다음: Phase 5-2 (리지드바디 시뮬레이션)
 
 스펙 참조: `docs/superpowers/specs/2026-03-24-voltex-engine-design.md`