8000 GitHub - fezzoon/episimu · GitHub
[go: up one dir, main page]

Skip to content
fezzoonPublic

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

Mô phỏng dịch tễ

Trang web mô phỏng tương tác các khái niệm dịch tễ học cho sinh viên Y khoa & Y tế công cộng.

Cấu trúc thư mục

index.html                    khung trang (skeleton + nạp shell/manifest/loader)
manifest.js                   DANH SÁCH module cần nạp — nguồn chân lý duy nhất
core/
  styles.css                  toàn bộ CSS — "design system" dùng chung
  shell.js                    engine: sidebar, routing, validation, loader
modules/
  ppv-npv-prevalence.js       [ready]  Nghịch lý PPV/NPV theo tỷ lệ hiện mắc
  two-by-two-measures.js      [ready]  Bảng 2×2: RR, OR, RD, NNT
  dag-confounder-intro.js     [draft]  DAG: nhận diện nhiễu & biến gây nhiễu
  kaplan-meier-censoring.js   [draft]  Kaplan-Meier & censoring
module-template.js            file mẫu — đính kèm khi nhờ AI viết module mới
build.py                      gộp toàn bộ thành 1 file HTML (đọc manifest.js)
dist/mo-phong-dich-te.html    (sinh ra sau khi chạy build.py) bản gộp 1-file

Chạy trang — hai cách

Cách A — bản gộp 1-file (mở trực tiếp, không cần gì thêm): Chạy python3 build.py một lần, rồi mở dist/mo-phong-dich-te.html bằng trình duyệt (double-click). Bản này gói mọi thứ vào 1 file nên không cần máy chủ. Dùng cách này để gửi email, nhúng LMS, hoặc chia sẻ nhanh.

Cách B — bản tách file qua máy chủ tĩnh (khi đang phát triển): Tại thư mục dự án chạy python3 -m http.server rồi mở http://localhost:8000. Cần máy chủ vì trang nạp các file modules/*.js động, và nhiều trình duyệt chặn việc này khi mở trực tiếp bằng file://. Nếu lỡ mở bản tách bằng file:// và trình duyệt chặn, trang sẽ hiện hướng dẫn khắc phục (không im lặng). Khi đưa lên hosting thật thì không có vấn đề gì.

Thêm một khái niệm mới — 2 bước, KHÔNG đụng index.html

  1. Tạo modules/<id>.js (theo module-template.js), với id trong file khai báo đúng bằng <id> — dùng chữ thường, số, nối bằng dấu -.
  2. Thêm '<id>' vào mảng trong manifest.js, đặt đúng vị trí theo thứ tự bài học mong muốn.

Xong. Loader tự nạp, engine tự dựng sidebar. Nếu tên file và id không khớp, hoặc quên một trong hai bước, trang sẽ báo lỗi rõ ràng (rõ nhất khi mở kèm ?dev, ví dụ index.html?dev hoặc localhost:8000/?dev) thay vì hỏng ngầm.

Chỉ khi thêm một NHÓM khái niệm mới (ngoài 9 nhóm) mới cần sửa mảng EPI_GROUPS trong core/shell.js.

Cơ chế an toàn (vì sao tin được là không hỏng ngầm)

  • Validation khi khởi động kiểm tra: thiếu trường bắt buộc, group sai, id trùng, id sai định dạng, status lạ; và đối chiếu 2 chiều với manifest (khai báo nhưng thiếu file / id không khớp / chạy nhưng ngoài manifest). Module hỏng bị loại, các module tốt vẫn chạy.
  • Chế độ kép: lúc học, chỉ hiện dải cảnh báo gọn (đếm số module bị bỏ qua); thêm ?dev vào URL để xem chi tiết từng lỗi khi đang soạn.
  • Error boundary: một module ném lỗi lúc chạy chỉ làm hỏng khu vực của nó, không làm trắng cả trang.

Đưa lên hosting để chia sẻ với sinh viên

Trang tĩnh 100%, host ở đâu cũng được. Đơn giản nhất: đẩy toàn bộ thư mục lên GitHub rồi bật GitHub Pages, hoặc kéo-thả vào Netlify Drop. Khi đã online, có thể chia sẻ link thẳng tới 1 khái niệm, ví dụ .../index.html#ppv-npv-prevalence.

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages

0