Integrations · Track A · Sync HS từ vnEdu & CSDL MOET
🎓 Sync vnEdu & CSDL HS quốc gia · 12.480 HS · 24 trường
NB
IT Sở GD-ĐT Hà Nội
Multi-tenant Ops · Privacy
Track A only
eSign · USB PKI
Việc cần làm
Resolve 3 mismatch HS tại TH Quang Trung + verify consent cha mẹ trước Bệnh viện học đường khám sàng lọc
🎓
Sync 12.480 HS từ vnEdu + csdl.moet.gov.vn theo Quy chế Bộ GD-ĐT số 12/2023.
Sync hàng tuần · backup CSDL nội bộ. Tuân thủ NĐ 13/2023 BVDLCN trẻ em — chỉ DDV trường + Y tế +
Hiệu trưởng + Phòng GD truy cập chi tiết. Phụ huynh có quyền xem · sửa · rút consent.
QĐ 12/2023/QĐ-BGDĐT
NĐ 13/2023
Luật BVDLCN 91/2025
CRC Đ.16
🎓
HS sync
12.480
24 trường
⏱️
Last sync
2 ngày
02/05 02:00
⚠️
Mismatch
3
TH Quang Trung
🛡️
NĐ 13 compliance
100%
Audit clean
📡 3 nguồn dữ liệu
🏛️
vnEdu
Hệ thống QL GD HN · REST API · sync API gọi nhiều lần/ngày
🇻🇳
csdl.moet.gov.vn
CSDL quốc gia · sync nightly batch FTPS 02:00
💾
OmiMeal local cache
Cache + audit · phục vụ Y tế trường · DDV · phụ huynh
🏫 Trạng thái sync · 24 trường HN
| Trường | Phường/Quận | Cấp | vnEdu | CSDL MOET | OmiMeal | Mismatch | Last sync | Status |
|---|---|---|---|---|---|---|---|---|
| TH Trung Hoà | Cầu Giấy | Tiểu học | 682 | 682 | 682 | 0 | 02/05 02:01 | ✓ Clean |
| TH Yên Hoà | Cầu Giấy | Tiểu học | 748 | 748 | 748 | 0 | 02/05 02:01 | ✓ Clean |
| MN Mai Dịch | Cầu Giấy | Mầm non | 412 | 412 | 412 | 0 | 02/05 02:01 | ✓ Clean |
| THCS Yên Hoà | Cầu Giấy | THCS | 920 | 920 | 920 | 0 | 02/05 02:02 | ✓ Clean |
| THCS Cầu Giấy | Cầu Giấy | THCS | 844 | 844 | 844 | 0 | 02/05 02:02 | ✓ Clean |
| TH Dịch Vọng A | Cầu Giấy | Tiểu học | 528 | 528 | 528 | 0 | 02/05 02:03 | ✓ Clean |
| TH Quang Trung ⚠ | Hoàn Kiếm | Tiểu học | 425 | 428 | 425 | 3 | 02/05 02:03 | ⚠ Conflict |
| THCS Trưng Vương | Hoàn Kiếm | THCS | 684 | 684 | 684 | 0 | 02/05 02:03 | ✓ Clean |
| MN Hoa Sen | Hoàn Kiếm | Mầm non | 320 | 320 | 320 | 0 | 02/05 02:04 | ✓ Clean |
| TH Trần Quốc Toản | Hoàn Kiếm | Tiểu học | 472 | 472 | 472 | 0 | 02/05 02:04 | ✓ Clean |
| TH Phan Đình Phùng | Ba Đình | Tiểu học | 612 | 612 | 612 | 0 | 02/05 02:05 | ✓ Clean |
| THCS Lê Quý Đôn | Ba Đình | THCS | 895 | 895 | 895 | 0 | 02/05 02:05 | ✓ Clean |
| MN Sao Mai | Ba Đình | Mầm non | 288 | 288 | 288 | 0 | 02/05 02:06 | ✓ Clean |
| TH Đoàn Thị Điểm | Đống Đa | Tiểu học | 540 | 540 | 540 | 0 | 02/05 02:06 | ✓ Clean |
| THCS Bế Văn Đàn | Đống Đa | THCS | 726 | 726 | 726 | 0 | 02/05 02:07 | ✓ Clean |
| TH Hoàng Văn Thụ | Hai Bà Trưng | Tiểu học | 498 | 498 | 498 | 0 | 02/05 02:07 | ✓ Clean |
| 9 trường khác | 9 quận/huyện | Mixed | 3.346 | 3.346 | 3.346 | 0 | 02/05 02:15 | ✓ Clean |
🔄 Workflow sync nightly · 02:00 hằng đêm
02:00:00
Pull vnEdu API · 24 trường HN
REST API call · OAuth 2.0 token Sở GD-ĐT HN · pagination 500 records/page
02:08:42
Pull csdl.moet.gov.vn · FTPS batch
Tải file CSV mã hoá GPG từ FTPS server MOET · giải mã bằng private key Sở
02:14:15
So sánh với cache OmiMeal local
Diff 3-way: vnEdu vs MOET vs OmiMeal · phát hiện thêm/sửa/xoá HS
02:16:33
⚠ Phát hiện 3 mismatch tại TH Quang Trung
Mismatch < 1% threshold → log warning, không alert ngay · để Admin Sở review buổi sáng
02:18:04
Apply auto-resolve theo rule
12.477/12.480 HS auto-merge thành công · 3 HS giữ trạng thái CONFLICT chờ manual
02:18:56
Notify Admin Sở + Phòng GD Hoàn Kiếm
Email + Slack #integration-vnedu · subject "Mismatch nhỏ T5 03/05 — TH Quang Trung 3 HS"
02:20:00
✓ Sync hoàn tất · audit log 24 entries
Toàn bộ log push lên audit-trail.html với hash chain · NĐ 13/2023 compliance
🛡️ Privacy gate · NĐ 13/2023 + Luật BVDLCN 91/2025
✓ Được phép truy cập chi tiết HS
- Hiệu trưởng trường HS đó
- DDV trường (xem dị ứng + nhu cầu DD)
- Y tế trường (xem hồ sơ y tế đầy đủ)
- GVCN lớp (xem dị ứng cơ bản)
- Phòng GD-ĐT (admin scope phường)
- Phụ huynh (chỉ con của mình · có quyền sửa + rút consent)
✗ KHÔNG được truy cập chi tiết
- Sở GD-ĐT TP (chỉ aggregate + anonymized)
- Vendor Track B (hoàn toàn không)
- Other school (cross-school deny)
- Public (chỉ tổng hợp nuôi dưỡng)
- System Admin (chỉ audit, không xem nội dung)
- Mọi truy cập đều log audit-trail · 5 năm
Quyền của phụ huynh (NĐ 13/2023 Đ.4):
① Được biết dữ liệu nào đang lưu về con · ② Được sửa dữ liệu sai · ③ Được rút consent bất kỳ lúc nào ·
④ Được yêu cầu xoá khi con tốt nghiệp · ⑤ Được portability (xuất dữ liệu sang trường mới).
⚠ Mismatch resolution · 3 HS tại TH Quang Trung
HS-001234 · Lớp 3A2 · Mã sai (1 chữ số khác)
Conflict type: CODE_MISMATCH🏛️ vnEdu (Sở HN)
Mã HSHS-001234
Họ tênNguyễn Văn An
Ngày sinh12/05/2017
Lớp3A2
Phụ huynhNguyễn V. Hùng
≠
🇻🇳 CSDL MOET
Mã HSHS-001235
Họ tênNguyễn Văn An
Ngày sinh12/05/2017
Lớp3A2
Phụ huynhNguyễn V. Hùng
HS-002847 · Lớp 5B1 · Tên đệm khác
Conflict type: NAME_DIFF🏛️ vnEdu (Sở HN)
Mã HSHS-002847
Họ tênTrần Thị Mai Hương
Ngày sinh22/09/2015
Lớp5B1
Phụ huynhTrần V. Nam
≠
🇻🇳 CSDL MOET
Mã HSHS-002847
Họ tênTrần Thị Hương
Ngày sinh22/09/2015
Lớp5B1
Phụ huynhTrần V. Nam
HS-004102 · Lớp 2C3 · Lớp khác
Conflict type: CLASS_MISMATCH🏛️ vnEdu (Sở HN)
Mã HSHS-004102
Họ tênLê Quang Anh
Ngày sinh08/03/2018
Lớp2C3 (chuyển lớp 15/04)
Phụ huynhLê V. Đức
≠
🇻🇳 CSDL MOET
Mã HSHS-004102
Họ tênLê Quang Anh
Ngày sinh08/03/2018
Lớp2C2 (chưa cập nhật)
Phụ huynhLê V. Đức
⚙️ Cấu hình & Lịch sync
🏛️ vnEdu API
| Endpoint | https://vnedu.vn/api/v2/students |
| Auth | OAuth 2.0 · Sở GD-ĐT HN client |
| Schedule | Hằng đêm 02:00 + on-demand |
| Pagination | 500 records/page · 25 pages |
| Retry | 3 lần · backoff 5s/15s/45s |
| Timeout | 30s/request |
🇻🇳 CSDL MOET FTPS
| Endpoint | ftps://csdl.moet.gov.vn/exports/ |
| Auth | X.509 cert + GPG private key |
| Schedule | Hằng đêm 02:08 (sau vnEdu) |
| Format | CSV mã hoá GPG · 1 file/Sở |
| Backup | S3 encrypted · 5 năm |
| Validate | Schema check + checksum SHA-256 |
🗺️ Đang demo · Track A · Sync HS từ hệ thống quốc gia
Đây là backbone cho mọi feature Track A — DDV, Y tế, phụ huynh chỉ thao tác được nếu HS đã sync OK.