CHILDSAFE 1.2.2 — HUONG DAN CAI DAT / INSTALLATION
Nguyễn Lê Quốc Bảo — Founder & Developer

YÊU CẦU
Windows 11 64-bit, Python 3.10, kết nối Internet để cài thư viện.
Android 8.0 trở lên, CPU ARM64. APK là bản thử nghiệm cài trực tiếp.
Máy Windows và điện thoại phải kết nối được với nhau qua mạng nội bộ.
Parent Server cần tiếp tục chạy trong khi sử dụng Agent.

1. Giải nén bộ ZIP vào thư mục ngắn, ví dụ C:\ChildSafe.
2. Mở START_HERE.bat bằng quyền quản trị. Chọn 1 kiểm tra máy, 2 cài Parent Server.
   Bước cài tải các thư viện Python; nếu thiếu Python, script thử cài qua winget.
3. Bật Windows Mobile Hotspot hoặc kết nối hai thiết bị vào mạng nội bộ phù hợp.
   Chọn 3 chạy Parent Server, 4 mở Dashboard. Script chạy tạo các quy tắc Firewall.
4. Trên máy Windows mở http://127.0.0.1:8000. Đăng ký tài khoản phụ huynh mới,
   thêm hồ sơ trẻ, rồi tạo mã ghép nối trong mục Trẻ & thiết bị.
5. Trên Android mở APK/ChildSafe-Agent-1.2.2.apk. Cho phép cài từ nguồn đã chọn
   nếu bạn tin cậy file. Không cần build Android để dùng APK có sẵn.
6. Trong Agent nhập http://IP_NOI_BO_MAY_WINDOWS:8000, mã ghép nối và tên thiết bị.
   IP nội bộ xem trong cửa sổ Parent Server; không nhập 127.0.0.1 trên điện thoại.
7. Chấp thuận quyền VPN của Android, bật bảo vệ, thử chặn example.com và xem nhật ký.
8. Nếu cần tự build APK, xem Docs/01_HUONG_DAN_CAI_DAT_TU_DAU.md và
   AndroidAgent/build_debug_apk.ps1; cần thêm JDK 17 và Android SDK/NDK tương ứng.

LƯU Ý
- Đây là bản thử nghiệm nghiên cứu, không phải bộ cài EXE hoặc ứng dụng Google Play.
- Cấu hình mạng và quyền VPN tác động tới kết nối của điện thoại. Chỉ thử trên thiết bị
  của bạn hoặc được chủ sở hữu đồng ý; dùng mạng nội bộ tin cậy, không mở cổng ra Internet.
- Chưa kiểm thử lại việc cài mới trên máy Windows/Android khác trong lần đóng gói này.
- Bản nguồn không có mô hình đã huấn luyện. Phân loại mặc định dùng bộ quy tắc/từ khóa;
  hỗ trợ nạp mô hình tùy chọn nếu người phát triển tự cung cấp.
- Bộ ZIP không kèm cơ sở dữ liệu đang sử dụng, mật khẩu SMTP hoặc token ghép nối của tác giả.
- Khi cập nhật máy đang dùng, tự sao lưu database và cấu hình riêng trước; không chia sẻ bản sao đó.
- Mục phát APK qua Wi-Fi trong menu cũ tìm APK tự build. Với APK có sẵn, dùng file
  trong APK/ hoặc nút tải APK trên website, không bắt buộc dùng mục phát Wi-Fi.
- Dừng bảo vệ trong Agent để ngừng VPN. Xem hướng dẫn xử lý lỗi trong Docs/.

CHECK FILE
Đối chiếu SHA-256 với SHA256SUMS.txt trên trang tải. Giữ nguyên giấy phép của
các thành phần bên thứ ba. Xem THIRD_PARTY_NOTICES.md.