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.
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
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ì.
- Tạo
modules/<id>.js(theomodule-template.js), vớiidtrong file khai báo đúng bằng<id>— dùng chữ thường, số, nối bằng dấu-. - Thêm
'<id>'vào mảng trongmanifest.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.
- Validation khi khởi động kiểm tra: thiếu trường bắt buộc,
groupsai,idtrùng,idsai định dạng,statuslạ; 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
?devvà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.
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.