Hướng dẫn sử dụng từng bước — Phần mềm Quản lý học sinh

0Ba người dùng — một bảng dữ liệu

Ai	Vào bằng	Làm gì	Mật khẩu
Cô giáo — Hoàng Thị Phương Trà	`/dang-nhap` — Hoàng Thị Phương Trà (mật khẩu cô tự giữ)	Khai Bảng 1, nhập học sinh, điểm, bài tập, khóa năm	có
Ban giám hiệu	link `/xem/{mã}` cô gửi	xem + in báo cáo	không
Phụ huynh	link `/xem/{mã}` của lớp/con	xem bài tập của con	không

Dữ liệu duy nhất ở App_Data/qhs.db (SQLite). Sao lưu = chép thư mục App_Data/.

1Đăng nhập vào bảng công tác

Mở http://localhost:12001/dang-nhap → gõ tên đăng nhập, mật khẩu → bấm nút xanh.

Màn hình đăng nhập — Bước 1 — ô **Tên đăng nhập** và **Mật khẩu** (máy đã điền sẵn — chỉ bấm nút), rồi bấm **Vào bảng công tác →**. Sai mật khẩu sẽ thấy dòng vàng “Sai tên đăng nhập hoặc mật khẩu”.

2Bảng tổng hợp — đọc nhanh trong 10 giây

Bảng tổng hợp giáo viên — Bước 2 — bốn thẻ màu: **6 công việc quý III/2026**, **69 điểm quy đổi** (Σ cột F×G của file Excel), **18 học sinh lớp 1/6**, **1 bài tập đang giao**. Cột trái là 9 mục (đã thêm 🧭 Kế hoạch tuần); góc phải trên hiện **2026-2027 · đang mở** và nút **Đổi năm học**. Khối “Việc cần làm hôm nay” lấy đúng 6 dòng công việc trong “bảng 1 - Bích Hà.xlsx”.

Cần nộp cho phó hiệu trưởng? bấm 🗂️ Mở Bảng 1 quý (nút vàng).
Đầu năm chưa có học sinh? bấm 🎒 Nhập danh sách học sinh.
Dưới Đường tắt có sẵn “Liên kết gửi ban giám hiệu” — copy gửi cho BGH, không cần mật khẩu.

3Lập tờ khai & khai Bảng 1 (đúng 9 cột A→I)

Vào Bảng 1 (quý). Mỗi quý một tờ khai; chưa có thì bấm ➕ Tờ khai quý mới.

Danh sách tờ khai Bảng 1 — Bước 3a — thẻ **Quý III / 2026** hiện số công việc, điểm quy đổi, tình trạng “đã gửi BGH”. Bấm **Mở khai báo** để sửa, **⬇️ Xuất Excel** để tải tệp nộp.

Khai Bảng 1 theo cột A đến I — Bước 3b — bàn khai báo. Mỗi dòng là một công việc: B tên việc · C kết quả đầu ra · D hạn · E Thường xuyên/Đột xuất · F điểm chuẩn · G hệ số độ khó · H *Điểm quy đổi = F × G* (máy tự tính, ví dụ 10 × 1.2 = 12) · I minh chứng. Cuối bảng: **TỔNG ĐIỂM QUY ĐỔI TỐI ĐA**. Sửa ô nào nhớ **Lưu** (máy tự lưu khi rời ô).

Ô cần	Nhập	Thí dụ trong file gốc
I — minh chứng	bấm “n minh chứng” → dán link OneDrive/Drive hoặc Tải ảnh	chuyên đề Canva, kho học liệu lớp 2, lồng đèn
Vượt tiến độ	tick “vượt tiến độ” → nhập Điểm thưởng	cộng vào điểm thưởng đề xuất

File gốc khai “Tổng số nhiệm vụ = 7” nhưng chỉ 6 dòng (dòng 1 gộp 2 việc) — app giữ nguyên số liệu và chú giải.

4Đầu năm: tạo lớp, nhập danh sách, xếp chỗ

Lớp · Học sinh → chọn lớp (hoặc ➕ Tạo lớp) → 📥 Nhập danh sách học sinh.

Danh sách học sinh và xếp chỗ ngồi — Bước 4 — ảnh là danh sách thật 18 học sinh lớp 1/6 (2026-2027), **mã định danh Bộ GD&ĐT** giữ nguyên để tra lại học sinh cũ qua các năm. Phần trên là bảng hồ sơ (STT · Mã HS · Họ tên · Ngày sinh · GT · Bố · Mẹ · ĐT · Ghi chú · **Liên kết PH**); bấm 2 thẻ trong khối **🪑 Xếp chỗ ngồi** để hoán đổi chỗ. Mỗi học sinh mới có **Mã HS** (`HS001`) và một **liên kết phụ huynh** — bấm ô link tuyệt đối rồi Ctrl+C gửi bố mẹ.

