Learner Model & Recommendation

Hai engine chạy bằng AI, giúp hệ thống hiểu từng thành viên và gợi ý nội dung đúng lúc. Cả hai đều gọi qua Cloudflare AI Gateway và được điều phối bởi Cloudflare Workflow MemberIntelligenceWorkflow.

Luồng chạy

Thành viên tạo bằng chứng mới (khai báo, phản hồi, kết quả học)
        ↓
member_intelligence_runs  →  MemberIntelligenceWorkflow
        ↓
  1. rebuildMemberModel, tổng hợp theo quy tắc, cập nhật member_model_dimensions
  2. synthesizeLearnerModel, AI viết chân dung người học, ghi learner_model_ai
  3. computeAndCacheContentRelevance, AI chấm mức phù hợp của từng khoá học và sách

Bước 2 và 3 không chặn: nếu lỗi thì bỏ qua, không làm hỏng cả lượt chạy.

Learner Model

learner_model_ai lưu chân dung tổng hợp của người học: tóm tắt, điểm mạnh, điểm cần cải thiện, trọng tâm nên tập trung. Engine tự giới hạn tần suất khoảng 6 giờ để không gọi AI thừa.

Nguồn dữ liệu: member_model_dimensions (các chiều năng lực có độ tin cậy và độ tươi), hồ sơ nghề nghiệp, và bằng chứng người học tự khai.

Recommendation Engine

Trước đây phần gợi ý chấm bằng cách đếm từ trùng nhau, dẫn tới việc mọi quyển sách đều nhận cùng một lời giải thích khó hiểu. Nay engine dùng AI chấm từng nội dung dựa trên chân dung người học.

Quy tắc:

• Mỗi khoá học và mỗi quyển sách nhận một mức 1–5 và một câu lý do riêng bằng tiếng Việt, gắn với mục tiêu hoặc nghề nghiệp cụ thể của người đó
• Tối đa 3 nội dung được nhận mức 5, để mức "5/5" giữ được ý nghĩa
• Kết quả lưu ở content_relevance_assessments với evidence_dimension='ai', hạn dùng 72 giờ
• Đường đọc ưu tiên bộ nhớ đệm AI; nội dung nào chưa được AI chấm thì tạm dùng cách chấm cũ

Ví dụ kết quả thật cho một thành viên làm Coach/Consultant:

Mức	Khoá học	Lý do
5	Personal Branding	Phù hợp với mục tiêu xây dựng hình ảnh của một Coach/Consultant đáng tin cậy
5	Sales	Giúp nâng cao năng lực quan trọng trong việc tư vấn và bán hàng
4	Customer Understanding	Giúp hiểu rõ hơn về khách hàng và nhu cầu của họ

Mã nguồn

Tệp	Việc
src/workflows/member-intelligence.ts	Workflow điều phối ba bước
src/domains/member-intelligence/learner-model-ai.ts	Tổng hợp chân dung người học
src/domains/member-intelligence/content-relevance-ai.ts	Chấm mức phù hợp bằng AI
src/domains/member-intelligence/content-relevance.ts	Đường đọc, ưu tiên bộ nhớ đệm AI