> For the complete documentation index, see [llms.txt](https://docs.enspire.online/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.enspire.online/rd/to-chuc/hoc-sinh.md).
# Học sinh
Quản lý học sinh là công cụ giúp người quản trị theo dõi thông tin chi tiết, tình trạng kích hoạt ứng dụng, thời gian học tập và trạng thái tài khoản của toàn bộ học sinh trên hệ thống. Qua trang này, bạn có thể kiểm soát hiệu quả lưu lượng người dùng đăng nhập thực tế và quản lý danh sách học sinh theo từng đơn vị trường/lớp cụ thể.
### 1. Giới thiệu chung
Trang **Quản lý học sinh** là nơi quản trị viên xem, tìm kiếm, lọc, thêm mới, chỉnh sửa và xóa thông tin học sinh đang sử dụng App. Trang được truy cập qua sidebar bên trái, mục **TỔ CHỨC → Học sinh**, tương ứng URL dạng `.../students`.
### 2. Khu vực thống kê tổng quan
Ngay đầu trang có 3 thẻ số liệu nhanh:
| Thẻ | Ý nghĩa |
| ---------------- | ----------------------------------------- |
| **Tổng bản ghi** | Tổng số học sinh hiện có trong hệ thống |
| **Đã mua App** | Số học sinh đã mua/kích hoạt gói sản phẩm |
| **Đã đăng nhập** | Số học sinh đã từng đăng nhập vào App |
### 3. Hai chế độ xem (tab danh sách)
Ngay dưới thẻ thống kê có 2 tab:
1. **Tài khoản được cấp**: danh sách học sinh được nhà trường/admin tạo tài khoản sẵn.
2. **Tài khoản tự đăng ký**: danh sách học sinh tự đăng ký qua App. Bảng ở tab này có thêm 2 cột riêng là **Ngày đăng ký** và **Nguồn đăng ký** (ví dụ: Số điện thoại, Không xác định).
Click vào tên tab để chuyển đổi giữa hai danh sách; bộ lọc và cấu trúc thao tác ở cả hai tab tương tự nhau.
### 4. Khu vực Bộ lọc
Click vào khối **"Bộ lọc"** để lộ ra các ô lọc sau (mỗi ô là dropdown, phần lớn có ô tìm kiếm bên trong khi mở):
| Bộ lọc | Chức năng |
| ---------------------------- | ----------------------------------------------------------------- |
| Ô "Tên, tài khoản, email..." | Gõ từ khóa để tìm nhanh theo tên/username/email học sinh |
| Tất cả thành phố | Lọc theo thành phố (VD: Hà Nội, Hải Phòng) |
| Tất cả quận | Chỉ có dữ liệu sau khi đã chọn thành phố tương ứng |
| Tất cả trường | Có ô tìm kiếm, chọn trường cụ thể |
| Tất cả lớp | Có ô tìm kiếm, lọc theo tên lớp (A1, C1, B1...) |
| Năm học | Chọn theo năm học: 2024-2025, 2025-2026, 2026-2027 |
| Trạng thái | Đã kích hoạt / Chưa kích hoạt |
| Trạng thái học sinh | Đang hoạt động / Đã ẩn |
| Tình trạng đăng nhập | Đã đăng nhập / Chưa đăng nhập |
| Sắp xếp | Tên A-Z, Đăng ký mới nhất, Đăng ký cũ nhất, Tích lũy sao cao–thấp |
Các bộ lọc có thể kết hợp cùng lúc; bảng dữ liệu bên dưới sẽ tự cập nhật theo lựa chọn.
### 5. Bảng danh sách học sinh
Các cột hiển thị (cuộn ngang thanh trượt dưới bảng để xem hết):
* **STT**, **Tên học sinh** (kèm username và SĐT phụ huynh bên dưới tên)
* **Trường học**, **Chương trình học/khóa học**, **Lớp**
* **Đã đăng nhập** (trạng thái + thời điểm), **Thời gian học**, **Đã mua App**
* **Trạng thái** (Đang hoạt động...), **Gói sản phẩm**, **Thời hạn gói**
Thao tác trên bảng:
* Click vào **tên học sinh** (chữ màu xanh) → mở **trang chi tiết học sinh**.
* Tick vào **checkbox** đầu mỗi dòng, hoặc checkbox trên cùng để **chọn tất cả** → hiện thanh công cụ thao tác hàng loạt (xem mục 7).
### 6. Trang chi tiết học sinh
Khi click vào tên một học sinh, hệ thống chuyển sang trang chi tiết gồm:
* Phần đầu: avatar, tên, username/email/SĐT, các nhãn trạng thái, tên trường, lớp, số sao, % hoàn thành, giờ đã học, số bản quyền.
* 2 nút thao tác: **Chỉnh sửa** và **Xóa**.
* 4 tab nội dung:
1. **Tổng quan**: biểu đồ tần suất vào app 7 ngày gần nhất, danh sách khóa học Enspire đang tham gia, khối kỹ năng nổi bật, thành tích (sao, kim cương, khóa đã hoàn thành).
2. **Thống kê học tập**: tổng thời gian học, sao tích lũy, % hoàn thành chương trình, biểu đồ radar phát triển kỹ năng (Nghe/Nói/Đọc/Viết), chi tiết hoạt động thực hành (có nút **Xuất Excel**).
3. **Hồ sơ cá nhân**: thông tin chi tiết như SĐT phụ huynh, email, phụ huynh, trường học, lớp, giới tính, ngày sinh, ngày tham gia, địa chỉ, lần cuối truy cập...
4. **Bản quyền**: danh sách sản phẩm/bản quyền đã kích hoạt cho học sinh.
#### 6.1 Chỉnh sửa thông tin học sinh
Click nút **Chỉnh sửa** → mở modal "Sửa thông tin học sinh" gồm: toggle **Trạng thái học sinh**, **Tên học sinh**, **Username**, **UserID**, **Email**, **Số điện thoại** (giới hạn 10 ký tự), **Tuổi mới**, **Trường học**, **Chọn lớp học**. Sau khi chỉnh sửa, bấm **Cập nhật** để lưu.
#### 6.2 Xóa học sinh
Click nút **Xóa** để xóa học sinh khỏi hệ thống. Đây là thao tác có thể ảnh hưởng vĩnh viễn đến dữ liệu, nên cần cân nhắc kỹ và xác nhận cẩn thận trước khi thực hiện (khuyến nghị nhà trường/admin kiểm tra kỹ thông tin học sinh trước khi xóa).
### 7. Thao tác hàng loạt (khi chọn nhiều học sinh)
Khi tick chọn ít nhất 1 checkbox trong bảng, một thanh công cụ mới xuất hiện phía trên bảng gồm:
* Nhãn **"X đã chọn"** và nút **"Xóa lựa chọn"** (bỏ chọn tất cả, không phải xóa dữ liệu).
* Dropdown **"Chọn trạng thái"** (Đang hoạt động / Đã ẩn) đi kèm nút **"Cập nhật trạng thái"** để đổi trạng thái hàng loạt cho các học sinh đã chọn.
* Nút **"Xóa mục đã chọn"** (màu đỏ) để xóa nhiều học sinh cùng lúc — thao tác nguy hiểm, cần thận trọng.
* Nút **"Xuất file Excel"** để xuất danh sách học sinh đã chọn ra file Excel.
Người dùng muốn Ẩn hoặc bật Đang hoạt động cho học sinh
* Chọn học sinh Ẩn hay đổi trạng thái
Xóa học sinh click vào button **Xóa mục đã chọn**
### 8. Phân trang
Cuối bảng hiển thị: dòng chữ "Hiển thị X-Y / Z kết quả", dropdown **"Bản ghi/trang"** (10, 25, 50, 100 dòng/trang), và các nút điều hướng trang: về trang đầu, lùi 1 trang, ô nhập số trang trực tiếp, tiến 1 trang, đến trang cuối.
### 9. Thêm học sinh mới
Nút **"+ Thêm học sinh"** nằm ở góc phải khu vực bộ lọc. Xem hướng dẫn chi tiết từng bước tại trang **"Thêm học sinh mới"** (page 2).
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://docs.enspire.online/rd/to-chuc/hoc-sinh.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.