Chọn tệp .xlsx/.csv hoặc dán danh sách — app tự nhận Mã định danh Bộ GD&ĐT, Họ tên (tự chuẩn hóa “TRẦN CHÍ CƯỜNG” → “Trần Chí Cường”), Ngày sinh, Giới tính, SĐT; cột lạ (Dân tộc/Trạng thái/số buổi) chuyển vào Ghi chú hồ sơ.
Bấm 🔎 Xem trước → sửa cột sai nếu có → ✅ Nhập.
Trùng tên/mã: mặc định bỏ qua; muốn ghi đè hồ sơ cũ thì tick “cho phép cập nhật”.

Qua năm học mới: làm lại bước này với năm mới — danh sách học sinh không trộn giữa hai năm.

5Điểm danh chuyên cần theo ngày

Bảng chuyên cần theo ngày — Bước 5 — **📅 Chuyên cần** (ảnh: điểm danh ngày). Lớp học **thứ 2 → thứ 6**, mỗi ngày **2 ca**: đổi **☀️ Ca sáng 07:15 → 10:35** / **🌤️ Ca chiều 13:30 → 16:00** rồi bấm trạng thái từng em — mỗi ca là một bản ghi riêng, cột **Ca kia** cho thấy buổi còn lại ra sao; bấm **✅ Đi học · ⏰ Đi muộn · 🚫 Vắng · 📝 Nghỉ có phép**, nhập lý do cột phải; bấm là lưu ngay. Cần **xem quá khứ** → bấm **🗂️ Lịch sử cả tháng** (`/chuyen-can/1?mode=lichsu&thang=2026-09`): lưới ngày × học sinh, cuối hàng là **Đi · Muộn · Vắng · %**, bấm một ô để quay lại sửa đúng ngày đó.

6Đặt đầu điểm & nhập điểm cả lớp

Đầu điểm và lưới nhập điểm — Bước 6 — **✏️ Điểm · Đầu điểm**: **➕ Đặt đầu điểm mới** (miệng/15 phút/1 tiết/cuối kì + hệ số), rồi gõ điểm từng em trong lưới; cột **“Ghi chú”** chính là cột ghi chú trong bảng theo dõi. Điểm trung bình lớp hiện cuối bảng.

7Giao bài tập + đính kèm tệp — phụ huynh thấy ngay, không mật khẩu

Giao bài tập cho lớp — Bước 7a — **📚 Bài tập**: nhập tên bài, môn, hạn nộp, link tài liệu, **yêu cầu** (phụ huynh đọc dòng này) → **📤 Giao bài**. Bấm **➕ Đính kèm tệp** để gửi đề bài/phiếu scan (nhiều tệp); phụ huynh bấm tải ngay trong link. Bảng dưới liệt kê bài nộp từng em; có thể cho điểm + nhận xét, hoặc **Ẩn phụ huynh**.

Màn hình phụ huynh xem bài tập — Bước 7b — đây là thứ phụ huynh nhìn thấy từ link cô gửi (*không đăng nhập*): tên con, đầu bài, hạn, yêu cầu, tình trạng “cô đã nhận bài của con”.

8Hồ sơ học sinh & tiến độ môn học

Hồ sơ học sinh, ghi nhận và tiến độ — Bước 8 — bấm **Hồ sơ** ở bất kỳ học sinh nào: sửa SYLL, xem đầu điểm, **🗒️ Ghi nhận của cô** (Khen/Theo dõi/Cần hỗ trợ — đúng cột “Ghi chú của giáo viên”), và **Tiến độ theo môn** = Σ(điểm × hệ số) / Σ hệ số kèm nhãn Tốt/Khá/Đạt/Cần hỗ trợ.

9Cuối năm: khóa & lưu trữ

Chọn năm học và khóa dữ liệu — Bước 9 — **🗓️ Năm học**: **Xem năm này** để chuyển; **Khóa & lưu trữ** để đóng năm. Năm đã khóa (như **2025-2026 · 🔒 đã khóa**) mọi màn hình chỉ xem — kể cả lập trình viên cũng không ghi được (chặn ngay ở tầng cơ sở dữ liệu). Cần sửa thì **Mở khóa**, sửa xong khóa lại.

