Cổng trường

Mỗi học sinh có một thẻ QR. Bảo vệ quét thẻ (hoặc tìm tên khi em quên thẻ) lúc em vào hay ra cổng. Lượt qua cổng được báo về cho phụ huynh, và giáo viên chủ nhiệm được cảnh báo khi một em đã vào trường nhưng đang bị ghi vắng.

Ai	Làm gì	Ở đâu
Quản trị viên trường	Bật tính năng, chọn báo phụ huynh khi vào / khi ra	Cài đặt → Chung → Cổng trường
Giáo vụ	Cấp và in thẻ, xem và sửa nhật ký cổng	/admin → nhóm Vận hành
Bảo vệ cổng	Quét thẻ ở cổng	/admin → Vận hành → Cổng trường
Giáo viên chủ nhiệm	Nhận cảnh báo "đang ở trường nhưng bị ghi vắng"	Chuông thông báo
Phụ huynh	Nhận thông báo khi con vào / ra cổng	Cổng phụ huynh

Không thấy các trang này?

Cổng trường là một module riêng, mặc định có trong cấu hình trường phổ thông. Trường đã dùng từ trước mà vào trang báo 404 thì liên hệ nhà cung cấp dịch vụ để bật module.

Bật cổng trường

Cài đặt > Chung > tab Cổng trường (/admin/settings/general?tab=school_gate). Chỉ quản trị viên (vai trò admin) thấy khối này.

Ô	Mặc định	Ý nghĩa
Bật cổng trường	Tắt	Tắt thì trang Cổng trường không ghi lượt nào (màn hình báo "Tính năng cổng trường đang tắt…")
Báo phụ huynh khi con vào cổng	Bật	Gửi thông báo cho phụ huynh ở mỗi lượt VÀO
Báo phụ huynh khi con ra cổng	Bật	Gửi thông báo cho phụ huynh ở mỗi lượt RA
Giờ bắt đầu buổi chiều	12:00	Dạng HH:MM. Lượt vào trước giờ này thuộc buổi sáng. Dùng để cảnh báo giáo viên chủ nhiệm

Thông báo cho phụ huynh trước khi bật

Lượt qua cổng là dấu vết vị trí của trẻ vị thành niên. Chỉ bật khi nhà trường đã thông báo cho phụ huynh. Xem Quyền riêng tư.

Tài khoản cho bảo vệ

Tạo tài khoản cho bảo vệ trong Người dùng (xem Người dùng và nhóm) và tick hai vai trò:

• gate_keeper (Bảo vệ cổng): chỉ mở trang Cổng trường.
• panel_user: cửa vào trang quản trị /admin. Thiếu vai trò này thì bảo vệ đăng nhập xong bị chặn ngay ở cửa, dù đã có gate_keeper.

Bảo vệ không xem được hồ sơ học sinh, danh sách lớp, nhật ký cổng, và không huỷ được lượt cũ. Ghi nhầm chiều thì sửa ngay tại chỗ bằng nút Đảo chiều; sửa về sau là việc của giáo vụ.

Thẻ học sinh

/admin → Vận hành → Thẻ học sinh. Dành cho giáo vụ và quản trị viên.

1. Chọn Lớp (các lớp của năm học hiện tại). Bảng hiện từng học sinh đang theo học, Mã học sinh và tình trạng thẻ (Cấp ngày … hoặc Chưa có thẻ).
2. Bấm Cấp thẻ còn thiếu (N) để cấp thẻ cho các em chưa có.
3. Bấm In thẻ PDF để tải bản in của cả lớp. Nút này cũng tự cấp thẻ cho em còn thiếu trước khi in.

Bản in là khổ A4, 10 thẻ mỗi trang, mỗi thẻ cỡ thẻ ngân hàng (85,6 × 54 mm), gồm ảnh, họ tên, lớp, mã học sinh và mã QR. Ảnh học sinh dạng WebP hoặc HEIC không in được, thẻ để khung ảnh trống; đổi ảnh sang JPG hoặc PNG trong hồ sơ học sinh rồi in lại.

In lại an toàn

In lại cả lớp không bao giờ đổi mã của thẻ đang dùng: thẻ cũ in ra lần trước vẫn quét được. Chỉ em còn thiếu mới được cấp mã mới.

Cấp lại (từng em, khi mất thẻ hoặc hỏng thẻ): bấm Cấp lại ở dòng của em đó, xác nhận "Cấp lại thẻ cho …? Thẻ cũ sẽ không quét được nữa." Thẻ cũ mất hiệu lực ngay: quét nó ở cổng ra "Thẻ không hợp lệ". In lại thẻ mới cho em đó.

Mã trên thẻ là chuỗi ngẫu nhiên, không chứa mã hay số thứ tự học sinh: người nhặt được thẻ không đọc ra thông tin gì.

Màn hình cổng

/admin → Vận hành → Cổng trường. Dùng trên máy tính bảng hoặc điện thoại đặt ở cổng.

