# AI Coach Docs

Bo tai lieu nay mo ta phien ban hien tai cua du an: ung dung Reflex phan tich bai tap hit dat bang video.

## Doc Map

- `problem_statement.md`: muc tieu san pham va pham vi hien tai.
- `implementation_plan.md`: kien truc, module chinh, luong xu ly va quyet dinh thiet ke.
- `SETUP_NOTES.md`: cach cai dat, chay app, cau hinh VLM va test batch.
- `LLM_FEEDBACK_NVIDIA_LANGGRAPH.md`: vai tro NVIDIA VLM, input/output, fallback va ly do arrow khong dung VLM.
- `UI_REDESIGN.md`: cau truc UI hien tai, cach phan biet rule-based feedback voi VLM feedback.
- `legacy_agent_notes.md`: ghi chu ngan ve tai lieu agent/OpenAI cu khong con thuoc luong production.

## Tom Tat He Thong

```text
Reflex UI
  -> upload video hoc vien
  -> MediaPipe Pose local CPU
  -> rep segmentation + DTW
  -> rule-based error detection
  -> annotated rep frames + deterministic arrows
  -> optional NVIDIA VLM text feedback for rule-error reps
  -> per-rep result cards
```

## Nguon Su That Trong Ung Dung

- Loi chinh: rule engine.
- Diem so: ket hop rule score va DTW score.
- Arrow: landmark rule-based.
- Feedback rule-based: `ERROR_GUIDANCE`.
- Feedback VLM: chi la giai thich bo sung bang ngon ngu tu nhien.

## Lenh Thuong Dung

```powershell
reflex run
```

```powershell
python scripts\run_pushup_eval_tests.py
```

```powershell
python scripts\run_pushup_eval_tests.py --save-artifacts --enable-vlm
```