zhangl1001/civil-ai

🧠 Civil AI: Nền tảng Agent giáo dục thích ứng local-first

Nền tảng Agent giáo dục thích ứng local-first cho iOS và Web, tách biệt giữa logic Agent và dữ liệu học tập, được kiểm chứng bởi 39 checks tự động trên CI.

Civil AI là nền tảng có thể tái sử dụng để xây dựng các Agent giáo dục thích ứng trên iOS và Web. Dự án tách biệt giữa cấu trúc thực thi Agent (provider-agnostic), bằng chứng học tập, dự báo mastery, lập kế hoạch, nội dung có cấu trúc, lưu trữ và ranh giới an toàn — rời khỏi các chương trình giảng dạy và chính sách miền ngành cụ thể. ứng dụng thi civil-service hiện tại là bản tham chiếu end-to-end để xác thực nền tảng này.

✨ Điểm nổi bật

• Local-first: dữ liệu học tập có cấu trúc được lưu trữ trên thiết bị theo mặc định.
• Evidence trước khi tự động hoá: Agent đưa ra quyết định dạy học, trong khi các dịch vụ xác định điểm số, trạng thái, xác thực và lưu trữ.
• Provider trung lập: nhà cung cấp mô hình chỉ là adapter, không phải phụ thuộc nghiệp vụ.
• Portability: hỗ trợ 2 gói thi, gói thứ hai cài đặt headless và chạy end-to-end, chứng tỏ curricula, môn học, chấm điểm đều là dữ liệu.
• Schema Integrity: 42 migration dữ liệu, mỗi migration đều có checksum và kiểm tra lại lịch sử áp dụng khi khởi động.
• Type discipline: từ chối hoàn toàn any, @ts-ignore, @ts-nocheck trong 609 file TypeScript và Vue.
• Size discipline: mỗi file nguồn đều có ngân sách dòng — 600 dòng mặc định, 16 ngoại lệ kế thừa.
• Verified, không phải tuyên bố: mọi tuyên bố đều được CI kiểm tra tự động thông qua npm test.

💡 Vì sao đáng chú ý

Civil AI khác biệt vì nó không chỉ tối ưu giao diện nội dung hoặc số lượng câu hỏi, mà còn duy trì mô hình rõ ràng về kiến thức mà người học hiểu, quên, hay chuyển giao. Nền tảng này áp dụng ba nguyên tắc: dữ liệu học tập lưu trữ local-first, evidence xác định quyết định dạy học, và provider trung lập để thay thế mô hình dễ dàng. Đặc biệt, nền tảng kiểm chứng thực sự qua CI với 39 checks bao gồm cả kiểm thử thực thi thực sự qua Vite SSR loader, chứng tỏ tính ổn định và khả thi.

---

#AdaptiveLearning #AIAgent #Education #LocalFirst #CivilServiceExam #TiniX