1. Bấm Quét bằng camera. Lần đầu, trình duyệt hỏi quyền camera: bấm Cho phép.
2. Học sinh đưa thẻ vào khung hình. Mỗi lượt được ghi ngay, không có bước xác nhận.
3. Thẻ kết quả hiện cỡ lớn: VÀO hoặc RA, ảnh, họ tên, lớp và giờ. Bảo vệ nhìn ảnh để đối chiếu với em đang đứng trước mặt.

Mỗi lượt có tiếng bíp (kèm rung trên máy hỗ trợ): tiếng thành công khi ghi mới, tiếng cảnh báo khi quét trùng, tiếng lỗi khi thẻ bị từ chối.

VÀO hay RA

Hệ thống tự suy chiều từ lượt gần nhất của em đó trong hôm nay, không theo giờ:

• Chưa có lượt nào hôm nay, hoặc lượt gần nhất là RA → ghi VÀO.
• Lượt gần nhất là VÀO → ghi RA.

Nhờ vậy em đi muộn lúc 11:15 hay vào học buổi chiều lúc 13:00 vẫn được ghi đúng là VÀO. Quét vào Chủ nhật hay trong hè cũng được ghi (và báo phụ huynh) như ngày thường.

Quét trùng trong 5 phút

Quét thẻ của cùng một em trong vòng 5 phút kể từ lượt gần nhất thì không ghi thêm: thẻ kết quả báo "Đã ghi VÀO lúc 07:00 — không ghi thêm" kèm tiếng cảnh báo. Em chạm thẻ hai lần liền nhau sẽ không bị ghi thành "RA" ngay sau "VÀO".

Sửa khi ghi nhầm chiều

Thẻ kết quả có một nút cho lượt mới nhất hôm nay của em đang hiện. Nút đổi theo tuổi của lượt đó:

Lượt đang hiện	Nút	Làm gì	Phụ huynh nhận
Trong 60 giây	Đảo chiều → RA (hoặc → VÀO)	Huỷ lượt vừa ghi, ghi chiều ngược lại giữ nguyên giờ	Chỉ chiều đã sửa
Quá 60 giây, trong 10 phút	Ghi chiều ngược lại → RA (hoặc → VÀO)	Lượt cũ giữ nguyên, ghi thêm một lượt chiều ngược lại lúc này	Cả hai lượt (lượt cũ có thể đã được báo)

"Đảo chiều" dùng được cả khi thẻ đang báo quét trùng: em vừa chạm thẻ lần hai sau 10 giây thì bảo vệ vẫn sửa được lượt gốc.

Thông báo có thể gặp khi bấm nút: "Đã quá thời gian đảo chiều", "Chỉ đảo được lượt mới nhất của em này", "Lượt này đã bị huỷ". Quá 10 phút thì nút không còn; nhờ giáo vụ huỷ lượt trong nhật ký.

Học sinh quên thẻ

Gõ vào ô Quên thẻ? Tìm theo tên hoặc mã học sinh (ít nhất 2 ký tự), rồi chọn đúng em trong kết quả. Lượt được ghi như khi quét thẻ (cùng luật VÀO/RA, 5 phút, đảo chiều) và mang nhãn Tìm tay trong nhật ký. Chỉ học sinh đang theo học mới hiện trong kết quả.

Khi thẻ bị từ chối

Thẻ kết quả báo	Nghĩa là	Làm gì
Thẻ không hợp lệ	Thẻ đã bị cấp lại (thẻ cũ), thẻ của trường khác, hoặc không phải thẻ học sinh	Hỏi em có thẻ mới chưa; tạm thời dùng tìm tay và báo giáo vụ
Học sinh không còn theo học	Em không thuộc lớp nào của năm học hiện tại, hoặc hồ sơ đã bị xoá	Báo giáo vụ kiểm tra hồ sơ. Em lưu ban vẫn qua bình thường
Cổng trường đang tắt	Quản trị viên chưa bật hoặc đã tắt tính năng	Báo quản trị viên

Sửa xong (cấp lại thẻ, bật cổng), quét lại được ngay mà không cần rút thẻ ra khỏi khung.

Mất mạng thì lượt chưa được ghi

Trang không có hàng đợi ngoại tuyến; giờ ghi luôn là giờ của máy chủ. Mất mạng thì dưới camera hiện biểu ngữ đỏ "Mất kết nối — mã chưa được ghi.": giữ thẻ trong khung, trang tự gửi lại sau vài giây. Biểu ngữ "Phiên đăng nhập hết hạn — tải lại trang. Mã chưa được ghi.": tải lại trang rồi quét lại. Camera chỉ mở trên trang HTTPS; không mở được camera thì vẫn dùng ô tìm tay.

Phụ huynh nhận thông báo

Mỗi lượt được ghi gửi một thông báo cho phụ huynh của em đó:

• "<Tên con> đã vào trường lúc 07:02" hoặc "<Tên con> đã ra khỏi trường lúc 16:45", kèm dòng "Cổng trường · ngày …".

Thông báo được gửi khoảng 1 phút sau lượt quét, để chừa thời gian bảo vệ sửa nhầm. Lượt bị Đảo chiều trong 60 giây không bao giờ được báo: phụ huynh chỉ thấy chiều đúng. Thông báo đã gửi thì không thu hồi được.

