Hướng dẫn sử dụng Obsidian cho Cố vấn Y khoa (CVYK)

Dành cho: ()
Mục đích: Đọc, duyệt và chỉnh sửa y khoa trong Obsidian
Thời gian đọc: 10 phút

1. Obsidian là gì?

Obsidian là phần mềm quản lý ghi chú miễn phí, đọc file Markdown (.md) trên máy tính. Trong dự án CXK, Obsidian được dùng để:
- Đọc thẻ tri thức (knowledge card) y khoa
- Duyệt nội dung trước khi đưa vào hệ thống AI
- Chỉnh sửa trực tiếp trên giao diện trực quan
- Xem liên kết giữa các thẻ (graph view)

💡 Ưu điểm: CVYK đọc được chính xác những gì AI sẽ đọc — không có "hộp đen".

2. Cài đặt

Bước 1: Tải Obsidian

  • Vào obsidian.md → Tải bản Windows
  • Cài đặt bình thường (Next → Next → Install)

Bước 2: Mở Vault

  1. Mở Obsidian
  2. Chọn "Open folder as vault" (Mở thư mục làm vault)
  3. Trỏ đến thư mục dự án: T:\Shared drives\VAGA\Working\CXK
  4. Nhấn Open

⚠️ Lưu ý: Vault đã được cấu hình sẵn (thư mục .obsidian/). CVYK không cần thiết lập gì thêm.

Bước 3: Xác nhận

  • Bên trái sẽ thấy cây thư mục: docs/, knowledge-base/, safety/...
  • Mở file knowledge-base/MOC_TONG_QUAN.md để bắt đầu

3. Cách đọc thẻ tri thức

Mở thẻ

  1. Bấm vào thư mục knowledge-base/ ở panel trái
  2. Mở MOC_TONG_QUAN.md — đây là bản đồ tổng quan
  3. Bấm vào link xanh để mở từng chuyên đề (VD: MOC Thoái hoá khớp)
  4. Từ MOC chuyên đề, bấm vào từng thẻ tri thức (KC-OA-001, KC-OA-002...)

Hiểu cấu trúc thẻ

Mỗi thẻ tri thức có:

---
id: KC-OA-001          ← Mã thẻ
title: "Tiêu đề"       ← Tên thẻ
status: DRAFT           ← Trạng thái (DRAFT → NCS_REVIEWED → APPROVED)
provenance:             ← Nguồn gốc
  source: dhyhn_tap2
  chapter: "21"
red_flags: [...]        ← Cờ đỏ
---

Các phần CVYK cần đọc kỹ

Phần Ý nghĩa CVYK cần kiểm tra
Định nghĩa Mô tả bệnh Đúng y khoa? Dễ hiểu cho NCT?
Dấu hiệu nguy hiểm Đủ? Thiếu? Sai?
Chăm sóc tại nhà Hướng dẫn An toàn? Có hại không?
Lời khuyên an toàn Có đầy đủ?
Truy vết nguồn Đúng chương/trang?

4. Cách duyệt (review)

Quy trình duyệt

DRAFT → NCS_REVIEWED → CLINICAL_REVIEW → APPROVED
         (NCS đọc)     (CVYK duyệt)     (đã phê duyệt)

CVYK duyệt bằng cách:

Cách 1: Chỉnh sửa trực tiếp (khuyến nghị)
1. Mở thẻ trong Obsidian
2. Bấm vào icon bút chì (Edit) ở góc phải
3. Sửa nội dung trực tiếp
4. Đổi status: CLINICAL_REVIEW thành status: APPROVED
5. Thêm tên vào approved_by: "Vũ Thế Sỹ"
6. Obsidian tự lưu — không cần nhấn Save

Cách 2: Ghi chú phản hồi
- Nếu không muốn sửa trực tiếp, thêm comment ở cuối file:

## Phản hồi CVYK
- [ ] Cần bổ sung cờ đỏ: [ghi cụ thể]
- [ ] Sửa lại phần định nghĩa: [ghi cụ thể]
- Đổi status thành: BLOCKED_CONFLICT (nếu có mâu thuẫn)

Review kết quả camera quan sát cử động

Module camera do NCS2 (Đỗ Đoàn Anh Tuấn) phụ trách. Camera chỉ , tuyệt đối không chẩn đoán bệnh.

CVYK cần xem xét và ký duyệt các ngưỡng an toàn:
- Ngưỡng TUG (Timed Up and Go): thời gian đứng lên, đi lại và ngồi xuống.
- Ngưỡng 5STS (Five Times Sit-to-Stand): thời gian đứng ngồi 5 lần.
- Ngưỡng Gait Speed: tốc độ đi bộ của người cao tuổi.

Quy trình duyệt ngưỡng camera (Workflow):

NCS2 submit → CVYK review ngưỡng → APPROVED
  • Bước 1 (NCS2 submit): NCS2 nộp bảng đề xuất ngưỡng trong file thresholds.yaml kèm tài liệu nguồn.
  • Bước 2 (CVYK review): CVYK kiểm tra độ phù hợp và an toàn y khoa cho người cao tuổi.
  • Bước 3 (APPROVED): CVYK xác nhận phê duyệt để đưa vào hệ thống kiểm tra an toàn.

5. Các tính năng hữu ích

Graph View (Xem đồ thị)

  • Bấm icon đồ thị ở thanh bên trái
  • Xem liên kết giữa các thẻ — thẻ nào liên quan thẻ nào
  • Màu sắc phân biệt theo thư mục

Tìm kiếm

  • Bấm Ctrl + Shift + F để tìm kiếm toàn vault
  • Gõ từ khoá (VD: "cờ đỏ", "loãng xương")
  • Kết quả hiện ngay
  • Mở 1 thẻ → Panel phải hiện những file nào link đến thẻ này
  • Giúp kiểm tra tính nhất quán

Tags

  • Bấm icon # ở panel trái
  • Xem tất cả tags: #thẻ-tri-thức, #cờ-đỏ, #sprint-2...

6. Những điều KHÔNG nên làm

  • ❌ Không xoá file — chỉ sửa nội dung hoặc đổi status
  • ❌ Không đổi tên file — tên file là ID, đổi sẽ hỏng link
  • ❌ Không di chuyển file sang thư mục khác
  • ❌ Không cài thêm plugin mà chưa hỏi
  • ✅ Chỉ sửa nội dung y khoa (định nghĩa, cờ đỏ, chăm sóc, disclaimer)
  • ✅ Đổi status khi đã duyệt xong
  • ✅ Thêm phản hồi ở cuối file

7. Liên hệ hỗ trợ

Nếu gặp khó khăn khi dùng Obsidian:
- NCS: Võ Trần Gia Hiếu (hỗ trợ kỹ thuật)
- NCS2: Đỗ Đoàn Anh Tuấn (hỗ trợ module camera)
- Email/Zalo: [liên hệ NCS]

Phiên bản: 1.0 | Ngày: 25/09/2026
Tạo bởi: | Cần review: NCS