AI-Coach / docs /README.md
Hoang Duc Hung
fix phoenix-mentor
268a54d
# 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
```