LỊCH SỬ — KHÔNG CÒN LÀ LỊCH THỰC HIỆN (26/09/2026).
Nội dung dưới đây giữ nguyên để truy vết đề xuất cũ; không xác nhận đã làm, đã duyệt hoặc đã đạt cổng.
Dùng lộ trình hiện hành, bảng camera và ma trận y khoa.
Một chỉ số chỉ được thử sau GCA; GCB phải trước tích hợp. Mọi hoạt động có người cần GC riêng.
Các giờ, ngày, ngưỡng và đầu ra bên dưới không tự chuyển thành cam kết hoặc tiêu chí được duyệt.

Tuần: W5/23 | : Sprint C2/4
Vai trò: NCS2 (Đỗ Đoàn Anh Tuấn, 10A6 PTTH Xuân Đỉnh)
Effort: 6h
Dependency: CAM-003, CAM-006
Checkpoint cuối ngày: Bản thiết kế thuật toán TUG với máy trạng thái FSM 4 pha, mã giả (pseudocode) và logic an toàn.

Task: Thiết kế thuật toán quan sát cử động bài test TUG

ID: CAM-008
Phân loại: 📝 thực hiện
Effort: 6 giờ

Mô tả

Thiết kế kiến trúc thuật toán đo thời gian bài kiểm tra Timed Up and Go (TUG) dựa trên chuỗi toạ độ 33 keypoints BlazePose. Phân tách bài test thành máy trạng thái hữu hạn (FSM) gồm 4 pha: (1) Ngồi yên trên ghế; (2) Đứng dậy (góc gối duỗi thẳng, toạ độ hông nâng cao); (3) Đi bộ 3m và quay đầu; (4) Ngồi trở lại ghế. Xây dựng logic tính tổng thời gian hoàn thành và phát hiện mất dấu hoặc loạng choạng.

File Tham chiếu (Input)

  • backend/movement-observation/poc/index.html
  • backend/movement-observation/config/thresholds.yaml
  • docs/research/reports/DEEP_RESEARCH_CAMERA.md

File Kết quả (Output)

  • docs/research/designs/NCS2_tug_algorithm_design.md

DoD (Definition of Done)

  • [ ] Sơ đồ máy trạng thái FSM phân định ranh giới 4 pha vận động kèm ngưỡng góc khớp trigger cụ thể.
  • [ ] Mã giả (pseudocode) chi tiết giải thuật đo thời gian từ lúc rời ghế đến khi mông chạm lại mặt ghế.
  • [ ] Xử lý ngoại lệ an toàn: cơ chế huỷ hoặc cảnh báo khi mất dấu keypoints liên tiếp >0.5s.
  • [ ] Ranh giới y tế nghiêm ngặt: Camera chỉ đếm giây và , KHÔNG chẩn đoán nguy cơ té ngã hay bệnh lý.

Hướng dẫn triển khai

  1. Xác định góc hông và góc gối từ các landmark 23, 24, 25, 26, 27, 28.
  2. Thiết lập điều kiện bắt đầu tính giờ: góc gối tăng từ ~90° lên >160° kèm vận tốc nâng trục Y.
  3. Thiết lập điều kiện quay đầu: khoảng cách giữa 2 vai hoặc hông đảo chiều trên mặt phẳng Z/X.
  4. Thiết lập điều kiện kết thúc: góc gối trở về trạng thái gập ~90° và toạ độ Y ổn định trên ghế.
  5. Soạn thảo tài liệu thiết kế thuật toán lưu vào docs/research/designs/.

Rủi ro & Biện pháp giảm thiểu

  • Rủi ro: Nhận diện sai thời điểm đứng lên do người dùng đung đưa người trước khi đứng.
  • Biện pháp: Kết hợp đồng thời 2 điều kiện: góc gối >120° VÀ vận tốc nâng hông trục Y > ngưỡng tối thiểu.
  • Rủi ro: Không gian hẹp không đủ bao quát quãng đường đi bộ 3m.
  • Biện pháp: Thiết lập hướng dẫn góc đặt camera tối ưu (đặt chéo 45 độ hoặc khoảng cách camera ≥3m).

Phân định vai trò

  • NCS2 (Đỗ Đoàn Anh Tuấn): Thiết kế máy trạng thái FSM, tính toán góc khớp và soạn mã giả.
  • (): Thẩm định các pha vận động theo chuẩn y học cổ truyền và phục hồi chức năng.