Tạo năm mới: Đón năm học mới → đặt tên 2027-2028 → quay lại Bước 4 nhập danh sách.

10Gửi Ban giám hiệu & in

Báo cáo gửi ban giám hiệu — Bước 10 — link `/xem/bgh-…` (lấy ở Bước 2) hiển thị Bảng 1 chỉ dấu: tiêu đề quý, **69 điểm quy đổi tối đa**, đủ cột F/G/H, danh sách minh chứng, dòng “Xác nhận của Phó hiệu trưởng”. Nút **🖨️ In** để in ngay.

Nộp file: ⬇️ Xuất Excel ở Bước 3a → Bang-1 QUY III 2026 - ….xlsx (sheet Bảng 1 giữ ô ghép + dòng TRỤC, sheet Minh chứng).

11Kế hoạch dạy học theo tuần (upload nhiều tệp)

🧭 Kế hoạch tuần — mỗi tuần một ngăn kéo: giáo án, công văn, phiếu bài tập (.docx/.pdf/.xlsx/ảnh scan).

Lớp chỉ học thứ 2 → thứ 6, hai ca ☀️ 07:15–10:35 · 🌤️ 13:30–16:00 — vì vậy lịch tuần của app chừa sẵn Thứ 7 · Chủ nhật.

12Bài kiểm tra: cô tạo — trò làm trên điện thoại — máy chấm

🎯 Bài kiểm tra (/de-thi/{lop}): 3 dạng câu — 🔘 chọn đáp án · ✍️ điền đáp án (máy chấm) · 📝 trả lời (cô chấm).

Bước 12a — đặt tên bài, chọn môn, thời gian → **➕ Tạo bài kiểm tra** → **➕ Thêm câu hỏi**. Gõ nội dung, gõ 3 phương án, bấm **radio “đúng”** câu 🔘; câu ✍️ gõ đáp án cách nhau dấu “;” (chấp nhận “25 tá = 250”, “250” → vẫn đúng). Bật **lấy điểm vào sổ** nếu muốn cộng vào đầu điểm 15 phút.

Học sinh làm bài trên điện thoại — Bước 12b — đây là màn hình của học sinh trên **điện thoại** (chụp 430×900): vào link cô đã gửi cho bố mẹ (`/xem/{mã}`) → **🎯 Bài kiểm tra của con → Bắt đầu ▶**. Ô chạm to, một cột, bấm cái máy tự nhảy câu kế; hết câu hiện **✅ Nộp bài** → điểm + xếp loại hiện ngay.

Dashboard điểm bài kiểm tra — Bước 12c — **📊 Dashboard** (`/de-thi/{id}/bao-cao`): thẻ số (đã làm · điểm TB · cao/thấp · chờ cô), **donut phân bố xếp loại**, **cột điểm từng câu** (câu nào ít em đạt → giảng lại), bảng điểm từng em (ô trống = câu tự luận cô gõ điểm), **📋 Sao chép CSV** và **🖨️ In**.

Học sinh không cần mật khẩu, không cần tài khoản: dùng đúng link đã gửi cho phụ huynh. Lớp chỉ học thứ 2 → thứ 6, hai ca ☀️ 07:15–10:35 · 🌤️ 13:30–16:00.

Trên điện thoại: điều hướng chuyển thành lưới 2 cột, mọi ô chạm cao ≥44px, chữ 16px trong ô nhập (iPhone không phóng to khi gõ), bảng dài trở thành dải vuốt ngang (cột tên học sinh luôn ở lại bên trái). Đã nghiệm thu ở khung 430×900: 10/10 màn hình không tràn ngang.

13Mẹo & xử lý nhanh

Hiện tượng	Cách xử lý
Nhập danh sách không nhận cột	Kiểm tra dòng đầu là tiêu đề; dùng `import/danh-sach-mau-lop-2A.csv` làm chuẩn.
Điểm quy đổi khác tính tay	Máy làm tròn 2 số: F × G (10 × 1.2 = 12).
Sửa được năm đã khóa	Năm học → Mở khóa, xong khóa lại.
Muốn xem lại dữ liệu mẫu	Xóa `App_Data/qhs.db` rồi chạy lại app (Seed đọc `_build/excel_report.json`).
Ảnh hướng dẫn/cập nhật ảnh	`node tools/chup-anh-huong-dan.mjs` (cần app đang chạy).

🖨️ In hướng dẫn này · bản gốc src/QuanLyHocSinh.App/wwwroot/huong-dan.html · ảnh wwwroot/huong-dan/