Phụ huynh chỉ nhận khi:

• có tài khoản cổng phụ huynh đã nối với con, và
• hồ sơ phụ huynh đang bật Nhận thông báo (xem Cổng phụ huynh).

Quản trị viên có thể tắt riêng báo khi vào hoặc báo khi ra ở khối cài đặt. Thông báo cần hàng đợi nền của hệ thống chạy; nếu phụ huynh báo không nhận được gì sau vài phút, liên hệ nhà cung cấp dịch vụ.

Cảnh báo giáo viên chủ nhiệm

Khi một em đã vào cổng nhưng đang bị ghi vắng (có phép hay không phép) ở buổi điểm danh của lớp, giáo viên chủ nhiệm nhận thông báo:

"<Học sinh> đã vào cổng lúc 07:05 nhưng đang bị ghi vắng buổi sáng": "Lớp … · ngày … · đang ghi: …. Kiểm tra lại sổ điểm danh."

Cảnh báo tính theo buổi: buổi sáng là trước Giờ bắt đầu buổi chiều (mặc định 12:00), buổi chiều là từ giờ đó trở đi. Em được coi là có mặt trong buổi khi có lượt VÀO trong buổi đó, hoặc đã vào từ trước khi buổi bắt đầu mà chưa ra.

Ví dụ	Cảnh báo?
Vào 7:00, bị ghi vắng sáng	Có
Vào 7:00, ra 7:30, bị ghi vắng sáng	Có (em đã ở trường buổi sáng)
Vào 6:50, ra 11:00, vào lại 13:00, bị ghi vắng sáng	Có
Vào 7:00 (chưa ra), bị ghi vắng chiều lúc 13:30	Có
Vào 7:00, ra 11:30, bị ghi vắng chiều	Không
Bị ghi vắng sáng, lượt vào đầu tiên trong ngày lúc 13:00	Không

Hệ thống kiểm vào hai lúc, mỗi lần chậm khoảng 1 phút: khi giáo viên lưu tờ điểm danh có em vắng, và khi em quét VÀO sau khi đã bị ghi vắng (ví dụ giáo viên ghi vắng 7:10, em tới 7:25). Mỗi em chỉ nhận tối đa một cảnh báo cho mỗi buổi.

• Cảnh báo không sửa sổ điểm danh: em có thể vào cổng rồi không lên lớp. Giáo viên chủ nhiệm kiểm tra rồi tự sửa nếu cần (xem Điểm danh buổi).
• Chỉ xét điểm danh cả buổi của hôm nay. Điền sổ cho ngày hôm qua không sinh cảnh báo.
• Vắng buổi chiều được ghi từ buổi sáng (trước giờ chiều bắt đầu) không được kiểm lúc ghi; chỉ một lượt VÀO sau đó mới kiểm lại.

Nhật ký cổng

/admin → Vận hành → Nhật ký cổng. Dành cho giáo vụ và quản trị viên.

Lọc theo Ngày, Lớp, hoặc tìm học sinh. Mỗi dòng: Thời gian, Học sinh, Chiều (VÀO / RA), Cách ghi (Quét thẻ / Tìm tay), Người ghi, và Đã huỷ (giờ huỷ và người huỷ) nếu lượt đã bị huỷ. Lượt đã huỷ, kể cả lượt bị Đảo chiều, vẫn hiện để đối chiếu.

Huỷ một lượt ghi nhầm: bấm Huỷ lượt ở dòng đó rồi xác nhận. Lượt bị huỷ không còn tính vào việc suy chiều VÀO/RA và cảnh báo giáo viên chủ nhiệm. Thông báo đã gửi cho phụ huynh không thu hồi được; nếu cần, liên hệ phụ huynh để giải thích. Nút cần quyền void_gate_pass (có sẵn cho giáo vụ và quản trị viên).

Quyền riêng tư

• Tính năng mặc định tắt; chỉ quản trị viên bật được.
• Không dùng sinh trắc học: chỉ thẻ QR và bảo vệ đối chiếu ảnh bằng mắt.
• Lượt qua cổng và dấu cảnh báo giáo viên chủ nhiệm tự xoá sau 400 ngày.
• Bảo vệ chỉ thấy thẻ kết quả của em vừa quét, không xem được hồ sơ học sinh hay nhật ký.

Quyền theo vai trò

Vai trò	Cổng trường	Thẻ học sinh	Nhật ký cổng	Huỷ lượt	Bật tính năng
Quản trị viên (admin)	Có	Có	Có	Có	Có
Giáo vụ (academic_officer)	—	Có	Có	Có	—
Bảo vệ cổng (gate_keeper, cần thêm panel_user)	Có	—	—	—	—
Giáo viên, phụ huynh	—	—	—	—	—

Quyền tương ứng trong Vai trò: page_SchoolGate, page_StudentGateCards, page_GatePassLog, void_gate_pass, configure_school_gate. Xem Vai trò và phân quyền.