From a2976ff26ace2946cb7198fba20e91aa8bd37253 Mon Sep 17 00:00:00 2001 From: meewaldor Date: Sat, 20 Dec 2025 12:00:12 +0700 Subject: [PATCH 01/29] Add educational resources and update assignment content - Added image URLs for several educational institutions in `organizationData.json`. - Updated answer correctness in `answerData.json` for multiple questions. - Modified assignment descriptions in `assignmentQuestionData.json` for micro:bit projects. - Introduced new content sections in `contentData.json` about drawbridges. - Expanded rubric criteria in `rubricCriterionData.json` with detailed descriptions and point allocations. --- .../Helpers/SeedData/organizationData.json | 5 + .../Helpers/SeedData/answerData.json | 42 ++-- .../SeedData/assignmentQuestionData.json | 116 ++++++++++- .../Helpers/SeedData/contentData.json | 156 ++++++++++++++ .../Helpers/SeedData/rubricCriterionData.json | 192 ++++++++++++++++++ 5 files changed, 488 insertions(+), 23 deletions(-) diff --git a/src/Services/OrderService/Order.Infrastructure/Helpers/SeedData/organizationData.json b/src/Services/OrderService/Order.Infrastructure/Helpers/SeedData/organizationData.json index 0dd22934d..7ada5ad0c 100644 --- a/src/Services/OrderService/Order.Infrastructure/Helpers/SeedData/organizationData.json +++ b/src/Services/OrderService/Order.Infrastructure/Helpers/SeedData/organizationData.json @@ -2,30 +2,35 @@ { "name": "Trường Tiểu học Vinschool Grand Park", "code": "TRU3F2A1C", + "imageUrl": "https://res.cloudinary.com/dms8gue1c/image/upload/v1765710373/mqjr1oiok6svqt8i4rpj.jpg", "organizationTypeId": 1, "description": "Trường Tiểu học Vinschool Grand Park là một phần của hệ thống giáo dục Vinschool do Tập đoàn Vingroup đầu tư phát triển. Trường áp dụng mô hình giáo dục song ngữ chất lượng cao với chương trình Việt Nam kết hợp chương trình Cambridge quốc tế, được thiết kế phù hợp với học sinh tiểu học tại Việt Nam. Với cơ sở vật chất hiện đại, đội ngũ giáo viên tận tâm và nền tảng công nghệ hỗ trợ học tập tiên tiến, Vinschool Grand Park mang đến môi trường giáo dục toàn diện giúp học sinh phát triển toàn diện cả về tri thức, kỹ năng và phẩm chất." }, { "name": "Trường Quốc tế Bắc Mỹ (SNA)", "code": "TRU6AF91D", + "imageUrl": "https://res.cloudinary.com/dms8gue1c/image/upload/v1766202611/images_2_tbssyf.jpg", "organizationTypeId": 1, "description": "Trường Quốc tế Bắc Mỹ (SNA) là một trong số ít trường quốc tế tại Việt Nam giảng dạy hoàn toàn bằng tiếng Anh và triển khai chương trình Tú tài Quốc tế (IB) toàn phần. Với cấp Tiểu học, SNA áp dụng chương trình IB PYP giúp học sinh phát triển tư duy phản biện, kỹ năng giao tiếp và năng lực học tập suốt đời trong môi trường quốc tế hiện đại." }, { "name": "Trường Quốc tế Anh – BIS HCM", "code": "TRU9C1B7F", + "imageUrl": "https://res.cloudinary.com/dms8gue1c/image/upload/v1766202676/bis_yrxwca.jpg", "organizationTypeId": 1, "description": "Trường Quốc tế Anh TP.HCM (BIS HCM) là một trong những trường quốc tế hàng đầu tại Việt Nam, giảng dạy theo Chương trình Giáo dục Quốc gia Anh quốc, kết hợp với chương trình Tú tài Quốc tế (IB) ở bậc cao. Ở cấp Tiểu học, trường chú trọng xây dựng nền tảng kiến thức vững chắc, rèn luyện tư duy phản biện và khuyến khích học sinh phát triển toàn diện qua các hoạt động ngoại khoá đa dạng." }, { "name": "Trường Quốc tế Châu Âu HCM (EIS)", "code": "TRU0D4E8A", + "imageUrl": "https://res.cloudinary.com/dms8gue1c/image/upload/v1766202785/ssis_whz7qm.png", "organizationTypeId": 1, "description": "Trường Quốc tế Châu Âu TP.HCM (EIS) mang đến một môi trường học tập thân thiện, gắn kết và đa văn hóa. Ở cấp Tiểu học, trường áp dụng chương trình IB PYP với triết lý giáo dục cá nhân hóa, chú trọng phát triển toàn diện năng lực học sinh thông qua học tập dựa trên truy vấn, sáng tạo và hợp tác." }, { "name": "Trường Quốc tế Nam Sài Gòn (SSIS)", "code": "TRU4E8C2D", + "imageUrl": "https://res.cloudinary.com/dms8gue1c/image/upload/v1766202786/EIS_Logo_footer_xsyytc.png", "organizationTypeId": 1, "description": "Trường Quốc tế Nam Sài Gòn (SSIS) cung cấp chương trình giáo dục theo tiêu chuẩn Mỹ, từ bậc Tiểu học đến Trung học phổ thông. Ở cấp Tiểu học, SSIS tích hợp chương trình học thuật nghiêm ngặt với các hoạt động phát triển kỹ năng, đạo đức và giá trị sống, giúp học sinh trở thành những công dân toàn cầu giàu tri thức và trách nhiệm." } diff --git a/src/Services/Resource/Resource.Infrastructure/Helpers/SeedData/answerData.json b/src/Services/Resource/Resource.Infrastructure/Helpers/SeedData/answerData.json index df62d6a79..2d009409a 100644 --- a/src/Services/Resource/Resource.Infrastructure/Helpers/SeedData/answerData.json +++ b/src/Services/Resource/Resource.Infrastructure/Helpers/SeedData/answerData.json @@ -110,12 +110,12 @@ }, { "Content": "Giúp tàu thuyền đi qua bằng cách nâng mặt cầu lên", - "IsCorrect": false, + "IsCorrect": true, "QuestionId": 6 }, { "Content": "Ngăn nước sông chảy", - "IsCorrect": true, + "IsCorrect": false, "QuestionId": 6 }, { @@ -126,7 +126,7 @@ { "Content": "Lực gió", - "IsCorrect": true, + "IsCorrect": false, "QuestionId": 7 }, { @@ -214,12 +214,12 @@ }, { "Content": "Giúp tàu thuyền đi qua bằng cách nâng mặt cầu lên", - "IsCorrect": false, + "IsCorrect": true, "QuestionId": 11 }, { "Content": "Ngăn nước sông chảy", - "IsCorrect": true, + "IsCorrect": false, "QuestionId": 11 }, { @@ -230,7 +230,7 @@ { "Content": "Lực gió", - "IsCorrect": true, + "IsCorrect": false, "QuestionId": 12 }, { @@ -318,12 +318,12 @@ }, { "Content": "Giúp tàu thuyền đi qua bằng cách nâng mặt cầu lên", - "IsCorrect": false, + "IsCorrect": true, "QuestionId": 16 }, { "Content": "Ngăn nước sông chảy", - "IsCorrect": true, + "IsCorrect": false, "QuestionId": 16 }, { @@ -334,7 +334,7 @@ { "Content": "Lực gió", - "IsCorrect": true, + "IsCorrect": false, "QuestionId": 17 }, { @@ -422,12 +422,12 @@ }, { "Content": "Giúp tàu thuyền đi qua bằng cách nâng mặt cầu lên", - "IsCorrect": false, + "IsCorrect": true, "QuestionId": 21 }, { "Content": "Ngăn nước sông chảy", - "IsCorrect": true, + "IsCorrect": false, "QuestionId": 21 }, { @@ -438,7 +438,7 @@ { "Content": "Lực gió", - "IsCorrect": true, + "IsCorrect": false, "QuestionId": 22 }, { @@ -526,12 +526,12 @@ }, { "Content": "Giúp tàu thuyền đi qua bằng cách nâng mặt cầu lên", - "IsCorrect": false, + "IsCorrect": true, "QuestionId": 26 }, { "Content": "Ngăn nước sông chảy", - "IsCorrect": true, + "IsCorrect": false, "QuestionId": 26 }, { @@ -542,7 +542,7 @@ { "Content": "Lực gió", - "IsCorrect": true, + "IsCorrect": false, "QuestionId": 27 }, { @@ -630,12 +630,12 @@ }, { "Content": "Giúp tàu thuyền đi qua bằng cách nâng mặt cầu lên", - "IsCorrect": false, + "IsCorrect": true, "QuestionId": 31 }, { "Content": "Ngăn nước sông chảy", - "IsCorrect": true, + "IsCorrect": false, "QuestionId": 31 }, { @@ -646,7 +646,7 @@ { "Content": "Lực gió", - "IsCorrect": true, + "IsCorrect": false, "QuestionId": 32 }, { @@ -734,12 +734,12 @@ }, { "Content": "Giúp tàu thuyền đi qua bằng cách nâng mặt cầu lên", - "IsCorrect": false, + "IsCorrect": true, "QuestionId": 36 }, { "Content": "Ngăn nước sông chảy", - "IsCorrect": true, + "IsCorrect": false, "QuestionId": 36 }, { @@ -750,7 +750,7 @@ { "Content": "Lực gió", - "IsCorrect": true, + "IsCorrect": false, "QuestionId": 37 }, { diff --git a/src/Services/Resource/Resource.Infrastructure/Helpers/SeedData/assignmentQuestionData.json b/src/Services/Resource/Resource.Infrastructure/Helpers/SeedData/assignmentQuestionData.json index 5fdf76a6d..bcf55e09f 100644 --- a/src/Services/Resource/Resource.Infrastructure/Helpers/SeedData/assignmentQuestionData.json +++ b/src/Services/Resource/Resource.Infrastructure/Helpers/SeedData/assignmentQuestionData.json @@ -2,14 +2,126 @@ { "AssignmentId": 1, "Type": "Text", - "Content": "Hãy mô tả chi tiết cách cầu nâng hoạt động dựa trên nguyên lý đòn bẩy. Giải thích các bộ phận chính của cầu nâng và vai trò của chúng trong việc nâng và hạ cầu.", + "Content": "Hãy nộp link chia sẻ (shared link) của project micro:bit mà bạn đã hoàn thành ở Section 4. Đảm bảo project đã được chia sẻ công khai và có thể truy cập được để giáo viên kiểm tra.", "OrderIndex": 1, "Points": 25 }, { "AssignmentId": 1, "Type": "FileUpload", - "Content": "Hãy nộp hình ảnh hoặc video mô hình cầu nâng mà bạn đã xây dựng. Đảm bảo hình ảnh/video rõ ràng, thể hiện được cấu trúc và cách hoạt động của mô hình.", + "Content": "Truy cập vào link sau (https://www.stemifi.com/vi/lab/microbit-ai), import mô hình AI đã được train ở Section 5. Kết nối mô hình này với micro:bit đã được nạp code trước đó và gắn micro:bit vào mô hình vật lý. Quan sát tín hiệu được gửi từ mô hình AI đến micro:bit để điều khiển hoạt động của mô hình. Ghi lại toàn bộ quá trình và nộp video minh chứng.", + "OrderIndex": 2, + "Points": 30 + }, + { + "AssignmentId": 2, + "Type": "Text", + "Content": "Hãy nộp link chia sẻ (shared link) của project micro:bit mà bạn đã hoàn thành ở Section 4. Đảm bảo project đã được chia sẻ công khai và có thể truy cập được để giáo viên kiểm tra.", + "OrderIndex": 1, + "Points": 25 + }, + { + "AssignmentId": 2, + "Type": "FileUpload", + "Content": "Truy cập vào link sau (https://www.stemifi.com/vi/lab/microbit-ai), import mô hình AI đã được train ở Section 5. Kết nối mô hình này với micro:bit đã được nạp code trước đó và gắn micro:bit vào mô hình vật lý. Quan sát tín hiệu được gửi từ mô hình AI đến micro:bit để điều khiển hoạt động của mô hình. Ghi lại toàn bộ quá trình và nộp video minh chứng.", + "OrderIndex": 2, + "Points": 30 + }, + { + "AssignmentId": 3, + "Type": "Text", + "Content": "Hãy nộp link chia sẻ (shared link) của project micro:bit mà bạn đã hoàn thành ở Section 4. Đảm bảo project đã được chia sẻ công khai và có thể truy cập được để giáo viên kiểm tra.", + "OrderIndex": 1, + "Points": 25 + }, + { + "AssignmentId": 3, + "Type": "FileUpload", + "Content": "Truy cập vào link sau (https://www.stemifi.com/vi/lab/microbit-ai), import mô hình AI đã được train ở Section 5. Kết nối mô hình này với micro:bit đã được nạp code trước đó và gắn micro:bit vào mô hình vật lý. Quan sát tín hiệu được gửi từ mô hình AI đến micro:bit để điều khiển hoạt động của mô hình. Ghi lại toàn bộ quá trình và nộp video minh chứng.", + "OrderIndex": 2, + "Points": 30 + }, + { + "AssignmentId": 4, + "Type": "Text", + "Content": "Hãy nộp link chia sẻ (shared link) của project micro:bit mà bạn đã hoàn thành ở Section 4. Đảm bảo project đã được chia sẻ công khai và có thể truy cập được để giáo viên kiểm tra.", + "OrderIndex": 1, + "Points": 25 + }, + { + "AssignmentId": 4, + "Type": "FileUpload", + "Content": "Truy cập vào link sau (https://www.stemifi.com/vi/lab/microbit-ai), import mô hình AI đã được train ở Section 5. Kết nối mô hình này với micro:bit đã được nạp code trước đó và gắn micro:bit vào mô hình vật lý. Quan sát tín hiệu được gửi từ mô hình AI đến micro:bit để điều khiển hoạt động của mô hình. Ghi lại toàn bộ quá trình và nộp video minh chứng.", + "OrderIndex": 2, + "Points": 30 + }, + { + "AssignmentId": 5, + "Type": "Text", + "Content": "Hãy nộp link chia sẻ (shared link) của project micro:bit mà bạn đã hoàn thành ở Section 4. Đảm bảo project đã được chia sẻ công khai và có thể truy cập được để giáo viên kiểm tra.", + "OrderIndex": 1, + "Points": 25 + }, + { + "AssignmentId": 5, + "Type": "FileUpload", + "Content": "Truy cập vào link sau (https://www.stemifi.com/vi/lab/microbit-ai), import mô hình AI đã được train ở Section 5. Kết nối mô hình này với micro:bit đã được nạp code trước đó và gắn micro:bit vào mô hình vật lý. Quan sát tín hiệu được gửi từ mô hình AI đến micro:bit để điều khiển hoạt động của mô hình. Ghi lại toàn bộ quá trình và nộp video minh chứng.", + "OrderIndex": 2, + "Points": 30 + }, + { + "AssignmentId": 6, + "Type": "Text", + "Content": "Hãy nộp link chia sẻ (shared link) của project micro:bit mà bạn đã hoàn thành ở Section 4. Đảm bảo project đã được chia sẻ công khai và có thể truy cập được để giáo viên kiểm tra.", + "OrderIndex": 1, + "Points": 25 + }, + { + "AssignmentId": 6, + "Type": "FileUpload", + "Content": "Truy cập vào link sau (https://www.stemifi.com/vi/lab/microbit-ai), import mô hình AI đã được train ở Section 5. Kết nối mô hình này với micro:bit đã được nạp code trước đó và gắn micro:bit vào mô hình vật lý. Quan sát tín hiệu được gửi từ mô hình AI đến micro:bit để điều khiển hoạt động của mô hình. Ghi lại toàn bộ quá trình và nộp video minh chứng.", + "OrderIndex": 2, + "Points": 30 + }, + { + "AssignmentId": 7, + "Type": "Text", + "Content": "Hãy nộp link chia sẻ (shared link) của project micro:bit mà bạn đã hoàn thành ở Section 4. Đảm bảo project đã được chia sẻ công khai và có thể truy cập được để giáo viên kiểm tra.", + "OrderIndex": 1, + "Points": 25 + }, + { + "AssignmentId": 7, + "Type": "FileUpload", + "Content": "Truy cập vào link sau (https://www.stemifi.com/vi/lab/microbit-ai), import mô hình AI đã được train ở Section 5. Kết nối mô hình này với micro:bit đã được nạp code trước đó và gắn micro:bit vào mô hình vật lý. Quan sát tín hiệu được gửi từ mô hình AI đến micro:bit để điều khiển hoạt động của mô hình. Ghi lại toàn bộ quá trình và nộp video minh chứng.", + "OrderIndex": 2, + "Points": 30 + }, + { + "AssignmentId": 8, + "Type": "Text", + "Content": "Hãy nộp link chia sẻ (shared link) của project micro:bit mà bạn đã hoàn thành ở Section 4. Đảm bảo project đã được chia sẻ công khai và có thể truy cập được để giáo viên kiểm tra.", + "OrderIndex": 1, + "Points": 25 + }, + { + "AssignmentId": 8, + "Type": "FileUpload", + "Content": "Truy cập vào link sau (https://www.stemifi.com/vi/lab/microbit-ai), import mô hình AI đã được train ở Section 5. Kết nối mô hình này với micro:bit đã được nạp code trước đó và gắn micro:bit vào mô hình vật lý. Quan sát tín hiệu được gửi từ mô hình AI đến micro:bit để điều khiển hoạt động của mô hình. Ghi lại toàn bộ quá trình và nộp video minh chứng.", + "OrderIndex": 2, + "Points": 30 + }, + { + "AssignmentId": 9, + "Type": "Text", + "Content": "Hãy nộp link chia sẻ (shared link) của project micro:bit mà bạn đã hoàn thành ở Section 4. Đảm bảo project đã được chia sẻ công khai và có thể truy cập được để giáo viên kiểm tra.", + "OrderIndex": 1, + "Points": 25 + }, + { + "AssignmentId": 9, + "Type": "FileUpload", + "Content": "Truy cập vào link sau (https://www.stemifi.com/vi/lab/microbit-ai), import mô hình AI đã được train ở Section 5. Kết nối mô hình này với micro:bit đã được nạp code trước đó và gắn micro:bit vào mô hình vật lý. Quan sát tín hiệu được gửi từ mô hình AI đến micro:bit để điều khiển hoạt động của mô hình. Ghi lại toàn bộ quá trình và nộp video minh chứng.", "OrderIndex": 2, "Points": 30 } diff --git a/src/Services/Resource/Resource.Infrastructure/Helpers/SeedData/contentData.json b/src/Services/Resource/Resource.Infrastructure/Helpers/SeedData/contentData.json index 08dc32e19..c09633fb7 100644 --- a/src/Services/Resource/Resource.Infrastructure/Helpers/SeedData/contentData.json +++ b/src/Services/Resource/Resource.Infrastructure/Helpers/SeedData/contentData.json @@ -124,5 +124,161 @@ "ContentBody": "", "Status": "Published", "SectionId": 47 + }, + { + "ContentType": "Text", + "ContentBody": "

Tổng quan bài học

Giải thích cách cầu nâng (drawbridge) đã tận dụng lợi thế cơ học của đòn bẩy trong suốt lịch sử và trong thế giới hiện đại để phục vụ xây dựng và giao thông, cũng như vai trò của con người trong việc vận hành cầu nâng.

Từ thời cổ đại đến hiện đại, cầu nâng đã tận dụng lợi thế cơ học của đòn bẩy để nâng và hạ những nhịp cầu nặng với lực tác động nhỏ hơn nhiều. Trong các lâu đài thời trung cổ, cầu nâng thường được thiết kế như một đòn bẩy loại 1, trong đó trục quay đóng vai trò là điểm tựa, phần cầu là tải trọng, và lực kéo được tạo ra bằng dây xích, đối trọng hoặc tay quay. Thiết kế này cho phép con người nâng cầu một cách hiệu quả để bảo vệ thành trì hoặc cho thuyền bè đi qua.

Mặc dù cây cầu rất nặng, làm thế nào mà cầu nâng vẫn có thể từ từ nâng lên khi có tàu thuyền đi qua, và những bộ phận nào giúp cây cầu chuyển động an toàn như vậy?

Cầu nâng giúp tàu thuyền di chuyển an toàn qua các kênh sông bằng cách tạm thời dừng lưu thông của xe hơi. Với micro:bit V2, micro thu âm sẽ lắng nghe các tiếng động — chẳng hạn như tiếng vỗ tay. Khi phát hiện âm thanh thành công, động cơ servo sẽ kéo cơ cấu liên kết để nâng cầu lên, tạo lối đi cho tàu thuyền.
Bo mạch Robotics cũng đóng vai trò như một vật nặng giúp giữ ổn định, để khi cầu hạ xuống, mọi thứ hoạt động trơn tru và an toàn.

Cầu nâng có thể nâng lên khi tàu thuyền đi qua là nhờ vào nguyên lý nào sau đây?
🧑‍🏫 Câu trả lời
Học sinh sẽ không thấy câu trả lời này
A.✘
Sức gió thổi mạnh
B.✔
Nguyên lý đòn bẩy và đối trọng
💡 Cầu nâng rất nặng, nhưng nhờ nguyên lý đòn bẩy và đối trọng, trọng lượng của cầu được cân bằng một phần bởi các bộ phận hỗ trợ. Nhờ đó, cầu có thể được nâng lên và hạ xuống một cách dễ dàng, an toàn và từ từ, giúp tàu thuyền đi qua mà không cần dùng quá nhiều lực.
C.✘
Nhiệt độ không khí tăng cao
D.✘
Áp lực của nước sông

", + "Status": "Published", + "SectionId": 7 + }, + { + "ContentType": "Text", + "ContentBody": "

Tổng quan bài học

Giải thích cách cầu nâng (drawbridge) đã tận dụng lợi thế cơ học của đòn bẩy trong suốt lịch sử và trong thế giới hiện đại để phục vụ xây dựng và giao thông, cũng như vai trò của con người trong việc vận hành cầu nâng.

Từ thời cổ đại đến hiện đại, cầu nâng đã tận dụng lợi thế cơ học của đòn bẩy để nâng và hạ những nhịp cầu nặng với lực tác động nhỏ hơn nhiều. Trong các lâu đài thời trung cổ, cầu nâng thường được thiết kế như một đòn bẩy loại 1, trong đó trục quay đóng vai trò là điểm tựa, phần cầu là tải trọng, và lực kéo được tạo ra bằng dây xích, đối trọng hoặc tay quay. Thiết kế này cho phép con người nâng cầu một cách hiệu quả để bảo vệ thành trì hoặc cho thuyền bè đi qua.

Mặc dù cây cầu rất nặng, làm thế nào mà cầu nâng vẫn có thể từ từ nâng lên khi có tàu thuyền đi qua, và những bộ phận nào giúp cây cầu chuyển động an toàn như vậy?

Cầu nâng giúp tàu thuyền di chuyển an toàn qua các kênh sông bằng cách tạm thời dừng lưu thông của xe hơi. Với micro:bit V2, micro thu âm sẽ lắng nghe các tiếng động — chẳng hạn như tiếng vỗ tay. Khi phát hiện âm thanh thành công, động cơ servo sẽ kéo cơ cấu liên kết để nâng cầu lên, tạo lối đi cho tàu thuyền.
Bo mạch Robotics cũng đóng vai trò như một vật nặng giúp giữ ổn định, để khi cầu hạ xuống, mọi thứ hoạt động trơn tru và an toàn.

Cầu nâng có thể nâng lên khi tàu thuyền đi qua là nhờ vào nguyên lý nào sau đây?
🧑‍🏫 Câu trả lời
Học sinh sẽ không thấy câu trả lời này
A.✘
Sức gió thổi mạnh
B.✔
Nguyên lý đòn bẩy và đối trọng
💡 Cầu nâng rất nặng, nhưng nhờ nguyên lý đòn bẩy và đối trọng, trọng lượng của cầu được cân bằng một phần bởi các bộ phận hỗ trợ. Nhờ đó, cầu có thể được nâng lên và hạ xuống một cách dễ dàng, an toàn và từ từ, giúp tàu thuyền đi qua mà không cần dùng quá nhiều lực.
C.✘
Nhiệt độ không khí tăng cao
D.✘
Áp lực của nước sông

", + "Status": "Published", + "SectionId": 8 + }, + { + "ContentType": "Text", + "ContentBody": "

Tổng quan bài học

Giải thích cách cầu nâng (drawbridge) đã tận dụng lợi thế cơ học của đòn bẩy trong suốt lịch sử và trong thế giới hiện đại để phục vụ xây dựng và giao thông, cũng như vai trò của con người trong việc vận hành cầu nâng.

Từ thời cổ đại đến hiện đại, cầu nâng đã tận dụng lợi thế cơ học của đòn bẩy để nâng và hạ những nhịp cầu nặng với lực tác động nhỏ hơn nhiều. Trong các lâu đài thời trung cổ, cầu nâng thường được thiết kế như một đòn bẩy loại 1, trong đó trục quay đóng vai trò là điểm tựa, phần cầu là tải trọng, và lực kéo được tạo ra bằng dây xích, đối trọng hoặc tay quay. Thiết kế này cho phép con người nâng cầu một cách hiệu quả để bảo vệ thành trì hoặc cho thuyền bè đi qua.

Mặc dù cây cầu rất nặng, làm thế nào mà cầu nâng vẫn có thể từ từ nâng lên khi có tàu thuyền đi qua, và những bộ phận nào giúp cây cầu chuyển động an toàn như vậy?

Cầu nâng giúp tàu thuyền di chuyển an toàn qua các kênh sông bằng cách tạm thời dừng lưu thông của xe hơi. Với micro:bit V2, micro thu âm sẽ lắng nghe các tiếng động — chẳng hạn như tiếng vỗ tay. Khi phát hiện âm thanh thành công, động cơ servo sẽ kéo cơ cấu liên kết để nâng cầu lên, tạo lối đi cho tàu thuyền.
Bo mạch Robotics cũng đóng vai trò như một vật nặng giúp giữ ổn định, để khi cầu hạ xuống, mọi thứ hoạt động trơn tru và an toàn.

Cầu nâng có thể nâng lên khi tàu thuyền đi qua là nhờ vào nguyên lý nào sau đây?
🧑‍🏫 Câu trả lời
Học sinh sẽ không thấy câu trả lời này
A.✘
Sức gió thổi mạnh
B.✔
Nguyên lý đòn bẩy và đối trọng
💡 Cầu nâng rất nặng, nhưng nhờ nguyên lý đòn bẩy và đối trọng, trọng lượng của cầu được cân bằng một phần bởi các bộ phận hỗ trợ. Nhờ đó, cầu có thể được nâng lên và hạ xuống một cách dễ dàng, an toàn và từ từ, giúp tàu thuyền đi qua mà không cần dùng quá nhiều lực.
C.✘
Nhiệt độ không khí tăng cao
D.✘
Áp lực của nước sông

", + "Status": "Published", + "SectionId": 10 + }, + { + "ContentType": "Text", + "ContentBody": "

Tổng quan bài học

Giải thích cách cầu nâng (drawbridge) đã tận dụng lợi thế cơ học của đòn bẩy trong suốt lịch sử và trong thế giới hiện đại để phục vụ xây dựng và giao thông, cũng như vai trò của con người trong việc vận hành cầu nâng.

Từ thời cổ đại đến hiện đại, cầu nâng đã tận dụng lợi thế cơ học của đòn bẩy để nâng và hạ những nhịp cầu nặng với lực tác động nhỏ hơn nhiều. Trong các lâu đài thời trung cổ, cầu nâng thường được thiết kế như một đòn bẩy loại 1, trong đó trục quay đóng vai trò là điểm tựa, phần cầu là tải trọng, và lực kéo được tạo ra bằng dây xích, đối trọng hoặc tay quay. Thiết kế này cho phép con người nâng cầu một cách hiệu quả để bảo vệ thành trì hoặc cho thuyền bè đi qua.

Mặc dù cây cầu rất nặng, làm thế nào mà cầu nâng vẫn có thể từ từ nâng lên khi có tàu thuyền đi qua, và những bộ phận nào giúp cây cầu chuyển động an toàn như vậy?

Cầu nâng giúp tàu thuyền di chuyển an toàn qua các kênh sông bằng cách tạm thời dừng lưu thông của xe hơi. Với micro:bit V2, micro thu âm sẽ lắng nghe các tiếng động — chẳng hạn như tiếng vỗ tay. Khi phát hiện âm thanh thành công, động cơ servo sẽ kéo cơ cấu liên kết để nâng cầu lên, tạo lối đi cho tàu thuyền.
Bo mạch Robotics cũng đóng vai trò như một vật nặng giúp giữ ổn định, để khi cầu hạ xuống, mọi thứ hoạt động trơn tru và an toàn.

Cầu nâng có thể nâng lên khi tàu thuyền đi qua là nhờ vào nguyên lý nào sau đây?
🧑‍🏫 Câu trả lời
Học sinh sẽ không thấy câu trả lời này
A.✘
Sức gió thổi mạnh
B.✔
Nguyên lý đòn bẩy và đối trọng
💡 Cầu nâng rất nặng, nhưng nhờ nguyên lý đòn bẩy và đối trọng, trọng lượng của cầu được cân bằng một phần bởi các bộ phận hỗ trợ. Nhờ đó, cầu có thể được nâng lên và hạ xuống một cách dễ dàng, an toàn và từ từ, giúp tàu thuyền đi qua mà không cần dùng quá nhiều lực.
C.✘
Nhiệt độ không khí tăng cao
D.✘
Áp lực của nước sông

", + "Status": "Published", + "SectionId": 11 + }, + { + "ContentType": "Text", + "ContentBody": "

Tổng quan bài học

Giải thích cách cầu nâng (drawbridge) đã tận dụng lợi thế cơ học của đòn bẩy trong suốt lịch sử và trong thế giới hiện đại để phục vụ xây dựng và giao thông, cũng như vai trò của con người trong việc vận hành cầu nâng.

Từ thời cổ đại đến hiện đại, cầu nâng đã tận dụng lợi thế cơ học của đòn bẩy để nâng và hạ những nhịp cầu nặng với lực tác động nhỏ hơn nhiều. Trong các lâu đài thời trung cổ, cầu nâng thường được thiết kế như một đòn bẩy loại 1, trong đó trục quay đóng vai trò là điểm tựa, phần cầu là tải trọng, và lực kéo được tạo ra bằng dây xích, đối trọng hoặc tay quay. Thiết kế này cho phép con người nâng cầu một cách hiệu quả để bảo vệ thành trì hoặc cho thuyền bè đi qua.

Mặc dù cây cầu rất nặng, làm thế nào mà cầu nâng vẫn có thể từ từ nâng lên khi có tàu thuyền đi qua, và những bộ phận nào giúp cây cầu chuyển động an toàn như vậy?

Cầu nâng giúp tàu thuyền di chuyển an toàn qua các kênh sông bằng cách tạm thời dừng lưu thông của xe hơi. Với micro:bit V2, micro thu âm sẽ lắng nghe các tiếng động — chẳng hạn như tiếng vỗ tay. Khi phát hiện âm thanh thành công, động cơ servo sẽ kéo cơ cấu liên kết để nâng cầu lên, tạo lối đi cho tàu thuyền.
Bo mạch Robotics cũng đóng vai trò như một vật nặng giúp giữ ổn định, để khi cầu hạ xuống, mọi thứ hoạt động trơn tru và an toàn.

Cầu nâng có thể nâng lên khi tàu thuyền đi qua là nhờ vào nguyên lý nào sau đây?
🧑‍🏫 Câu trả lời
Học sinh sẽ không thấy câu trả lời này
A.✘
Sức gió thổi mạnh
B.✔
Nguyên lý đòn bẩy và đối trọng
💡 Cầu nâng rất nặng, nhưng nhờ nguyên lý đòn bẩy và đối trọng, trọng lượng của cầu được cân bằng một phần bởi các bộ phận hỗ trợ. Nhờ đó, cầu có thể được nâng lên và hạ xuống một cách dễ dàng, an toàn và từ từ, giúp tàu thuyền đi qua mà không cần dùng quá nhiều lực.
C.✘
Nhiệt độ không khí tăng cao
D.✘
Áp lực của nước sông

", + "Status": "Published", + "SectionId": 12 + }, + { + "ContentType": "Text", + "ContentBody": "

Tổng quan bài học

Giải thích cách cầu nâng (drawbridge) đã tận dụng lợi thế cơ học của đòn bẩy trong suốt lịch sử và trong thế giới hiện đại để phục vụ xây dựng và giao thông, cũng như vai trò của con người trong việc vận hành cầu nâng.

Từ thời cổ đại đến hiện đại, cầu nâng đã tận dụng lợi thế cơ học của đòn bẩy để nâng và hạ những nhịp cầu nặng với lực tác động nhỏ hơn nhiều. Trong các lâu đài thời trung cổ, cầu nâng thường được thiết kế như một đòn bẩy loại 1, trong đó trục quay đóng vai trò là điểm tựa, phần cầu là tải trọng, và lực kéo được tạo ra bằng dây xích, đối trọng hoặc tay quay. Thiết kế này cho phép con người nâng cầu một cách hiệu quả để bảo vệ thành trì hoặc cho thuyền bè đi qua.

Mặc dù cây cầu rất nặng, làm thế nào mà cầu nâng vẫn có thể từ từ nâng lên khi có tàu thuyền đi qua, và những bộ phận nào giúp cây cầu chuyển động an toàn như vậy?

Cầu nâng giúp tàu thuyền di chuyển an toàn qua các kênh sông bằng cách tạm thời dừng lưu thông của xe hơi. Với micro:bit V2, micro thu âm sẽ lắng nghe các tiếng động — chẳng hạn như tiếng vỗ tay. Khi phát hiện âm thanh thành công, động cơ servo sẽ kéo cơ cấu liên kết để nâng cầu lên, tạo lối đi cho tàu thuyền.
Bo mạch Robotics cũng đóng vai trò như một vật nặng giúp giữ ổn định, để khi cầu hạ xuống, mọi thứ hoạt động trơn tru và an toàn.

Cầu nâng có thể nâng lên khi tàu thuyền đi qua là nhờ vào nguyên lý nào sau đây?
🧑‍🏫 Câu trả lời
Học sinh sẽ không thấy câu trả lời này
A.✘
Sức gió thổi mạnh
B.✔
Nguyên lý đòn bẩy và đối trọng
💡 Cầu nâng rất nặng, nhưng nhờ nguyên lý đòn bẩy và đối trọng, trọng lượng của cầu được cân bằng một phần bởi các bộ phận hỗ trợ. Nhờ đó, cầu có thể được nâng lên và hạ xuống một cách dễ dàng, an toàn và từ từ, giúp tàu thuyền đi qua mà không cần dùng quá nhiều lực.
C.✘
Nhiệt độ không khí tăng cao
D.✘
Áp lực của nước sông

", + "Status": "Published", + "SectionId": 14 + }, + { + "ContentType": "Text", + "ContentBody": "

Tổng quan bài học

Giải thích cách cầu nâng (drawbridge) đã tận dụng lợi thế cơ học của đòn bẩy trong suốt lịch sử và trong thế giới hiện đại để phục vụ xây dựng và giao thông, cũng như vai trò của con người trong việc vận hành cầu nâng.

Từ thời cổ đại đến hiện đại, cầu nâng đã tận dụng lợi thế cơ học của đòn bẩy để nâng và hạ những nhịp cầu nặng với lực tác động nhỏ hơn nhiều. Trong các lâu đài thời trung cổ, cầu nâng thường được thiết kế như một đòn bẩy loại 1, trong đó trục quay đóng vai trò là điểm tựa, phần cầu là tải trọng, và lực kéo được tạo ra bằng dây xích, đối trọng hoặc tay quay. Thiết kế này cho phép con người nâng cầu một cách hiệu quả để bảo vệ thành trì hoặc cho thuyền bè đi qua.

Mặc dù cây cầu rất nặng, làm thế nào mà cầu nâng vẫn có thể từ từ nâng lên khi có tàu thuyền đi qua, và những bộ phận nào giúp cây cầu chuyển động an toàn như vậy?

Cầu nâng giúp tàu thuyền di chuyển an toàn qua các kênh sông bằng cách tạm thời dừng lưu thông của xe hơi. Với micro:bit V2, micro thu âm sẽ lắng nghe các tiếng động — chẳng hạn như tiếng vỗ tay. Khi phát hiện âm thanh thành công, động cơ servo sẽ kéo cơ cấu liên kết để nâng cầu lên, tạo lối đi cho tàu thuyền.
Bo mạch Robotics cũng đóng vai trò như một vật nặng giúp giữ ổn định, để khi cầu hạ xuống, mọi thứ hoạt động trơn tru và an toàn.

Cầu nâng có thể nâng lên khi tàu thuyền đi qua là nhờ vào nguyên lý nào sau đây?
🧑‍🏫 Câu trả lời
Học sinh sẽ không thấy câu trả lời này
A.✘
Sức gió thổi mạnh
B.✔
Nguyên lý đòn bẩy và đối trọng
💡 Cầu nâng rất nặng, nhưng nhờ nguyên lý đòn bẩy và đối trọng, trọng lượng của cầu được cân bằng một phần bởi các bộ phận hỗ trợ. Nhờ đó, cầu có thể được nâng lên và hạ xuống một cách dễ dàng, an toàn và từ từ, giúp tàu thuyền đi qua mà không cần dùng quá nhiều lực.
C.✘
Nhiệt độ không khí tăng cao
D.✘
Áp lực của nước sông

", + "Status": "Published", + "SectionId": 15 + }, + { + "ContentType": "Text", + "ContentBody": "

Tổng quan bài học

Giải thích cách cầu nâng (drawbridge) đã tận dụng lợi thế cơ học của đòn bẩy trong suốt lịch sử và trong thế giới hiện đại để phục vụ xây dựng và giao thông, cũng như vai trò của con người trong việc vận hành cầu nâng.

Từ thời cổ đại đến hiện đại, cầu nâng đã tận dụng lợi thế cơ học của đòn bẩy để nâng và hạ những nhịp cầu nặng với lực tác động nhỏ hơn nhiều. Trong các lâu đài thời trung cổ, cầu nâng thường được thiết kế như một đòn bẩy loại 1, trong đó trục quay đóng vai trò là điểm tựa, phần cầu là tải trọng, và lực kéo được tạo ra bằng dây xích, đối trọng hoặc tay quay. Thiết kế này cho phép con người nâng cầu một cách hiệu quả để bảo vệ thành trì hoặc cho thuyền bè đi qua.

Mặc dù cây cầu rất nặng, làm thế nào mà cầu nâng vẫn có thể từ từ nâng lên khi có tàu thuyền đi qua, và những bộ phận nào giúp cây cầu chuyển động an toàn như vậy?

Cầu nâng giúp tàu thuyền di chuyển an toàn qua các kênh sông bằng cách tạm thời dừng lưu thông của xe hơi. Với micro:bit V2, micro thu âm sẽ lắng nghe các tiếng động — chẳng hạn như tiếng vỗ tay. Khi phát hiện âm thanh thành công, động cơ servo sẽ kéo cơ cấu liên kết để nâng cầu lên, tạo lối đi cho tàu thuyền.
Bo mạch Robotics cũng đóng vai trò như một vật nặng giúp giữ ổn định, để khi cầu hạ xuống, mọi thứ hoạt động trơn tru và an toàn.

Cầu nâng có thể nâng lên khi tàu thuyền đi qua là nhờ vào nguyên lý nào sau đây?
🧑‍🏫 Câu trả lời
Học sinh sẽ không thấy câu trả lời này
A.✘
Sức gió thổi mạnh
B.✔
Nguyên lý đòn bẩy và đối trọng
💡 Cầu nâng rất nặng, nhưng nhờ nguyên lý đòn bẩy và đối trọng, trọng lượng của cầu được cân bằng một phần bởi các bộ phận hỗ trợ. Nhờ đó, cầu có thể được nâng lên và hạ xuống một cách dễ dàng, an toàn và từ từ, giúp tàu thuyền đi qua mà không cần dùng quá nhiều lực.
C.✘
Nhiệt độ không khí tăng cao
D.✘
Áp lực của nước sông

", + "Status": "Published", + "SectionId": 17 + }, + { + "ContentType": "Text", + "ContentBody": "

Tổng quan bài học

Giải thích cách cầu nâng (drawbridge) đã tận dụng lợi thế cơ học của đòn bẩy trong suốt lịch sử và trong thế giới hiện đại để phục vụ xây dựng và giao thông, cũng như vai trò của con người trong việc vận hành cầu nâng.

Từ thời cổ đại đến hiện đại, cầu nâng đã tận dụng lợi thế cơ học của đòn bẩy để nâng và hạ những nhịp cầu nặng với lực tác động nhỏ hơn nhiều. Trong các lâu đài thời trung cổ, cầu nâng thường được thiết kế như một đòn bẩy loại 1, trong đó trục quay đóng vai trò là điểm tựa, phần cầu là tải trọng, và lực kéo được tạo ra bằng dây xích, đối trọng hoặc tay quay. Thiết kế này cho phép con người nâng cầu một cách hiệu quả để bảo vệ thành trì hoặc cho thuyền bè đi qua.

Mặc dù cây cầu rất nặng, làm thế nào mà cầu nâng vẫn có thể từ từ nâng lên khi có tàu thuyền đi qua, và những bộ phận nào giúp cây cầu chuyển động an toàn như vậy?

Cầu nâng giúp tàu thuyền di chuyển an toàn qua các kênh sông bằng cách tạm thời dừng lưu thông của xe hơi. Với micro:bit V2, micro thu âm sẽ lắng nghe các tiếng động — chẳng hạn như tiếng vỗ tay. Khi phát hiện âm thanh thành công, động cơ servo sẽ kéo cơ cấu liên kết để nâng cầu lên, tạo lối đi cho tàu thuyền.
Bo mạch Robotics cũng đóng vai trò như một vật nặng giúp giữ ổn định, để khi cầu hạ xuống, mọi thứ hoạt động trơn tru và an toàn.

Cầu nâng có thể nâng lên khi tàu thuyền đi qua là nhờ vào nguyên lý nào sau đây?
🧑‍🏫 Câu trả lời
Học sinh sẽ không thấy câu trả lời này
A.✘
Sức gió thổi mạnh
B.✔
Nguyên lý đòn bẩy và đối trọng
💡 Cầu nâng rất nặng, nhưng nhờ nguyên lý đòn bẩy và đối trọng, trọng lượng của cầu được cân bằng một phần bởi các bộ phận hỗ trợ. Nhờ đó, cầu có thể được nâng lên và hạ xuống một cách dễ dàng, an toàn và từ từ, giúp tàu thuyền đi qua mà không cần dùng quá nhiều lực.
C.✘
Nhiệt độ không khí tăng cao
D.✘
Áp lực của nước sông

", + "Status": "Published", + "SectionId": 18 + }, + { + "ContentType": "Text", + "ContentBody": "

Tổng quan bài học

Giải thích cách cầu nâng (drawbridge) đã tận dụng lợi thế cơ học của đòn bẩy trong suốt lịch sử và trong thế giới hiện đại để phục vụ xây dựng và giao thông, cũng như vai trò của con người trong việc vận hành cầu nâng.

Từ thời cổ đại đến hiện đại, cầu nâng đã tận dụng lợi thế cơ học của đòn bẩy để nâng và hạ những nhịp cầu nặng với lực tác động nhỏ hơn nhiều. Trong các lâu đài thời trung cổ, cầu nâng thường được thiết kế như một đòn bẩy loại 1, trong đó trục quay đóng vai trò là điểm tựa, phần cầu là tải trọng, và lực kéo được tạo ra bằng dây xích, đối trọng hoặc tay quay. Thiết kế này cho phép con người nâng cầu một cách hiệu quả để bảo vệ thành trì hoặc cho thuyền bè đi qua.

Mặc dù cây cầu rất nặng, làm thế nào mà cầu nâng vẫn có thể từ từ nâng lên khi có tàu thuyền đi qua, và những bộ phận nào giúp cây cầu chuyển động an toàn như vậy?

Cầu nâng giúp tàu thuyền di chuyển an toàn qua các kênh sông bằng cách tạm thời dừng lưu thông của xe hơi. Với micro:bit V2, micro thu âm sẽ lắng nghe các tiếng động — chẳng hạn như tiếng vỗ tay. Khi phát hiện âm thanh thành công, động cơ servo sẽ kéo cơ cấu liên kết để nâng cầu lên, tạo lối đi cho tàu thuyền.
Bo mạch Robotics cũng đóng vai trò như một vật nặng giúp giữ ổn định, để khi cầu hạ xuống, mọi thứ hoạt động trơn tru và an toàn.

Cầu nâng có thể nâng lên khi tàu thuyền đi qua là nhờ vào nguyên lý nào sau đây?
🧑‍🏫 Câu trả lời
Học sinh sẽ không thấy câu trả lời này
A.✘
Sức gió thổi mạnh
B.✔
Nguyên lý đòn bẩy và đối trọng
💡 Cầu nâng rất nặng, nhưng nhờ nguyên lý đòn bẩy và đối trọng, trọng lượng của cầu được cân bằng một phần bởi các bộ phận hỗ trợ. Nhờ đó, cầu có thể được nâng lên và hạ xuống một cách dễ dàng, an toàn và từ từ, giúp tàu thuyền đi qua mà không cần dùng quá nhiều lực.
C.✘
Nhiệt độ không khí tăng cao
D.✘
Áp lực của nước sông

", + "Status": "Published", + "SectionId": 19 + }, + { + "ContentType": "Text", + "ContentBody": "

Tổng quan bài học

Giải thích cách cầu nâng (drawbridge) đã tận dụng lợi thế cơ học của đòn bẩy trong suốt lịch sử và trong thế giới hiện đại để phục vụ xây dựng và giao thông, cũng như vai trò của con người trong việc vận hành cầu nâng.

Từ thời cổ đại đến hiện đại, cầu nâng đã tận dụng lợi thế cơ học của đòn bẩy để nâng và hạ những nhịp cầu nặng với lực tác động nhỏ hơn nhiều. Trong các lâu đài thời trung cổ, cầu nâng thường được thiết kế như một đòn bẩy loại 1, trong đó trục quay đóng vai trò là điểm tựa, phần cầu là tải trọng, và lực kéo được tạo ra bằng dây xích, đối trọng hoặc tay quay. Thiết kế này cho phép con người nâng cầu một cách hiệu quả để bảo vệ thành trì hoặc cho thuyền bè đi qua.

Mặc dù cây cầu rất nặng, làm thế nào mà cầu nâng vẫn có thể từ từ nâng lên khi có tàu thuyền đi qua, và những bộ phận nào giúp cây cầu chuyển động an toàn như vậy?

Cầu nâng giúp tàu thuyền di chuyển an toàn qua các kênh sông bằng cách tạm thời dừng lưu thông của xe hơi. Với micro:bit V2, micro thu âm sẽ lắng nghe các tiếng động — chẳng hạn như tiếng vỗ tay. Khi phát hiện âm thanh thành công, động cơ servo sẽ kéo cơ cấu liên kết để nâng cầu lên, tạo lối đi cho tàu thuyền.
Bo mạch Robotics cũng đóng vai trò như một vật nặng giúp giữ ổn định, để khi cầu hạ xuống, mọi thứ hoạt động trơn tru và an toàn.

Cầu nâng có thể nâng lên khi tàu thuyền đi qua là nhờ vào nguyên lý nào sau đây?
🧑‍🏫 Câu trả lời
Học sinh sẽ không thấy câu trả lời này
A.✘
Sức gió thổi mạnh
B.✔
Nguyên lý đòn bẩy và đối trọng
💡 Cầu nâng rất nặng, nhưng nhờ nguyên lý đòn bẩy và đối trọng, trọng lượng của cầu được cân bằng một phần bởi các bộ phận hỗ trợ. Nhờ đó, cầu có thể được nâng lên và hạ xuống một cách dễ dàng, an toàn và từ từ, giúp tàu thuyền đi qua mà không cần dùng quá nhiều lực.
C.✘
Nhiệt độ không khí tăng cao
D.✘
Áp lực của nước sông

", + "Status": "Published", + "SectionId": 21 + }, + { + "ContentType": "Text", + "ContentBody": "

Tổng quan bài học

Giải thích cách cầu nâng (drawbridge) đã tận dụng lợi thế cơ học của đòn bẩy trong suốt lịch sử và trong thế giới hiện đại để phục vụ xây dựng và giao thông, cũng như vai trò của con người trong việc vận hành cầu nâng.

Từ thời cổ đại đến hiện đại, cầu nâng đã tận dụng lợi thế cơ học của đòn bẩy để nâng và hạ những nhịp cầu nặng với lực tác động nhỏ hơn nhiều. Trong các lâu đài thời trung cổ, cầu nâng thường được thiết kế như một đòn bẩy loại 1, trong đó trục quay đóng vai trò là điểm tựa, phần cầu là tải trọng, và lực kéo được tạo ra bằng dây xích, đối trọng hoặc tay quay. Thiết kế này cho phép con người nâng cầu một cách hiệu quả để bảo vệ thành trì hoặc cho thuyền bè đi qua.

Mặc dù cây cầu rất nặng, làm thế nào mà cầu nâng vẫn có thể từ từ nâng lên khi có tàu thuyền đi qua, và những bộ phận nào giúp cây cầu chuyển động an toàn như vậy?

Cầu nâng giúp tàu thuyền di chuyển an toàn qua các kênh sông bằng cách tạm thời dừng lưu thông của xe hơi. Với micro:bit V2, micro thu âm sẽ lắng nghe các tiếng động — chẳng hạn như tiếng vỗ tay. Khi phát hiện âm thanh thành công, động cơ servo sẽ kéo cơ cấu liên kết để nâng cầu lên, tạo lối đi cho tàu thuyền.
Bo mạch Robotics cũng đóng vai trò như một vật nặng giúp giữ ổn định, để khi cầu hạ xuống, mọi thứ hoạt động trơn tru và an toàn.

Cầu nâng có thể nâng lên khi tàu thuyền đi qua là nhờ vào nguyên lý nào sau đây?
🧑‍🏫 Câu trả lời
Học sinh sẽ không thấy câu trả lời này
A.✘
Sức gió thổi mạnh
B.✔
Nguyên lý đòn bẩy và đối trọng
💡 Cầu nâng rất nặng, nhưng nhờ nguyên lý đòn bẩy và đối trọng, trọng lượng của cầu được cân bằng một phần bởi các bộ phận hỗ trợ. Nhờ đó, cầu có thể được nâng lên và hạ xuống một cách dễ dàng, an toàn và từ từ, giúp tàu thuyền đi qua mà không cần dùng quá nhiều lực.
C.✘
Nhiệt độ không khí tăng cao
D.✘
Áp lực của nước sông

", + "Status": "Published", + "SectionId": 22 + }, + { + "ContentType": "Text", + "ContentBody": "

Tổng quan bài học

Giải thích cách cầu nâng (drawbridge) đã tận dụng lợi thế cơ học của đòn bẩy trong suốt lịch sử và trong thế giới hiện đại để phục vụ xây dựng và giao thông, cũng như vai trò của con người trong việc vận hành cầu nâng.

Từ thời cổ đại đến hiện đại, cầu nâng đã tận dụng lợi thế cơ học của đòn bẩy để nâng và hạ những nhịp cầu nặng với lực tác động nhỏ hơn nhiều. Trong các lâu đài thời trung cổ, cầu nâng thường được thiết kế như một đòn bẩy loại 1, trong đó trục quay đóng vai trò là điểm tựa, phần cầu là tải trọng, và lực kéo được tạo ra bằng dây xích, đối trọng hoặc tay quay. Thiết kế này cho phép con người nâng cầu một cách hiệu quả để bảo vệ thành trì hoặc cho thuyền bè đi qua.

Mặc dù cây cầu rất nặng, làm thế nào mà cầu nâng vẫn có thể từ từ nâng lên khi có tàu thuyền đi qua, và những bộ phận nào giúp cây cầu chuyển động an toàn như vậy?

Cầu nâng giúp tàu thuyền di chuyển an toàn qua các kênh sông bằng cách tạm thời dừng lưu thông của xe hơi. Với micro:bit V2, micro thu âm sẽ lắng nghe các tiếng động — chẳng hạn như tiếng vỗ tay. Khi phát hiện âm thanh thành công, động cơ servo sẽ kéo cơ cấu liên kết để nâng cầu lên, tạo lối đi cho tàu thuyền.
Bo mạch Robotics cũng đóng vai trò như một vật nặng giúp giữ ổn định, để khi cầu hạ xuống, mọi thứ hoạt động trơn tru và an toàn.

Cầu nâng có thể nâng lên khi tàu thuyền đi qua là nhờ vào nguyên lý nào sau đây?
🧑‍🏫 Câu trả lời
Học sinh sẽ không thấy câu trả lời này
A.✘
Sức gió thổi mạnh
B.✔
Nguyên lý đòn bẩy và đối trọng
💡 Cầu nâng rất nặng, nhưng nhờ nguyên lý đòn bẩy và đối trọng, trọng lượng của cầu được cân bằng một phần bởi các bộ phận hỗ trợ. Nhờ đó, cầu có thể được nâng lên và hạ xuống một cách dễ dàng, an toàn và từ từ, giúp tàu thuyền đi qua mà không cần dùng quá nhiều lực.
C.✘
Nhiệt độ không khí tăng cao
D.✘
Áp lực của nước sông

", + "Status": "Published", + "SectionId": 23 + }, + { + "ContentType": "Text", + "ContentBody": "

Tổng quan bài học

Giải thích cách cầu nâng (drawbridge) đã tận dụng lợi thế cơ học của đòn bẩy trong suốt lịch sử và trong thế giới hiện đại để phục vụ xây dựng và giao thông, cũng như vai trò của con người trong việc vận hành cầu nâng.

Từ thời cổ đại đến hiện đại, cầu nâng đã tận dụng lợi thế cơ học của đòn bẩy để nâng và hạ những nhịp cầu nặng với lực tác động nhỏ hơn nhiều. Trong các lâu đài thời trung cổ, cầu nâng thường được thiết kế như một đòn bẩy loại 1, trong đó trục quay đóng vai trò là điểm tựa, phần cầu là tải trọng, và lực kéo được tạo ra bằng dây xích, đối trọng hoặc tay quay. Thiết kế này cho phép con người nâng cầu một cách hiệu quả để bảo vệ thành trì hoặc cho thuyền bè đi qua.

Mặc dù cây cầu rất nặng, làm thế nào mà cầu nâng vẫn có thể từ từ nâng lên khi có tàu thuyền đi qua, và những bộ phận nào giúp cây cầu chuyển động an toàn như vậy?

Cầu nâng giúp tàu thuyền di chuyển an toàn qua các kênh sông bằng cách tạm thời dừng lưu thông của xe hơi. Với micro:bit V2, micro thu âm sẽ lắng nghe các tiếng động — chẳng hạn như tiếng vỗ tay. Khi phát hiện âm thanh thành công, động cơ servo sẽ kéo cơ cấu liên kết để nâng cầu lên, tạo lối đi cho tàu thuyền.
Bo mạch Robotics cũng đóng vai trò như một vật nặng giúp giữ ổn định, để khi cầu hạ xuống, mọi thứ hoạt động trơn tru và an toàn.

Cầu nâng có thể nâng lên khi tàu thuyền đi qua là nhờ vào nguyên lý nào sau đây?
🧑‍🏫 Câu trả lời
Học sinh sẽ không thấy câu trả lời này
A.✘
Sức gió thổi mạnh
B.✔
Nguyên lý đòn bẩy và đối trọng
💡 Cầu nâng rất nặng, nhưng nhờ nguyên lý đòn bẩy và đối trọng, trọng lượng của cầu được cân bằng một phần bởi các bộ phận hỗ trợ. Nhờ đó, cầu có thể được nâng lên và hạ xuống một cách dễ dàng, an toàn và từ từ, giúp tàu thuyền đi qua mà không cần dùng quá nhiều lực.
C.✘
Nhiệt độ không khí tăng cao
D.✘
Áp lực của nước sông

", + "Status": "Published", + "SectionId": 24 + }, + { + "ContentType": "Text", + "ContentBody": "

Tổng quan bài học

Giải thích cách cầu nâng (drawbridge) đã tận dụng lợi thế cơ học của đòn bẩy trong suốt lịch sử và trong thế giới hiện đại để phục vụ xây dựng và giao thông, cũng như vai trò của con người trong việc vận hành cầu nâng.

Từ thời cổ đại đến hiện đại, cầu nâng đã tận dụng lợi thế cơ học của đòn bẩy để nâng và hạ những nhịp cầu nặng với lực tác động nhỏ hơn nhiều. Trong các lâu đài thời trung cổ, cầu nâng thường được thiết kế như một đòn bẩy loại 1, trong đó trục quay đóng vai trò là điểm tựa, phần cầu là tải trọng, và lực kéo được tạo ra bằng dây xích, đối trọng hoặc tay quay. Thiết kế này cho phép con người nâng cầu một cách hiệu quả để bảo vệ thành trì hoặc cho thuyền bè đi qua.

Mặc dù cây cầu rất nặng, làm thế nào mà cầu nâng vẫn có thể từ từ nâng lên khi có tàu thuyền đi qua, và những bộ phận nào giúp cây cầu chuyển động an toàn như vậy?

Cầu nâng giúp tàu thuyền di chuyển an toàn qua các kênh sông bằng cách tạm thời dừng lưu thông của xe hơi. Với micro:bit V2, micro thu âm sẽ lắng nghe các tiếng động — chẳng hạn như tiếng vỗ tay. Khi phát hiện âm thanh thành công, động cơ servo sẽ kéo cơ cấu liên kết để nâng cầu lên, tạo lối đi cho tàu thuyền.
Bo mạch Robotics cũng đóng vai trò như một vật nặng giúp giữ ổn định, để khi cầu hạ xuống, mọi thứ hoạt động trơn tru và an toàn.

Cầu nâng có thể nâng lên khi tàu thuyền đi qua là nhờ vào nguyên lý nào sau đây?
🧑‍🏫 Câu trả lời
Học sinh sẽ không thấy câu trả lời này
A.✘
Sức gió thổi mạnh
B.✔
Nguyên lý đòn bẩy và đối trọng
💡 Cầu nâng rất nặng, nhưng nhờ nguyên lý đòn bẩy và đối trọng, trọng lượng của cầu được cân bằng một phần bởi các bộ phận hỗ trợ. Nhờ đó, cầu có thể được nâng lên và hạ xuống một cách dễ dàng, an toàn và từ từ, giúp tàu thuyền đi qua mà không cần dùng quá nhiều lực.
C.✘
Nhiệt độ không khí tăng cao
D.✘
Áp lực của nước sông

", + "Status": "Published", + "SectionId": 25 + }, + { + "ContentType": "Text", + "ContentBody": "

Tổng quan bài học

Giải thích cách cầu nâng (drawbridge) đã tận dụng lợi thế cơ học của đòn bẩy trong suốt lịch sử và trong thế giới hiện đại để phục vụ xây dựng và giao thông, cũng như vai trò của con người trong việc vận hành cầu nâng.

Từ thời cổ đại đến hiện đại, cầu nâng đã tận dụng lợi thế cơ học của đòn bẩy để nâng và hạ những nhịp cầu nặng với lực tác động nhỏ hơn nhiều. Trong các lâu đài thời trung cổ, cầu nâng thường được thiết kế như một đòn bẩy loại 1, trong đó trục quay đóng vai trò là điểm tựa, phần cầu là tải trọng, và lực kéo được tạo ra bằng dây xích, đối trọng hoặc tay quay. Thiết kế này cho phép con người nâng cầu một cách hiệu quả để bảo vệ thành trì hoặc cho thuyền bè đi qua.

Mặc dù cây cầu rất nặng, làm thế nào mà cầu nâng vẫn có thể từ từ nâng lên khi có tàu thuyền đi qua, và những bộ phận nào giúp cây cầu chuyển động an toàn như vậy?

Cầu nâng giúp tàu thuyền di chuyển an toàn qua các kênh sông bằng cách tạm thời dừng lưu thông của xe hơi. Với micro:bit V2, micro thu âm sẽ lắng nghe các tiếng động — chẳng hạn như tiếng vỗ tay. Khi phát hiện âm thanh thành công, động cơ servo sẽ kéo cơ cấu liên kết để nâng cầu lên, tạo lối đi cho tàu thuyền.
Bo mạch Robotics cũng đóng vai trò như một vật nặng giúp giữ ổn định, để khi cầu hạ xuống, mọi thứ hoạt động trơn tru và an toàn.

Cầu nâng có thể nâng lên khi tàu thuyền đi qua là nhờ vào nguyên lý nào sau đây?
🧑‍🏫 Câu trả lời
Học sinh sẽ không thấy câu trả lời này
A.✘
Sức gió thổi mạnh
B.✔
Nguyên lý đòn bẩy và đối trọng
💡 Cầu nâng rất nặng, nhưng nhờ nguyên lý đòn bẩy và đối trọng, trọng lượng của cầu được cân bằng một phần bởi các bộ phận hỗ trợ. Nhờ đó, cầu có thể được nâng lên và hạ xuống một cách dễ dàng, an toàn và từ từ, giúp tàu thuyền đi qua mà không cần dùng quá nhiều lực.
C.✘
Nhiệt độ không khí tăng cao
D.✘
Áp lực của nước sông

", + "Status": "Published", + "SectionId": 26 + }, + { + "ContentType": "Text", + "ContentBody": "

Tổng quan bài học

Giải thích cách cầu nâng (drawbridge) đã tận dụng lợi thế cơ học của đòn bẩy trong suốt lịch sử và trong thế giới hiện đại để phục vụ xây dựng và giao thông, cũng như vai trò của con người trong việc vận hành cầu nâng.

Từ thời cổ đại đến hiện đại, cầu nâng đã tận dụng lợi thế cơ học của đòn bẩy để nâng và hạ những nhịp cầu nặng với lực tác động nhỏ hơn nhiều. Trong các lâu đài thời trung cổ, cầu nâng thường được thiết kế như một đòn bẩy loại 1, trong đó trục quay đóng vai trò là điểm tựa, phần cầu là tải trọng, và lực kéo được tạo ra bằng dây xích, đối trọng hoặc tay quay. Thiết kế này cho phép con người nâng cầu một cách hiệu quả để bảo vệ thành trì hoặc cho thuyền bè đi qua.

Mặc dù cây cầu rất nặng, làm thế nào mà cầu nâng vẫn có thể từ từ nâng lên khi có tàu thuyền đi qua, và những bộ phận nào giúp cây cầu chuyển động an toàn như vậy?

Cầu nâng giúp tàu thuyền di chuyển an toàn qua các kênh sông bằng cách tạm thời dừng lưu thông của xe hơi. Với micro:bit V2, micro thu âm sẽ lắng nghe các tiếng động — chẳng hạn như tiếng vỗ tay. Khi phát hiện âm thanh thành công, động cơ servo sẽ kéo cơ cấu liên kết để nâng cầu lên, tạo lối đi cho tàu thuyền.
Bo mạch Robotics cũng đóng vai trò như một vật nặng giúp giữ ổn định, để khi cầu hạ xuống, mọi thứ hoạt động trơn tru và an toàn.

Cầu nâng có thể nâng lên khi tàu thuyền đi qua là nhờ vào nguyên lý nào sau đây?
🧑‍🏫 Câu trả lời
Học sinh sẽ không thấy câu trả lời này
A.✘
Sức gió thổi mạnh
B.✔
Nguyên lý đòn bẩy và đối trọng
💡 Cầu nâng rất nặng, nhưng nhờ nguyên lý đòn bẩy và đối trọng, trọng lượng của cầu được cân bằng một phần bởi các bộ phận hỗ trợ. Nhờ đó, cầu có thể được nâng lên và hạ xuống một cách dễ dàng, an toàn và từ từ, giúp tàu thuyền đi qua mà không cần dùng quá nhiều lực.
C.✘
Nhiệt độ không khí tăng cao
D.✘
Áp lực của nước sông

", + "Status": "Published", + "SectionId": 27 + }, + { + "ContentType": "Text", + "ContentBody": "

Tổng quan bài học

Giải thích cách cầu nâng (drawbridge) đã tận dụng lợi thế cơ học của đòn bẩy trong suốt lịch sử và trong thế giới hiện đại để phục vụ xây dựng và giao thông, cũng như vai trò của con người trong việc vận hành cầu nâng.

Từ thời cổ đại đến hiện đại, cầu nâng đã tận dụng lợi thế cơ học của đòn bẩy để nâng và hạ những nhịp cầu nặng với lực tác động nhỏ hơn nhiều. Trong các lâu đài thời trung cổ, cầu nâng thường được thiết kế như một đòn bẩy loại 1, trong đó trục quay đóng vai trò là điểm tựa, phần cầu là tải trọng, và lực kéo được tạo ra bằng dây xích, đối trọng hoặc tay quay. Thiết kế này cho phép con người nâng cầu một cách hiệu quả để bảo vệ thành trì hoặc cho thuyền bè đi qua.

Mặc dù cây cầu rất nặng, làm thế nào mà cầu nâng vẫn có thể từ từ nâng lên khi có tàu thuyền đi qua, và những bộ phận nào giúp cây cầu chuyển động an toàn như vậy?

Cầu nâng giúp tàu thuyền di chuyển an toàn qua các kênh sông bằng cách tạm thời dừng lưu thông của xe hơi. Với micro:bit V2, micro thu âm sẽ lắng nghe các tiếng động — chẳng hạn như tiếng vỗ tay. Khi phát hiện âm thanh thành công, động cơ servo sẽ kéo cơ cấu liên kết để nâng cầu lên, tạo lối đi cho tàu thuyền.
Bo mạch Robotics cũng đóng vai trò như một vật nặng giúp giữ ổn định, để khi cầu hạ xuống, mọi thứ hoạt động trơn tru và an toàn.

Cầu nâng có thể nâng lên khi tàu thuyền đi qua là nhờ vào nguyên lý nào sau đây?
🧑‍🏫 Câu trả lời
Học sinh sẽ không thấy câu trả lời này
A.✘
Sức gió thổi mạnh
B.✔
Nguyên lý đòn bẩy và đối trọng
💡 Cầu nâng rất nặng, nhưng nhờ nguyên lý đòn bẩy và đối trọng, trọng lượng của cầu được cân bằng một phần bởi các bộ phận hỗ trợ. Nhờ đó, cầu có thể được nâng lên và hạ xuống một cách dễ dàng, an toàn và từ từ, giúp tàu thuyền đi qua mà không cần dùng quá nhiều lực.
C.✘
Nhiệt độ không khí tăng cao
D.✘
Áp lực của nước sông

", + "Status": "Published", + "SectionId": 28 + }, + { + "ContentType": "Text", + "ContentBody": "

Tổng quan bài học

Giải thích cách cầu nâng (drawbridge) đã tận dụng lợi thế cơ học của đòn bẩy trong suốt lịch sử và trong thế giới hiện đại để phục vụ xây dựng và giao thông, cũng như vai trò của con người trong việc vận hành cầu nâng.

Từ thời cổ đại đến hiện đại, cầu nâng đã tận dụng lợi thế cơ học của đòn bẩy để nâng và hạ những nhịp cầu nặng với lực tác động nhỏ hơn nhiều. Trong các lâu đài thời trung cổ, cầu nâng thường được thiết kế như một đòn bẩy loại 1, trong đó trục quay đóng vai trò là điểm tựa, phần cầu là tải trọng, và lực kéo được tạo ra bằng dây xích, đối trọng hoặc tay quay. Thiết kế này cho phép con người nâng cầu một cách hiệu quả để bảo vệ thành trì hoặc cho thuyền bè đi qua.

Mặc dù cây cầu rất nặng, làm thế nào mà cầu nâng vẫn có thể từ từ nâng lên khi có tàu thuyền đi qua, và những bộ phận nào giúp cây cầu chuyển động an toàn như vậy?

Cầu nâng giúp tàu thuyền di chuyển an toàn qua các kênh sông bằng cách tạm thời dừng lưu thông của xe hơi. Với micro:bit V2, micro thu âm sẽ lắng nghe các tiếng động — chẳng hạn như tiếng vỗ tay. Khi phát hiện âm thanh thành công, động cơ servo sẽ kéo cơ cấu liên kết để nâng cầu lên, tạo lối đi cho tàu thuyền.
Bo mạch Robotics cũng đóng vai trò như một vật nặng giúp giữ ổn định, để khi cầu hạ xuống, mọi thứ hoạt động trơn tru và an toàn.

Cầu nâng có thể nâng lên khi tàu thuyền đi qua là nhờ vào nguyên lý nào sau đây?
🧑‍🏫 Câu trả lời
Học sinh sẽ không thấy câu trả lời này
A.✘
Sức gió thổi mạnh
B.✔
Nguyên lý đòn bẩy và đối trọng
💡 Cầu nâng rất nặng, nhưng nhờ nguyên lý đòn bẩy và đối trọng, trọng lượng của cầu được cân bằng một phần bởi các bộ phận hỗ trợ. Nhờ đó, cầu có thể được nâng lên và hạ xuống một cách dễ dàng, an toàn và từ từ, giúp tàu thuyền đi qua mà không cần dùng quá nhiều lực.
C.✘
Nhiệt độ không khí tăng cao
D.✘
Áp lực của nước sông

", + "Status": "Published", + "SectionId": 30 + }, + { + "ContentType": "Text", + "ContentBody": "

Tổng quan bài học

Giải thích cách cầu nâng (drawbridge) đã tận dụng lợi thế cơ học của đòn bẩy trong suốt lịch sử và trong thế giới hiện đại để phục vụ xây dựng và giao thông, cũng như vai trò của con người trong việc vận hành cầu nâng.

Từ thời cổ đại đến hiện đại, cầu nâng đã tận dụng lợi thế cơ học của đòn bẩy để nâng và hạ những nhịp cầu nặng với lực tác động nhỏ hơn nhiều. Trong các lâu đài thời trung cổ, cầu nâng thường được thiết kế như một đòn bẩy loại 1, trong đó trục quay đóng vai trò là điểm tựa, phần cầu là tải trọng, và lực kéo được tạo ra bằng dây xích, đối trọng hoặc tay quay. Thiết kế này cho phép con người nâng cầu một cách hiệu quả để bảo vệ thành trì hoặc cho thuyền bè đi qua.

Mặc dù cây cầu rất nặng, làm thế nào mà cầu nâng vẫn có thể từ từ nâng lên khi có tàu thuyền đi qua, và những bộ phận nào giúp cây cầu chuyển động an toàn như vậy?

Cầu nâng giúp tàu thuyền di chuyển an toàn qua các kênh sông bằng cách tạm thời dừng lưu thông của xe hơi. Với micro:bit V2, micro thu âm sẽ lắng nghe các tiếng động — chẳng hạn như tiếng vỗ tay. Khi phát hiện âm thanh thành công, động cơ servo sẽ kéo cơ cấu liên kết để nâng cầu lên, tạo lối đi cho tàu thuyền.
Bo mạch Robotics cũng đóng vai trò như một vật nặng giúp giữ ổn định, để khi cầu hạ xuống, mọi thứ hoạt động trơn tru và an toàn.

Cầu nâng có thể nâng lên khi tàu thuyền đi qua là nhờ vào nguyên lý nào sau đây?
🧑‍🏫 Câu trả lời
Học sinh sẽ không thấy câu trả lời này
A.✘
Sức gió thổi mạnh
B.✔
Nguyên lý đòn bẩy và đối trọng
💡 Cầu nâng rất nặng, nhưng nhờ nguyên lý đòn bẩy và đối trọng, trọng lượng của cầu được cân bằng một phần bởi các bộ phận hỗ trợ. Nhờ đó, cầu có thể được nâng lên và hạ xuống một cách dễ dàng, an toàn và từ từ, giúp tàu thuyền đi qua mà không cần dùng quá nhiều lực.
C.✘
Nhiệt độ không khí tăng cao
D.✘
Áp lực của nước sông

", + "Status": "Published", + "SectionId": 31 + }, + { + "ContentType": "Text", + "ContentBody": "

Tổng quan bài học

Giải thích cách cầu nâng (drawbridge) đã tận dụng lợi thế cơ học của đòn bẩy trong suốt lịch sử và trong thế giới hiện đại để phục vụ xây dựng và giao thông, cũng như vai trò của con người trong việc vận hành cầu nâng.

Từ thời cổ đại đến hiện đại, cầu nâng đã tận dụng lợi thế cơ học của đòn bẩy để nâng và hạ những nhịp cầu nặng với lực tác động nhỏ hơn nhiều. Trong các lâu đài thời trung cổ, cầu nâng thường được thiết kế như một đòn bẩy loại 1, trong đó trục quay đóng vai trò là điểm tựa, phần cầu là tải trọng, và lực kéo được tạo ra bằng dây xích, đối trọng hoặc tay quay. Thiết kế này cho phép con người nâng cầu một cách hiệu quả để bảo vệ thành trì hoặc cho thuyền bè đi qua.

Mặc dù cây cầu rất nặng, làm thế nào mà cầu nâng vẫn có thể từ từ nâng lên khi có tàu thuyền đi qua, và những bộ phận nào giúp cây cầu chuyển động an toàn như vậy?

Cầu nâng giúp tàu thuyền di chuyển an toàn qua các kênh sông bằng cách tạm thời dừng lưu thông của xe hơi. Với micro:bit V2, micro thu âm sẽ lắng nghe các tiếng động — chẳng hạn như tiếng vỗ tay. Khi phát hiện âm thanh thành công, động cơ servo sẽ kéo cơ cấu liên kết để nâng cầu lên, tạo lối đi cho tàu thuyền.
Bo mạch Robotics cũng đóng vai trò như một vật nặng giúp giữ ổn định, để khi cầu hạ xuống, mọi thứ hoạt động trơn tru và an toàn.

Cầu nâng có thể nâng lên khi tàu thuyền đi qua là nhờ vào nguyên lý nào sau đây?
🧑‍🏫 Câu trả lời
Học sinh sẽ không thấy câu trả lời này
A.✘
Sức gió thổi mạnh
B.✔
Nguyên lý đòn bẩy và đối trọng
💡 Cầu nâng rất nặng, nhưng nhờ nguyên lý đòn bẩy và đối trọng, trọng lượng của cầu được cân bằng một phần bởi các bộ phận hỗ trợ. Nhờ đó, cầu có thể được nâng lên và hạ xuống một cách dễ dàng, an toàn và từ từ, giúp tàu thuyền đi qua mà không cần dùng quá nhiều lực.
C.✘
Nhiệt độ không khí tăng cao
D.✘
Áp lực của nước sông

", + "Status": "Published", + "SectionId": 32 + }, + { + "ContentType": "Text", + "ContentBody": "

Tổng quan bài học

Giải thích cách cầu nâng (drawbridge) đã tận dụng lợi thế cơ học của đòn bẩy trong suốt lịch sử và trong thế giới hiện đại để phục vụ xây dựng và giao thông, cũng như vai trò của con người trong việc vận hành cầu nâng.

Từ thời cổ đại đến hiện đại, cầu nâng đã tận dụng lợi thế cơ học của đòn bẩy để nâng và hạ những nhịp cầu nặng với lực tác động nhỏ hơn nhiều. Trong các lâu đài thời trung cổ, cầu nâng thường được thiết kế như một đòn bẩy loại 1, trong đó trục quay đóng vai trò là điểm tựa, phần cầu là tải trọng, và lực kéo được tạo ra bằng dây xích, đối trọng hoặc tay quay. Thiết kế này cho phép con người nâng cầu một cách hiệu quả để bảo vệ thành trì hoặc cho thuyền bè đi qua.

Mặc dù cây cầu rất nặng, làm thế nào mà cầu nâng vẫn có thể từ từ nâng lên khi có tàu thuyền đi qua, và những bộ phận nào giúp cây cầu chuyển động an toàn như vậy?

Cầu nâng giúp tàu thuyền di chuyển an toàn qua các kênh sông bằng cách tạm thời dừng lưu thông của xe hơi. Với micro:bit V2, micro thu âm sẽ lắng nghe các tiếng động — chẳng hạn như tiếng vỗ tay. Khi phát hiện âm thanh thành công, động cơ servo sẽ kéo cơ cấu liên kết để nâng cầu lên, tạo lối đi cho tàu thuyền.
Bo mạch Robotics cũng đóng vai trò như một vật nặng giúp giữ ổn định, để khi cầu hạ xuống, mọi thứ hoạt động trơn tru và an toàn.

Cầu nâng có thể nâng lên khi tàu thuyền đi qua là nhờ vào nguyên lý nào sau đây?
🧑‍🏫 Câu trả lời
Học sinh sẽ không thấy câu trả lời này
A.✘
Sức gió thổi mạnh
B.✔
Nguyên lý đòn bẩy và đối trọng
💡 Cầu nâng rất nặng, nhưng nhờ nguyên lý đòn bẩy và đối trọng, trọng lượng của cầu được cân bằng một phần bởi các bộ phận hỗ trợ. Nhờ đó, cầu có thể được nâng lên và hạ xuống một cách dễ dàng, an toàn và từ từ, giúp tàu thuyền đi qua mà không cần dùng quá nhiều lực.
C.✘
Nhiệt độ không khí tăng cao
D.✘
Áp lực của nước sông

", + "Status": "Published", + "SectionId": 34 + }, + { + "ContentType": "Text", + "ContentBody": "

Tổng quan bài học

Giải thích cách cầu nâng (drawbridge) đã tận dụng lợi thế cơ học của đòn bẩy trong suốt lịch sử và trong thế giới hiện đại để phục vụ xây dựng và giao thông, cũng như vai trò của con người trong việc vận hành cầu nâng.

Từ thời cổ đại đến hiện đại, cầu nâng đã tận dụng lợi thế cơ học của đòn bẩy để nâng và hạ những nhịp cầu nặng với lực tác động nhỏ hơn nhiều. Trong các lâu đài thời trung cổ, cầu nâng thường được thiết kế như một đòn bẩy loại 1, trong đó trục quay đóng vai trò là điểm tựa, phần cầu là tải trọng, và lực kéo được tạo ra bằng dây xích, đối trọng hoặc tay quay. Thiết kế này cho phép con người nâng cầu một cách hiệu quả để bảo vệ thành trì hoặc cho thuyền bè đi qua.

Mặc dù cây cầu rất nặng, làm thế nào mà cầu nâng vẫn có thể từ từ nâng lên khi có tàu thuyền đi qua, và những bộ phận nào giúp cây cầu chuyển động an toàn như vậy?

Cầu nâng giúp tàu thuyền di chuyển an toàn qua các kênh sông bằng cách tạm thời dừng lưu thông của xe hơi. Với micro:bit V2, micro thu âm sẽ lắng nghe các tiếng động — chẳng hạn như tiếng vỗ tay. Khi phát hiện âm thanh thành công, động cơ servo sẽ kéo cơ cấu liên kết để nâng cầu lên, tạo lối đi cho tàu thuyền.
Bo mạch Robotics cũng đóng vai trò như một vật nặng giúp giữ ổn định, để khi cầu hạ xuống, mọi thứ hoạt động trơn tru và an toàn.

Cầu nâng có thể nâng lên khi tàu thuyền đi qua là nhờ vào nguyên lý nào sau đây?
🧑‍🏫 Câu trả lời
Học sinh sẽ không thấy câu trả lời này
A.✘
Sức gió thổi mạnh
B.✔
Nguyên lý đòn bẩy và đối trọng
💡 Cầu nâng rất nặng, nhưng nhờ nguyên lý đòn bẩy và đối trọng, trọng lượng của cầu được cân bằng một phần bởi các bộ phận hỗ trợ. Nhờ đó, cầu có thể được nâng lên và hạ xuống một cách dễ dàng, an toàn và từ từ, giúp tàu thuyền đi qua mà không cần dùng quá nhiều lực.
C.✘
Nhiệt độ không khí tăng cao
D.✘
Áp lực của nước sông

", + "Status": "Published", + "SectionId": 35 + }, + { + "ContentType": "Text", + "ContentBody": "

Tổng quan bài học

Giải thích cách cầu nâng (drawbridge) đã tận dụng lợi thế cơ học của đòn bẩy trong suốt lịch sử và trong thế giới hiện đại để phục vụ xây dựng và giao thông, cũng như vai trò của con người trong việc vận hành cầu nâng.

Từ thời cổ đại đến hiện đại, cầu nâng đã tận dụng lợi thế cơ học của đòn bẩy để nâng và hạ những nhịp cầu nặng với lực tác động nhỏ hơn nhiều. Trong các lâu đài thời trung cổ, cầu nâng thường được thiết kế như một đòn bẩy loại 1, trong đó trục quay đóng vai trò là điểm tựa, phần cầu là tải trọng, và lực kéo được tạo ra bằng dây xích, đối trọng hoặc tay quay. Thiết kế này cho phép con người nâng cầu một cách hiệu quả để bảo vệ thành trì hoặc cho thuyền bè đi qua.

Mặc dù cây cầu rất nặng, làm thế nào mà cầu nâng vẫn có thể từ từ nâng lên khi có tàu thuyền đi qua, và những bộ phận nào giúp cây cầu chuyển động an toàn như vậy?

Cầu nâng giúp tàu thuyền di chuyển an toàn qua các kênh sông bằng cách tạm thời dừng lưu thông của xe hơi. Với micro:bit V2, micro thu âm sẽ lắng nghe các tiếng động — chẳng hạn như tiếng vỗ tay. Khi phát hiện âm thanh thành công, động cơ servo sẽ kéo cơ cấu liên kết để nâng cầu lên, tạo lối đi cho tàu thuyền.
Bo mạch Robotics cũng đóng vai trò như một vật nặng giúp giữ ổn định, để khi cầu hạ xuống, mọi thứ hoạt động trơn tru và an toàn.

Cầu nâng có thể nâng lên khi tàu thuyền đi qua là nhờ vào nguyên lý nào sau đây?
🧑‍🏫 Câu trả lời
Học sinh sẽ không thấy câu trả lời này
A.✘
Sức gió thổi mạnh
B.✔
Nguyên lý đòn bẩy và đối trọng
💡 Cầu nâng rất nặng, nhưng nhờ nguyên lý đòn bẩy và đối trọng, trọng lượng của cầu được cân bằng một phần bởi các bộ phận hỗ trợ. Nhờ đó, cầu có thể được nâng lên và hạ xuống một cách dễ dàng, an toàn và từ từ, giúp tàu thuyền đi qua mà không cần dùng quá nhiều lực.
C.✘
Nhiệt độ không khí tăng cao
D.✘
Áp lực của nước sông

", + "Status": "Published", + "SectionId": 37 + }, + { + "ContentType": "Text", + "ContentBody": "

Tổng quan bài học

Giải thích cách cầu nâng (drawbridge) đã tận dụng lợi thế cơ học của đòn bẩy trong suốt lịch sử và trong thế giới hiện đại để phục vụ xây dựng và giao thông, cũng như vai trò của con người trong việc vận hành cầu nâng.

Từ thời cổ đại đến hiện đại, cầu nâng đã tận dụng lợi thế cơ học của đòn bẩy để nâng và hạ những nhịp cầu nặng với lực tác động nhỏ hơn nhiều. Trong các lâu đài thời trung cổ, cầu nâng thường được thiết kế như một đòn bẩy loại 1, trong đó trục quay đóng vai trò là điểm tựa, phần cầu là tải trọng, và lực kéo được tạo ra bằng dây xích, đối trọng hoặc tay quay. Thiết kế này cho phép con người nâng cầu một cách hiệu quả để bảo vệ thành trì hoặc cho thuyền bè đi qua.

Mặc dù cây cầu rất nặng, làm thế nào mà cầu nâng vẫn có thể từ từ nâng lên khi có tàu thuyền đi qua, và những bộ phận nào giúp cây cầu chuyển động an toàn như vậy?

Cầu nâng giúp tàu thuyền di chuyển an toàn qua các kênh sông bằng cách tạm thời dừng lưu thông của xe hơi. Với micro:bit V2, micro thu âm sẽ lắng nghe các tiếng động — chẳng hạn như tiếng vỗ tay. Khi phát hiện âm thanh thành công, động cơ servo sẽ kéo cơ cấu liên kết để nâng cầu lên, tạo lối đi cho tàu thuyền.
Bo mạch Robotics cũng đóng vai trò như một vật nặng giúp giữ ổn định, để khi cầu hạ xuống, mọi thứ hoạt động trơn tru và an toàn.

Cầu nâng có thể nâng lên khi tàu thuyền đi qua là nhờ vào nguyên lý nào sau đây?
🧑‍🏫 Câu trả lời
Học sinh sẽ không thấy câu trả lời này
A.✘
Sức gió thổi mạnh
B.✔
Nguyên lý đòn bẩy và đối trọng
💡 Cầu nâng rất nặng, nhưng nhờ nguyên lý đòn bẩy và đối trọng, trọng lượng của cầu được cân bằng một phần bởi các bộ phận hỗ trợ. Nhờ đó, cầu có thể được nâng lên và hạ xuống một cách dễ dàng, an toàn và từ từ, giúp tàu thuyền đi qua mà không cần dùng quá nhiều lực.
C.✘
Nhiệt độ không khí tăng cao
D.✘
Áp lực của nước sông

", + "Status": "Published", + "SectionId": 38 + }, + { + "ContentType": "Text", + "ContentBody": "

Tổng quan bài học

Giải thích cách cầu nâng (drawbridge) đã tận dụng lợi thế cơ học của đòn bẩy trong suốt lịch sử và trong thế giới hiện đại để phục vụ xây dựng và giao thông, cũng như vai trò của con người trong việc vận hành cầu nâng.

Từ thời cổ đại đến hiện đại, cầu nâng đã tận dụng lợi thế cơ học của đòn bẩy để nâng và hạ những nhịp cầu nặng với lực tác động nhỏ hơn nhiều. Trong các lâu đài thời trung cổ, cầu nâng thường được thiết kế như một đòn bẩy loại 1, trong đó trục quay đóng vai trò là điểm tựa, phần cầu là tải trọng, và lực kéo được tạo ra bằng dây xích, đối trọng hoặc tay quay. Thiết kế này cho phép con người nâng cầu một cách hiệu quả để bảo vệ thành trì hoặc cho thuyền bè đi qua.

Mặc dù cây cầu rất nặng, làm thế nào mà cầu nâng vẫn có thể từ từ nâng lên khi có tàu thuyền đi qua, và những bộ phận nào giúp cây cầu chuyển động an toàn như vậy?

Cầu nâng giúp tàu thuyền di chuyển an toàn qua các kênh sông bằng cách tạm thời dừng lưu thông của xe hơi. Với micro:bit V2, micro thu âm sẽ lắng nghe các tiếng động — chẳng hạn như tiếng vỗ tay. Khi phát hiện âm thanh thành công, động cơ servo sẽ kéo cơ cấu liên kết để nâng cầu lên, tạo lối đi cho tàu thuyền.
Bo mạch Robotics cũng đóng vai trò như một vật nặng giúp giữ ổn định, để khi cầu hạ xuống, mọi thứ hoạt động trơn tru và an toàn.

Cầu nâng có thể nâng lên khi tàu thuyền đi qua là nhờ vào nguyên lý nào sau đây?
🧑‍🏫 Câu trả lời
Học sinh sẽ không thấy câu trả lời này
A.✘
Sức gió thổi mạnh
B.✔
Nguyên lý đòn bẩy và đối trọng
💡 Cầu nâng rất nặng, nhưng nhờ nguyên lý đòn bẩy và đối trọng, trọng lượng của cầu được cân bằng một phần bởi các bộ phận hỗ trợ. Nhờ đó, cầu có thể được nâng lên và hạ xuống một cách dễ dàng, an toàn và từ từ, giúp tàu thuyền đi qua mà không cần dùng quá nhiều lực.
C.✘
Nhiệt độ không khí tăng cao
D.✘
Áp lực của nước sông

", + "Status": "Published", + "SectionId": 39 } ] diff --git a/src/Services/Resource/Resource.Infrastructure/Helpers/SeedData/rubricCriterionData.json b/src/Services/Resource/Resource.Infrastructure/Helpers/SeedData/rubricCriterionData.json index c77cfa176..ff606fe06 100644 --- a/src/Services/Resource/Resource.Infrastructure/Helpers/SeedData/rubricCriterionData.json +++ b/src/Services/Resource/Resource.Infrastructure/Helpers/SeedData/rubricCriterionData.json @@ -22,6 +22,198 @@ "CriterionName": "Chất lượng hình ảnh/video", "Description": "Hình ảnh/video rõ ràng, đủ ánh sáng, thể hiện được toàn bộ mô hình và các chi tiết quan trọng.", "MaxPoints": 10 + }, + { + "AssignmentQuestionId": 3, + "CriterionName": "Hiểu biết về nguyên lý đòn bẩy", + "Description": "Đánh giá mức độ hiểu biết về nguyên lý đòn bẩy và cách áp dụng vào cầu nâng. Giải thích rõ ràng, chính xác về các bộ phận và vai trò của chúng.", + "MaxPoints": 15 + }, + { + "AssignmentQuestionId": 3, + "CriterionName": "Mô tả chi tiết và logic", + "Description": "Câu trả lời có cấu trúc rõ ràng, logic, dễ hiểu. Sử dụng thuật ngữ kỹ thuật phù hợp.", + "MaxPoints": 10 + }, + { + "AssignmentQuestionId": 4, + "CriterionName": "Chất lượng mô hình", + "Description": "Mô hình được xây dựng chắc chắn, đúng cấu trúc, thể hiện được các bộ phận chính của cầu nâng. Mô hình có thể hoạt động hoặc mô phỏng được chức năng.", + "MaxPoints": 20 + }, + { + "AssignmentQuestionId": 4, + "CriterionName": "Chất lượng hình ảnh/video", + "Description": "Hình ảnh/video rõ ràng, đủ ánh sáng, thể hiện được toàn bộ mô hình và các chi tiết quan trọng.", + "MaxPoints": 10 + }, + { + "AssignmentQuestionId": 5, + "CriterionName": "Hiểu biết về nguyên lý đòn bẩy", + "Description": "Đánh giá mức độ hiểu biết về nguyên lý đòn bẩy và cách áp dụng vào cầu nâng. Giải thích rõ ràng, chính xác về các bộ phận và vai trò của chúng.", + "MaxPoints": 15 + }, + { + "AssignmentQuestionId": 5, + "CriterionName": "Mô tả chi tiết và logic", + "Description": "Câu trả lời có cấu trúc rõ ràng, logic, dễ hiểu. Sử dụng thuật ngữ kỹ thuật phù hợp.", + "MaxPoints": 10 + }, + { + "AssignmentQuestionId": 6, + "CriterionName": "Chất lượng mô hình", + "Description": "Mô hình được xây dựng chắc chắn, đúng cấu trúc, thể hiện được các bộ phận chính của cầu nâng. Mô hình có thể hoạt động hoặc mô phỏng được chức năng.", + "MaxPoints": 20 + }, + { + "AssignmentQuestionId": 6, + "CriterionName": "Chất lượng hình ảnh/video", + "Description": "Hình ảnh/video rõ ràng, đủ ánh sáng, thể hiện được toàn bộ mô hình và các chi tiết quan trọng.", + "MaxPoints": 10 + }, + { + "AssignmentQuestionId": 7, + "CriterionName": "Hiểu biết về nguyên lý đòn bẩy", + "Description": "Đánh giá mức độ hiểu biết về nguyên lý đòn bẩy và cách áp dụng vào cầu nâng. Giải thích rõ ràng, chính xác về các bộ phận và vai trò của chúng.", + "MaxPoints": 15 + }, + { + "AssignmentQuestionId": 7, + "CriterionName": "Mô tả chi tiết và logic", + "Description": "Câu trả lời có cấu trúc rõ ràng, logic, dễ hiểu. Sử dụng thuật ngữ kỹ thuật phù hợp.", + "MaxPoints": 10 + }, + { + "AssignmentQuestionId": 8, + "CriterionName": "Chất lượng mô hình", + "Description": "Mô hình được xây dựng chắc chắn, đúng cấu trúc, thể hiện được các bộ phận chính của cầu nâng. Mô hình có thể hoạt động hoặc mô phỏng được chức năng.", + "MaxPoints": 20 + }, + { + "AssignmentQuestionId": 8, + "CriterionName": "Chất lượng hình ảnh/video", + "Description": "Hình ảnh/video rõ ràng, đủ ánh sáng, thể hiện được toàn bộ mô hình và các chi tiết quan trọng.", + "MaxPoints": 10 + }, + { + "AssignmentQuestionId": 9, + "CriterionName": "Hiểu biết về nguyên lý đòn bẩy", + "Description": "Đánh giá mức độ hiểu biết về nguyên lý đòn bẩy và cách áp dụng vào cầu nâng. Giải thích rõ ràng, chính xác về các bộ phận và vai trò của chúng.", + "MaxPoints": 15 + }, + { + "AssignmentQuestionId": 9, + "CriterionName": "Mô tả chi tiết và logic", + "Description": "Câu trả lời có cấu trúc rõ ràng, logic, dễ hiểu. Sử dụng thuật ngữ kỹ thuật phù hợp.", + "MaxPoints": 10 + }, + { + "AssignmentQuestionId": 10, + "CriterionName": "Chất lượng mô hình", + "Description": "Mô hình được xây dựng chắc chắn, đúng cấu trúc, thể hiện được các bộ phận chính của cầu nâng. Mô hình có thể hoạt động hoặc mô phỏng được chức năng.", + "MaxPoints": 20 + }, + { + "AssignmentQuestionId": 10, + "CriterionName": "Chất lượng hình ảnh/video", + "Description": "Hình ảnh/video rõ ràng, đủ ánh sáng, thể hiện được toàn bộ mô hình và các chi tiết quan trọng.", + "MaxPoints": 10 + }, + { + "AssignmentQuestionId": 11, + "CriterionName": "Hiểu biết về nguyên lý đòn bẩy", + "Description": "Đánh giá mức độ hiểu biết về nguyên lý đòn bẩy và cách áp dụng vào cầu nâng. Giải thích rõ ràng, chính xác về các bộ phận và vai trò của chúng.", + "MaxPoints": 15 + }, + { + "AssignmentQuestionId": 11, + "CriterionName": "Mô tả chi tiết và logic", + "Description": "Câu trả lời có cấu trúc rõ ràng, logic, dễ hiểu. Sử dụng thuật ngữ kỹ thuật phù hợp.", + "MaxPoints": 10 + }, + { + "AssignmentQuestionId": 12, + "CriterionName": "Chất lượng mô hình", + "Description": "Mô hình được xây dựng chắc chắn, đúng cấu trúc, thể hiện được các bộ phận chính của cầu nâng. Mô hình có thể hoạt động hoặc mô phỏng được chức năng.", + "MaxPoints": 20 + }, + { + "AssignmentQuestionId": 12, + "CriterionName": "Chất lượng hình ảnh/video", + "Description": "Hình ảnh/video rõ ràng, đủ ánh sáng, thể hiện được toàn bộ mô hình và các chi tiết quan trọng.", + "MaxPoints": 10 + }, + { + "AssignmentQuestionId": 13, + "CriterionName": "Hiểu biết về nguyên lý đòn bẩy", + "Description": "Đánh giá mức độ hiểu biết về nguyên lý đòn bẩy và cách áp dụng vào cầu nâng. Giải thích rõ ràng, chính xác về các bộ phận và vai trò của chúng.", + "MaxPoints": 15 + }, + { + "AssignmentQuestionId": 13, + "CriterionName": "Mô tả chi tiết và logic", + "Description": "Câu trả lời có cấu trúc rõ ràng, logic, dễ hiểu. Sử dụng thuật ngữ kỹ thuật phù hợp.", + "MaxPoints": 10 + }, + { + "AssignmentQuestionId": 14, + "CriterionName": "Chất lượng mô hình", + "Description": "Mô hình được xây dựng chắc chắn, đúng cấu trúc, thể hiện được các bộ phận chính của cầu nâng. Mô hình có thể hoạt động hoặc mô phỏng được chức năng.", + "MaxPoints": 20 + }, + { + "AssignmentQuestionId": 14, + "CriterionName": "Chất lượng hình ảnh/video", + "Description": "Hình ảnh/video rõ ràng, đủ ánh sáng, thể hiện được toàn bộ mô hình và các chi tiết quan trọng.", + "MaxPoints": 10 + }, + { + "AssignmentQuestionId": 15, + "CriterionName": "Hiểu biết về nguyên lý đòn bẩy", + "Description": "Đánh giá mức độ hiểu biết về nguyên lý đòn bẩy và cách áp dụng vào cầu nâng. Giải thích rõ ràng, chính xác về các bộ phận và vai trò của chúng.", + "MaxPoints": 15 + }, + { + "AssignmentQuestionId": 15, + "CriterionName": "Mô tả chi tiết và logic", + "Description": "Câu trả lời có cấu trúc rõ ràng, logic, dễ hiểu. Sử dụng thuật ngữ kỹ thuật phù hợp.", + "MaxPoints": 10 + }, + { + "AssignmentQuestionId": 16, + "CriterionName": "Chất lượng mô hình", + "Description": "Mô hình được xây dựng chắc chắn, đúng cấu trúc, thể hiện được các bộ phận chính của cầu nâng. Mô hình có thể hoạt động hoặc mô phỏng được chức năng.", + "MaxPoints": 20 + }, + { + "AssignmentQuestionId": 16, + "CriterionName": "Chất lượng hình ảnh/video", + "Description": "Hình ảnh/video rõ ràng, đủ ánh sáng, thể hiện được toàn bộ mô hình và các chi tiết quan trọng.", + "MaxPoints": 10 + }, + { + "AssignmentQuestionId": 17, + "CriterionName": "Hiểu biết về nguyên lý đòn bẩy", + "Description": "Đánh giá mức độ hiểu biết về nguyên lý đòn bẩy và cách áp dụng vào cầu nâng. Giải thích rõ ràng, chính xác về các bộ phận và vai trò của chúng.", + "MaxPoints": 15 + }, + { + "AssignmentQuestionId": 17, + "CriterionName": "Mô tả chi tiết và logic", + "Description": "Câu trả lời có cấu trúc rõ ràng, logic, dễ hiểu. Sử dụng thuật ngữ kỹ thuật phù hợp.", + "MaxPoints": 10 + }, + { + "AssignmentQuestionId": 18, + "CriterionName": "Chất lượng mô hình", + "Description": "Mô hình được xây dựng chắc chắn, đúng cấu trúc, thể hiện được các bộ phận chính của cầu nâng. Mô hình có thể hoạt động hoặc mô phỏng được chức năng.", + "MaxPoints": 20 + }, + { + "AssignmentQuestionId": 18, + "CriterionName": "Chất lượng hình ảnh/video", + "Description": "Hình ảnh/video rõ ràng, đủ ánh sáng, thể hiện được toàn bộ mô hình và các chi tiết quan trọng.", + "MaxPoints": 10 } ] From 939fd34f17fb8c0df2b022f0ffdd8f715b09e249 Mon Sep 17 00:00:00 2001 From: meewaldor Date: Sat, 20 Dec 2025 12:05:17 +0700 Subject: [PATCH 02/29] Handle section deletion based on status Updated `DeleteSectionCommandHandler.cs` to differentiate between Draft and Published sections during deletion. Draft sections are deleted permanently, while Published sections are marked as Deleted, allowing for potential recovery and better auditing. --- .../Handlers/Section/DeleteSectionCommandHandler.cs | 10 +++++++++- 1 file changed, 9 insertions(+), 1 deletion(-) diff --git a/src/Services/Resource/Resource.Application/Handlers/Section/DeleteSectionCommandHandler.cs b/src/Services/Resource/Resource.Application/Handlers/Section/DeleteSectionCommandHandler.cs index bdb656367..2a01332a0 100644 --- a/src/Services/Resource/Resource.Application/Handlers/Section/DeleteSectionCommandHandler.cs +++ b/src/Services/Resource/Resource.Application/Handlers/Section/DeleteSectionCommandHandler.cs @@ -25,7 +25,15 @@ public async Task Handle(DeleteSectionCommand request, CancellationToken cancell if (section == null) throw new KeyNotFoundException($"Section with ID {request.Id} not found."); - await _unitOfWork.Sections.DeleteAsync(section, cancellationToken); + // If the section is in Draft status, delete it permanently. + if (section.Status == Domain.Enums.SectionStatus.Draft) + await _unitOfWork.Sections.DeleteAsync(section, cancellationToken); + else + { + // For Published sections, mark them as Deleted. + section.Status = Domain.Enums.SectionStatus.Deleted; + } + await _unitOfWork.SaveChangesAsync(cancellationToken); var sections = (await _unitOfWork.Sections.GetAllAsync( From 1b2816fd6d492fd7935541663d4df931f5fac30d Mon Sep 17 00:00:00 2001 From: halinhtvn3a <77691576+halinhtvn3a@users.noreply.github.com> Date: Sun, 21 Dec 2025 16:53:25 +0700 Subject: [PATCH 03/29] Update UserGrpcService.cs --- .../Identity/Identity.API/Services/UserGrpcService.cs | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/src/Services/Identity/Identity.API/Services/UserGrpcService.cs b/src/Services/Identity/Identity.API/Services/UserGrpcService.cs index 2688f4e92..051095a6b 100644 --- a/src/Services/Identity/Identity.API/Services/UserGrpcService.cs +++ b/src/Services/Identity/Identity.API/Services/UserGrpcService.cs @@ -432,8 +432,8 @@ ServerCallContext context result.Data.Select(user => new GrpcUserResponse { UserId = user.Sub, - FirstName = user.GivenName ?? "", - LastName = user.FamilyName ?? "", + FirstName = user.FirstName ?? "", + LastName = user.LastName ?? "", UserName = user.UserName ?? "", Email = user.Email, ImageUrl = user.Picture, From 0e5eaffdc24554c238528035271d83021a15546d Mon Sep 17 00:00:00 2001 From: halinhtvn3a <77691576+halinhtvn3a@users.noreply.github.com> Date: Sun, 21 Dec 2025 17:10:18 +0700 Subject: [PATCH 04/29] Update notification-api.tmpl.yaml --- .../STEMify-Backend.AppHost/infra/notification-api.tmpl.yaml | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/src/Services/STEMify-Backend/STEMify-Backend.AppHost/infra/notification-api.tmpl.yaml b/src/Services/STEMify-Backend/STEMify-Backend.AppHost/infra/notification-api.tmpl.yaml index 1cd6af5a2..d9fdeacb2 100644 --- a/src/Services/STEMify-Backend/STEMify-Backend.AppHost/infra/notification-api.tmpl.yaml +++ b/src/Services/STEMify-Backend/STEMify-Backend.AppHost/infra/notification-api.tmpl.yaml @@ -71,9 +71,9 @@ properties: - name: ClientApp value: {{ if .Env.CLIENT_APP_URL }}{{ .Env.CLIENT_APP_URL }}{{ else }}https://localhost:3000{{ end }} - name: Issuer - value: https://identity-api.{{ .Env.AZURE_CONTAINER_APPS_ENVIRONMENT_DEFAULT_DOMAIN }}/ + value: https://identity.{{ .Env.AZURE_CONTAINER_APPS_ENVIRONMENT_DEFAULT_DOMAIN }}/ - name: IdentityServiceUrl - value: https://identity-api.{{ .Env.AZURE_CONTAINER_APPS_ENVIRONMENT_DEFAULT_DOMAIN }} + value: https://identity.{{ .Env.AZURE_CONTAINER_APPS_ENVIRONMENT_DEFAULT_DOMAIN }} scale: minReplicas: 1 tags: From 7fe1a864eadfdccd15417d938777acdf0950dd8c Mon Sep 17 00:00:00 2001 From: meewaldor Date: Sun, 21 Dec 2025 17:34:11 +0700 Subject: [PATCH 05/29] Refactor notification seeding and update age ranges - Enhanced filtering conditions for quiz and assignment scores in GetClassroomStatisticQueryHandler.cs. - Removed NotificationDbContextSeed instantiation and its registration in DependencyInjection.cs, eliminating database seeding during startup. - Cleared multiple entries from notificationData.json, indicating a reset of initial user notifications. - Updated Notification.Infrastructure.csproj to stop copying notificationData.json to output. - Completely removed NotificationDbContextSeed.cs file, eliminating the seeding logic. - Adjusted age ranges in ageRangeData.json, changing labels and corresponding age limits. --- .../GetClassroomStatisticQueryHandler.cs | 6 +- .../Notification/Notification.API/Program.cs | 3 - .../Extensions/DependencyInjection.cs | 1 - .../Helpers/SeedData/notificationData.json | 62 ------------------- .../Notification.Infrastructure.csproj | 5 -- .../Persistence/NotificationDbContextSeed.cs | 30 --------- .../Helpers/SeedData/ageRangeData.json | 10 +-- 7 files changed, 9 insertions(+), 108 deletions(-) delete mode 100644 src/Services/Notification/Notification.Infrastructure/Helpers/SeedData/notificationData.json delete mode 100644 src/Services/Notification/Notification.Infrastructure/Persistence/NotificationDbContextSeed.cs diff --git a/src/Services/ClassroomService/Classroom.Application/Features/Classrooms/Queries/GetClassroomStatistic/GetClassroomStatisticQueryHandler.cs b/src/Services/ClassroomService/Classroom.Application/Features/Classrooms/Queries/GetClassroomStatistic/GetClassroomStatisticQueryHandler.cs index bd7dfe286..4b8574cca 100644 --- a/src/Services/ClassroomService/Classroom.Application/Features/Classrooms/Queries/GetClassroomStatistic/GetClassroomStatisticQueryHandler.cs +++ b/src/Services/ClassroomService/Classroom.Application/Features/Classrooms/Queries/GetClassroomStatistic/GetClassroomStatisticQueryHandler.cs @@ -245,14 +245,16 @@ private async Task CalculateCourseStatisticsAsync( // Lấy điểm quiz var quizScores = enrollment.LessonProgress .SelectMany(lp => lp.SectionProgress) - .Where(sp => sp.StudentQuiz != null && sp.StudentQuiz.Status != StudentQuizStatus.Assigned) + .Where(sp => sp.StudentQuiz != null + && sp.StudentQuiz.Status != StudentQuizStatus.Assigned && sp.StudentQuiz.Status != StudentQuizStatus.InProgress) .Select(sp => sp.StudentQuiz?.FinalScore ?? 0) .ToList(); // Lấy điểm assignment var assignmentScores = enrollment.LessonProgress .SelectMany(lp => lp.SectionProgress) - .Where(sp => sp.StudentAssignment != null && sp.StudentAssignment.Status != StudentAssignmentStatus.Assigned) + .Where(sp => sp.StudentAssignment != null + && sp.StudentAssignment.Status != StudentAssignmentStatus.Assigned && sp.StudentAssignment.Status != StudentAssignmentStatus.Submitted) .Select(sp => sp.StudentAssignment?.FinalScore ?? 0) .ToList(); diff --git a/src/Services/Notification/Notification.API/Program.cs b/src/Services/Notification/Notification.API/Program.cs index 4477d3b7e..4a9e2cb09 100644 --- a/src/Services/Notification/Notification.API/Program.cs +++ b/src/Services/Notification/Notification.API/Program.cs @@ -147,14 +147,11 @@ public static async Task Main(string[] args) { var services = scope.ServiceProvider; var notificationDbContext = services.GetRequiredService(); - var notificationDbSeed = - scope.ServiceProvider.GetRequiredService(); var logger = services.GetRequiredService>(); try { await notificationDbContext.Database.MigrateAsync(); - await notificationDbSeed.SeedAsync(); } catch (Exception ex) { diff --git a/src/Services/Notification/Notification.Infrastructure/Extensions/DependencyInjection.cs b/src/Services/Notification/Notification.Infrastructure/Extensions/DependencyInjection.cs index ab4048932..4d8af9536 100644 --- a/src/Services/Notification/Notification.Infrastructure/Extensions/DependencyInjection.cs +++ b/src/Services/Notification/Notification.Infrastructure/Extensions/DependencyInjection.cs @@ -37,7 +37,6 @@ IConfiguration config services.AddScoped(); services.AddScoped(); - services.AddScoped(); services.AddScoped(); services.AddScoped(); diff --git a/src/Services/Notification/Notification.Infrastructure/Helpers/SeedData/notificationData.json b/src/Services/Notification/Notification.Infrastructure/Helpers/SeedData/notificationData.json deleted file mode 100644 index f92c02314..000000000 --- a/src/Services/Notification/Notification.Infrastructure/Helpers/SeedData/notificationData.json +++ /dev/null @@ -1,62 +0,0 @@ -[ - { - "UserId": "b7e2c7e2-8c1a-4e2e-9b2a-2e7c8e2a1b3c", - "Title": "Welcome to the platform!", - "Message": "Thank you for joining. Explore your dashboard to get started.", - "IsRead": false - }, - { - "UserId": "b7e2c7e2-8c1a-4e2e-9b2a-2e7c8e2a1b3c", - "Title": "Profile Update", - "Message": "Your profile was updated successfully.", - "IsRead": false - }, - { - "UserId": "b7e2c7e2-8c1a-4e2e-9b2a-2e7c8e2a1b3c", - "Title": "New Message", - "Message": "You have received a new message from support.", - "IsRead": false - }, - { - "UserId": "b7e2c7e2-8c1a-4e2e-9b2a-2e7c8e2a1b3c", - "Title": "System Maintenance", - "Message": "Scheduled maintenance will occur this weekend.", - "IsRead": false - }, - { - "UserId": "b7e2c7e2-8c1a-4e2e-9b2a-2e7c8e2a1b3c", - "Title": "Password Changed", - "Message": "Your password was changed successfully.", - "IsRead": false - }, - { - "UserId": "b7e2c7e2-8c1a-4e2e-9b2a-2e7c8e2a1b3c", - "Title": "Subscription Expiring", - "Message": "Your subscription will expire in 3 days.", - "IsRead": false - }, - { - "UserId": "b7e2c7e2-8c1a-4e2e-9b2a-2e7c8e2a1b3c", - "Title": "New Feature Released", - "Message": "Check out the new features in your dashboard.", - "IsRead": false - }, - { - "UserId": "b7e2c7e2-8c1a-4e2e-9b2a-2e7c8e2a1b3c", - "Title": "Account Verification", - "Message": "Please verify your email address to continue.", - "IsRead": false - }, - { - "UserId": "b7e2c7e2-8c1a-4e2e-9b2a-2e7c8e2a1b3c", - "Title": "Event Invitation", - "Message": "You are invited to our upcoming event.", - "IsRead": false - }, - { - "UserId": "b7e2c7e2-8c1a-4e2e-9b2a-2e7c8e2a1b3c", - "Title": "Survey Request", - "Message": "Please take a moment to complete our survey.", - "IsRead": false - } -] \ No newline at end of file diff --git a/src/Services/Notification/Notification.Infrastructure/Notification.Infrastructure.csproj b/src/Services/Notification/Notification.Infrastructure/Notification.Infrastructure.csproj index 9fc62382a..abd795a0e 100644 --- a/src/Services/Notification/Notification.Infrastructure/Notification.Infrastructure.csproj +++ b/src/Services/Notification/Notification.Infrastructure/Notification.Infrastructure.csproj @@ -10,9 +10,4 @@ - - - PreserveNewest - - diff --git a/src/Services/Notification/Notification.Infrastructure/Persistence/NotificationDbContextSeed.cs b/src/Services/Notification/Notification.Infrastructure/Persistence/NotificationDbContextSeed.cs deleted file mode 100644 index 2887f3cc2..000000000 --- a/src/Services/Notification/Notification.Infrastructure/Persistence/NotificationDbContextSeed.cs +++ /dev/null @@ -1,30 +0,0 @@ -using Contracts.Abstractions.Services; -using Infrastructure.Common; -using Notification.Domain.Constants; - -namespace Notification.Infrastructure.Persistence -{ - public class NotificationDbContextSeed - { - private readonly NotificationDbContext _dbContext; - private readonly IFileReader _fileReader; - - public NotificationDbContextSeed(NotificationDbContext dbContext, IFileReader fileReader) - { - _dbContext = dbContext; - _fileReader = fileReader; - } - - public async Task SeedAsync() - { - var rootPath = AppCts.AbsoluteProjectPath; - - await new JsonDataSeeder( - _fileReader, - _dbContext - ) - .AddRelativeFilePath(rootPath, AppCts.SeederRelativePath.NotificationPath) - .SeedAsync(); - } - } -} diff --git a/src/Services/Resource/Resource.Infrastructure/Helpers/SeedData/ageRangeData.json b/src/Services/Resource/Resource.Infrastructure/Helpers/SeedData/ageRangeData.json index f2570c1c2..e60bc1eae 100644 --- a/src/Services/Resource/Resource.Infrastructure/Helpers/SeedData/ageRangeData.json +++ b/src/Services/Resource/Resource.Infrastructure/Helpers/SeedData/ageRangeData.json @@ -5,13 +5,13 @@ "MaxAge": 7 }, { - "AgeRangeLabel": "8-10", + "AgeRangeLabel": "8-11", "MinAge": 8, - "MaxAge": 10 + "MaxAge": 11 }, { - "AgeRangeLabel": "11-14", - "MinAge": 11, - "MaxAge": 14 + "AgeRangeLabel": "11-15", + "MinAge": 12, + "MaxAge": 15 } ] From 1d2a0c8a2fa46e50d77fc1ebc6ce4d758aaf8535 Mon Sep 17 00:00:00 2001 From: meewaldor Date: Sun, 21 Dec 2025 23:07:10 +0700 Subject: [PATCH 06/29] Update DefaultStaff Id in SeedDataConstants --- .../Identity/Identity.Domain/Constants/SeedDataConstants.cs | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/Services/Identity/Identity.Domain/Constants/SeedDataConstants.cs b/src/Services/Identity/Identity.Domain/Constants/SeedDataConstants.cs index 2b7dba481..e76ff707b 100644 --- a/src/Services/Identity/Identity.Domain/Constants/SeedDataConstants.cs +++ b/src/Services/Identity/Identity.Domain/Constants/SeedDataConstants.cs @@ -46,7 +46,7 @@ public static class DefaultUsersV2 ); public static readonly UserSeedDataV2 DefaultStaff = new( - Id: "bf2a1b93-5417-4214-8aac-840ac13a64bd", + Id: "0874973b-6fe5-427f-83e1-703780aa0bd5", Email: "staff@stemify.com", Password: "Staff123!", Role: "Staff", From c556d17410b1dc393cebb40abb39b34f7b40b308 Mon Sep 17 00:00:00 2001 From: th3y3m Date: Mon, 22 Dec 2025 12:20:16 +0700 Subject: [PATCH 07/29] feat: update GetOrganizationDashboardQueryHandler --- .../GetOrganizationDashboardQueryHandler.cs | 118 ++++++++++-------- ...anizationSubscriptionOrderSpecification.cs | 13 +- 2 files changed, 75 insertions(+), 56 deletions(-) diff --git a/src/Services/OrderService/Order.Application/Queries/Organizations/GetOrganizationDashboard/GetOrganizationDashboardQueryHandler.cs b/src/Services/OrderService/Order.Application/Queries/Organizations/GetOrganizationDashboard/GetOrganizationDashboardQueryHandler.cs index 20a08f65f..a1ffc2ec9 100644 --- a/src/Services/OrderService/Order.Application/Queries/Organizations/GetOrganizationDashboard/GetOrganizationDashboardQueryHandler.cs +++ b/src/Services/OrderService/Order.Application/Queries/Organizations/GetOrganizationDashboard/GetOrganizationDashboardQueryHandler.cs @@ -166,13 +166,14 @@ CancellationToken cancellationToken var startOffset = new DateTimeOffset(periodStart.ToUniversalTime(), TimeSpan.Zero); var endOffset = new DateTimeOffset(periodEnd.ToUniversalTime(), TimeSpan.Zero); + var spec = new OrganizationSubscriptionOrdersWithCurriculumsSpec( + organizationId, + startOffset, + endOffset + ); + var subscriptionOrders = await _unitOfWork.OrganizationSubscriptionOrders - .FindAsync( - predicate: x => x.OrganizationId == organizationId - && x.CreatedDate >= startOffset - && x.CreatedDate < endOffset, - cancellationToken: cancellationToken - ); + .GetAllAsync(spec, cancellationToken); var subscriptionOrderIds = subscriptionOrders.Select(x => x.Id).ToList(); @@ -256,7 +257,11 @@ CancellationToken cancellationToken } // Step 6: Calculate statistics - var totalCurriculum = subscriptionOrders.Count(); + var totalCurriculum = subscriptionOrders + .SelectMany(o => o.SubscriptionOrderCurriculums?.Select(s => s.CurriculumId) ?? Enumerable.Empty()) + .Distinct() + .Count(); + var totalClassrooms = allClassrooms.Count(); var totalCurriculumEnrollments = allCourseEnrollments.Count(); var totalCertificates = allCertificates.Count(); @@ -299,76 +304,81 @@ CancellationToken cancellationToken var stats = new List(); - foreach (var order in subscriptionOrders) + var distinctCurriculumIds = subscriptionOrders + .SelectMany(o => o.SubscriptionOrderCurriculums?.Select(sc => sc.CurriculumId) ?? Enumerable.Empty()) + .Distinct() + .ToList(); + + foreach (var curriculumId in distinctCurriculumIds) { - // Get all classrooms for this subscription order - var getClassroomsRequest = new GetClassroomsRequest - { - PageNumber = 1, - PageSize = 1000, - FromDate = Google.Protobuf.WellKnownTypes.Timestamp.FromDateTime(periodStart.ToUniversalTime()), - ToDate = Google.Protobuf.WellKnownTypes.Timestamp.FromDateTime(periodEnd.ToUniversalTime()), - OrganizationSubscriptionOrderId = order.Id - }; + var ordersContainingCurriculum = subscriptionOrders + .Where(o => o.SubscriptionOrderCurriculums != null && o.SubscriptionOrderCurriculums.Any(sc => sc.CurriculumId == curriculumId)) + .ToList(); - var classroomsResponse = await _classroomClient.GetPagedClassrooms(getClassroomsRequest); - var allEnrollmentsForOrder = new List(); + var allEnrollmentsForCurriculum = new List(); - // Get all enrollments for all classrooms in this order - foreach (var classroom in classroomsResponse.Items) + foreach (var order in ordersContainingCurriculum) { - var enrollmentsRequest = new GetCourseEnrollmentsRequest + var getClassroomsRequest = new GetClassroomsRequest { PageNumber = 1, PageSize = 1000, - ClassroomId = classroom.Id, + FromDate = Google.Protobuf.WellKnownTypes.Timestamp.FromDateTime(periodStart.ToUniversalTime()), + ToDate = Google.Protobuf.WellKnownTypes.Timestamp.FromDateTime(periodEnd.ToUniversalTime()), + OrganizationSubscriptionOrderId = order.Id }; - var enrollmentsResponse = await _courseEnrollmentClient.GetPagedCourseEnrollments(enrollmentsRequest); - allEnrollmentsForOrder.AddRange(enrollmentsResponse.Items); + var classroomsResponse = await _classroomClient.GetPagedClassrooms(getClassroomsRequest); + + foreach (var classroom in classroomsResponse.Items) + { + var enrollmentsRequest = new GetCourseEnrollmentsRequest + { + PageNumber = 1, + PageSize = 1000, + ClassroomId = classroom.Id, + }; + + var enrollmentsResponse = await _courseEnrollmentClient.GetPagedCourseEnrollments(enrollmentsRequest); + allEnrollmentsForCurriculum.AddRange(enrollmentsResponse.Items); + } } - // Calculate pass rate for this order - var completedCount = allEnrollmentsForOrder + var completedCount = allEnrollmentsForCurriculum .Where(x => x.Status == "Completed") .Count(); - var passRate = allEnrollmentsForOrder.Count() > 0 - ? (double)completedCount / allEnrollmentsForOrder.Count() * 100 + var passRate = allEnrollmentsForCurriculum.Count() > 0 + ? (double)completedCount / allEnrollmentsForCurriculum.Count() * 100 : 0; - // Get curriculum info from cache - if (order.SubscriptionOrderCurriculums != null && order.SubscriptionOrderCurriculums.Any()) - { - foreach (var curriculumMapping in order.SubscriptionOrderCurriculums) - { - var curriculum = await _curriculumCacheService.GetCurriculumByIdAsync( - curriculumMapping.CurriculumId, - cancellationToken - ); + var curriculum = await _curriculumCacheService.GetCurriculumByIdAsync( + curriculumId, + cancellationToken + ); - stats.Add(new CurriculumStatisticModel - { - Id = curriculumMapping.CurriculumId, - Title = curriculum?.Title ?? order.PlanName, - ImageUrl = curriculum?.ImageUrl ?? string.Empty, - CourseCount = curriculum?.CourseCount ?? 0, - PassRate = passRate, - TotalEnrollment = allEnrollmentsForOrder.Count() - }); - } - } + var titleFallback = ordersContainingCurriculum.FirstOrDefault()?.PlanName ?? string.Empty; + + stats.Add(new CurriculumStatisticModel + { + Id = curriculumId, + Title = curriculum?.Title ?? titleFallback, + ImageUrl = curriculum?.ImageUrl ?? string.Empty, + CourseCount = curriculum?.CourseCount ?? 0, + PassRate = passRate, + TotalEnrollment = allEnrollmentsForCurriculum.Count() + }); } return stats; } private async Task> GetClassroomStatistics( - int organizationId, - DateTime periodStart, - DateTime periodEnd, - CancellationToken cancellationToken -) + int organizationId, + DateTime periodStart, + DateTime periodEnd, + CancellationToken cancellationToken + ) { var startOffset = new DateTimeOffset(periodStart.ToUniversalTime(), TimeSpan.Zero); var endOffset = new DateTimeOffset(periodEnd.ToUniversalTime(), TimeSpan.Zero); diff --git a/src/Services/OrderService/Order.Application/Specifications/OrganizationSubscriptionOrderSpecification.cs b/src/Services/OrderService/Order.Application/Specifications/OrganizationSubscriptionOrderSpecification.cs index eeb843fcd..38f5ff913 100644 --- a/src/Services/OrderService/Order.Application/Specifications/OrganizationSubscriptionOrderSpecification.cs +++ b/src/Services/OrderService/Order.Application/Specifications/OrganizationSubscriptionOrderSpecification.cs @@ -1,5 +1,4 @@ -using System; -using Ardalis.Specification; +using Ardalis.Specification; using Order.Domain.Entities; using Order.Domain.Enums; @@ -76,4 +75,14 @@ public OrganizationCurriculumByOrganizationIdSpecification(int organizationId, O .Include(o => o.SubscriptionOrderCurriculums); } } + + public class OrganizationSubscriptionOrdersWithCurriculumsSpec : Specification + { + public OrganizationSubscriptionOrdersWithCurriculumsSpec(int organizationId, DateTimeOffset start, DateTimeOffset end) + { + Query + .Where(o => o.OrganizationId == organizationId && o.CreatedDate >= start && o.CreatedDate < end) + .Include(o => o.SubscriptionOrderCurriculums); + } + } } From 7711a28d4ef93496f17be325db9734e9a497c2cb Mon Sep 17 00:00:00 2001 From: halinhtvn3a <77691576+halinhtvn3a@users.noreply.github.com> Date: Sun, 21 Dec 2025 16:53:25 +0700 Subject: [PATCH 08/29] Update UserGrpcService.cs --- .../Identity/Identity.API/Services/UserGrpcService.cs | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/src/Services/Identity/Identity.API/Services/UserGrpcService.cs b/src/Services/Identity/Identity.API/Services/UserGrpcService.cs index 2688f4e92..051095a6b 100644 --- a/src/Services/Identity/Identity.API/Services/UserGrpcService.cs +++ b/src/Services/Identity/Identity.API/Services/UserGrpcService.cs @@ -432,8 +432,8 @@ ServerCallContext context result.Data.Select(user => new GrpcUserResponse { UserId = user.Sub, - FirstName = user.GivenName ?? "", - LastName = user.FamilyName ?? "", + FirstName = user.FirstName ?? "", + LastName = user.LastName ?? "", UserName = user.UserName ?? "", Email = user.Email, ImageUrl = user.Picture, From b20f37274aa6cfd64ccf35fd51037211e6019539 Mon Sep 17 00:00:00 2001 From: halinhtvn3a <77691576+halinhtvn3a@users.noreply.github.com> Date: Sun, 21 Dec 2025 17:10:18 +0700 Subject: [PATCH 09/29] Update notification-api.tmpl.yaml --- .../STEMify-Backend.AppHost/infra/notification-api.tmpl.yaml | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/src/Services/STEMify-Backend/STEMify-Backend.AppHost/infra/notification-api.tmpl.yaml b/src/Services/STEMify-Backend/STEMify-Backend.AppHost/infra/notification-api.tmpl.yaml index 1cd6af5a2..d9fdeacb2 100644 --- a/src/Services/STEMify-Backend/STEMify-Backend.AppHost/infra/notification-api.tmpl.yaml +++ b/src/Services/STEMify-Backend/STEMify-Backend.AppHost/infra/notification-api.tmpl.yaml @@ -71,9 +71,9 @@ properties: - name: ClientApp value: {{ if .Env.CLIENT_APP_URL }}{{ .Env.CLIENT_APP_URL }}{{ else }}https://localhost:3000{{ end }} - name: Issuer - value: https://identity-api.{{ .Env.AZURE_CONTAINER_APPS_ENVIRONMENT_DEFAULT_DOMAIN }}/ + value: https://identity.{{ .Env.AZURE_CONTAINER_APPS_ENVIRONMENT_DEFAULT_DOMAIN }}/ - name: IdentityServiceUrl - value: https://identity-api.{{ .Env.AZURE_CONTAINER_APPS_ENVIRONMENT_DEFAULT_DOMAIN }} + value: https://identity.{{ .Env.AZURE_CONTAINER_APPS_ENVIRONMENT_DEFAULT_DOMAIN }} scale: minReplicas: 1 tags: From 0c035d387c0c84e775d87ffe03f0d8027dec474e Mon Sep 17 00:00:00 2001 From: halinhtvn3a <77691576+halinhtvn3a@users.noreply.github.com> Date: Mon, 22 Dec 2025 14:30:26 +0700 Subject: [PATCH 10/29] Update user activation logic and cookie options Modified user activation to prevent re-activation of already active or deleted users in AcceptInvitationCommandHandler. Updated AccountController to always set cookies as secure and set the domain based on request security. --- .../AcceptInvitationCommandHandler.cs | 4 ++-- .../Identity.Web/Controllers/AccountController.cs | 11 +++++++++-- 2 files changed, 11 insertions(+), 4 deletions(-) diff --git a/src/Services/Identity/Identity.Application/Commands/BulkProvisioning/AcceptInvitation/AcceptInvitationCommandHandler.cs b/src/Services/Identity/Identity.Application/Commands/BulkProvisioning/AcceptInvitation/AcceptInvitationCommandHandler.cs index 86d280a1d..e8a6c39a9 100644 --- a/src/Services/Identity/Identity.Application/Commands/BulkProvisioning/AcceptInvitation/AcceptInvitationCommandHandler.cs +++ b/src/Services/Identity/Identity.Application/Commands/BulkProvisioning/AcceptInvitation/AcceptInvitationCommandHandler.cs @@ -216,8 +216,8 @@ public async Task Handle( orgUser.Id, user.Id); } - // 10. Activate user (Pending -> Active) and confirm email - if (user.Status == UserStatus.Pending) + // 10. Activate user (if not already Active or Deleted) + if (user.Status != UserStatus.Active && user.Status != UserStatus.Deleted) { user.Activate(); } diff --git a/src/Services/Identity/Identity.Web/Controllers/AccountController.cs b/src/Services/Identity/Identity.Web/Controllers/AccountController.cs index 43376c198..0e073e449 100644 --- a/src/Services/Identity/Identity.Web/Controllers/AccountController.cs +++ b/src/Services/Identity/Identity.Web/Controllers/AccountController.cs @@ -180,13 +180,20 @@ public async Task Logout(string? returnUrl = null, string? mode = await HttpContext.SignOutAsync(IdentityConstants.TwoFactorUserIdScheme); + var isSecureRequest = Request.IsHttps || + string.Equals( + Request.Headers["X-Forwarded-Proto"], + "https", + StringComparison.OrdinalIgnoreCase); + var cookieOptions = new CookieOptions { HttpOnly = true, SameSite = SameSiteMode.None, - Secure = Request.IsHttps, + Secure = true, Path = "/", - Expires = DateTimeOffset.UtcNow.AddYears(-1) + Expires = DateTimeOffset.UtcNow.AddYears(-1), + Domain = isSecureRequest ? Request.Host.Host : null }; Response.Cookies.Delete(".AspNetCore.Identity.Application", cookieOptions); From 6af3b72d0ffbafefba4fb6d727288eea548b30f4 Mon Sep 17 00:00:00 2001 From: meewaldor Date: Mon, 22 Dec 2025 15:13:16 +0700 Subject: [PATCH 11/29] Localize notifications in Vietnamese Updated notification messages in `CourseCompletedConsumer.cs` and `EnrollmentCreatedConsumer.cs` to provide localized titles and messages in Vietnamese, improving user experience for Vietnamese-speaking users. --- src/BuildingBlocks/Shared/Protos/Order/organization.proto | 1 + .../Notification.API/Consumers/CourseCompletedConsumer.cs | 6 +++--- .../Notification.API/Consumers/EnrollmentCreatedConsumer.cs | 6 +++--- .../GetOrganizationCurriculumListQueryHandler.cs | 3 ++- 4 files changed, 9 insertions(+), 7 deletions(-) diff --git a/src/BuildingBlocks/Shared/Protos/Order/organization.proto b/src/BuildingBlocks/Shared/Protos/Order/organization.proto index 6a893478c..7faee0fae 100644 --- a/src/BuildingBlocks/Shared/Protos/Order/organization.proto +++ b/src/BuildingBlocks/Shared/Protos/Order/organization.proto @@ -305,4 +305,5 @@ message CurriculumSubscriptionInfo { int32 subscriptionId = 1; string startDate = 2; string endDate = 3; + string planName = 4; } \ No newline at end of file diff --git a/src/Services/Notification/Notification.API/Consumers/CourseCompletedConsumer.cs b/src/Services/Notification/Notification.API/Consumers/CourseCompletedConsumer.cs index 58b47b5dc..41bc297d4 100644 --- a/src/Services/Notification/Notification.API/Consumers/CourseCompletedConsumer.cs +++ b/src/Services/Notification/Notification.API/Consumers/CourseCompletedConsumer.cs @@ -39,11 +39,11 @@ public async Task Consume(ConsumeContext context) var request = context.Message; var command = new CreateNotificationCommand { - Title = "Course Completed!", + Title = "Hoàn thành khóa học!", UserId = request.StudentId, Message = - $"Congratulations! You've successfully completed the course **{request.CourseTitle}**. \n" - + $"Take a moment to celebrate your achievement and explore what's next on your learning path.", + $"Chúc mừng bạn! Bạn đã hoàn thành khóa học **{request.CourseTitle}** thành công. \n" + + $"Bạn có thể xem chứng chỉ và khám phá những nội dung tiếp theo trong lộ trình học tập của bạn.", ClickUrl = $"/resource/course/{request.CourseId}", }; diff --git a/src/Services/Notification/Notification.API/Consumers/EnrollmentCreatedConsumer.cs b/src/Services/Notification/Notification.API/Consumers/EnrollmentCreatedConsumer.cs index 818a1f0b3..f11bb6ae8 100644 --- a/src/Services/Notification/Notification.API/Consumers/EnrollmentCreatedConsumer.cs +++ b/src/Services/Notification/Notification.API/Consumers/EnrollmentCreatedConsumer.cs @@ -44,11 +44,11 @@ public async Task Consume(ConsumeContext context) var request = context.Message; var command = new CreateNotificationCommand { - Title = "You’ve Enrolled in a New Course", + Title = "Bạn đã đăng ký khóa học mới", UserId = request.StudentId, Message = - $"Welcome to **{request.CourseTitle}**. \n" - + $"Start your learning journey now!", + $"Chào mừng bạn đến với khóa học **{request.CourseTitle}**. \n" + + $"Hãy bắt đầu hành trình học tập của bạn ngay bây giờ!", ClickUrl = $"/resource/course/{request.CourseId}", }; await _mediator.Send(command); diff --git a/src/Services/OrderService/Order.Application/Queries/OrganizationCurriculums/GetOrganizationCurriculumList/GetOrganizationCurriculumListQueryHandler.cs b/src/Services/OrderService/Order.Application/Queries/OrganizationCurriculums/GetOrganizationCurriculumList/GetOrganizationCurriculumListQueryHandler.cs index 85e875a65..a918457a3 100644 --- a/src/Services/OrderService/Order.Application/Queries/OrganizationCurriculums/GetOrganizationCurriculumList/GetOrganizationCurriculumListQueryHandler.cs +++ b/src/Services/OrderService/Order.Application/Queries/OrganizationCurriculums/GetOrganizationCurriculumList/GetOrganizationCurriculumListQueryHandler.cs @@ -109,7 +109,8 @@ public async Task Handle(GetOrganizationCurricul { SubscriptionId = x.Subscription.Id, StartDate = x.Subscription.StartDate.ToString("o"), - EndDate = x.Subscription.EndDate.ToString("o") + EndDate = x.Subscription.EndDate.ToString("o"), + PlanName = x.Subscription.PlanName ?? "Stemify Pro", }) ); From 3821301574d126b32c8fe8bf180df720b002e989 Mon Sep 17 00:00:00 2001 From: th3y3m Date: Mon, 22 Dec 2025 16:13:50 +0700 Subject: [PATCH 12/29] feat: Update GetSystemAdminDashboardQueryHandler --- .../Order.Application/Models/SystemAdminDashboardDto.cs | 1 + .../GetSystemAdminDashboardHandler.cs | 6 ++++++ 2 files changed, 7 insertions(+) diff --git a/src/Services/OrderService/Order.Application/Models/SystemAdminDashboardDto.cs b/src/Services/OrderService/Order.Application/Models/SystemAdminDashboardDto.cs index 9db9424a5..06d8875ad 100644 --- a/src/Services/OrderService/Order.Application/Models/SystemAdminDashboardDto.cs +++ b/src/Services/OrderService/Order.Application/Models/SystemAdminDashboardDto.cs @@ -9,6 +9,7 @@ public class SystemAdminAggregateData public int TotalTeachers { get; set; } public int TotalClassrooms { get; set; } public int TotalCertificates { get; set; } + public int TotalOrganizations { get; set; } public double OverallPassRate { get; set; } public SystemAdminSubscriptionStats SubscriptionStats { get; set; } public SystemAdminEnrollmentStats EnrollmentStats { get; set; } diff --git a/src/Services/OrderService/Order.Application/Queries/Admin/GetSystemAdminDashboard/GetSystemAdminDashboardHandler.cs b/src/Services/OrderService/Order.Application/Queries/Admin/GetSystemAdminDashboard/GetSystemAdminDashboardHandler.cs index c1dccc6b1..c249447de 100644 --- a/src/Services/OrderService/Order.Application/Queries/Admin/GetSystemAdminDashboard/GetSystemAdminDashboardHandler.cs +++ b/src/Services/OrderService/Order.Application/Queries/Admin/GetSystemAdminDashboard/GetSystemAdminDashboardHandler.cs @@ -117,6 +117,11 @@ private async Task GetSystemAdminStatistics( predicate: x => x.StartDate >= startOffset && x.StartDate < endOffset, cancellationToken: cancellationToken); + var organizations = await _unitOfWork.Organizations + .FindAsync( + predicate: x => x.CreatedDate >= startOffset && x.CreatedDate < endOffset, + cancellationToken: cancellationToken); + var subscriptionOrderIds = subscriptionOrders.Select(x => x.Id).ToList(); // Get license assignments @@ -210,6 +215,7 @@ private async Task GetSystemAdminStatistics( TotalTeachers = totalTeachers, TotalClassrooms = allClassrooms.Count, TotalCertificates = allCertificates.Count, + TotalOrganizations = organizations.Count, OverallPassRate = passRate, SubscriptionStats = subscriptionStats, EnrollmentStats = enrollmentStats, From fc8e0fa7de77127e1dde2e058a433b8b47040e23 Mon Sep 17 00:00:00 2001 From: th3y3m Date: Mon, 22 Dec 2025 16:19:02 +0700 Subject: [PATCH 13/29] Update GetSystemAdminDashboardHandler.cs --- .../GetSystemAdminDashboard/GetSystemAdminDashboardHandler.cs | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/src/Services/OrderService/Order.Application/Queries/Admin/GetSystemAdminDashboard/GetSystemAdminDashboardHandler.cs b/src/Services/OrderService/Order.Application/Queries/Admin/GetSystemAdminDashboard/GetSystemAdminDashboardHandler.cs index c249447de..27b4fcde2 100644 --- a/src/Services/OrderService/Order.Application/Queries/Admin/GetSystemAdminDashboard/GetSystemAdminDashboardHandler.cs +++ b/src/Services/OrderService/Order.Application/Queries/Admin/GetSystemAdminDashboard/GetSystemAdminDashboardHandler.cs @@ -136,13 +136,13 @@ private async Task GetSystemAdminStatistics( cancellationToken: cancellationToken); var totalStudents = licenseAssignments - .Where(x => x.LicenseType.ToString() == "Student" && x.Status.ToString() == "Active") + .Where(x => x.LicenseType.ToString() == "Student") .Select(x => x.OrganizationUserId) .Distinct() .Count(); var totalTeachers = licenseAssignments - .Where(x => x.LicenseType.ToString() == "Teacher" && x.Status.ToString() == "Active") + .Where(x => x.LicenseType.ToString() == "Teacher") .Select(x => x.OrganizationUserId) .Distinct() .Count(); From b8bbb5ccf3d7da61ae5140aad451c4464a2725c6 Mon Sep 17 00:00:00 2001 From: th3y3m Date: Mon, 22 Dec 2025 16:32:06 +0700 Subject: [PATCH 14/29] Update GetSystemAdminDashboardHandler.cs --- .../GetSystemAdminDashboard/GetSystemAdminDashboardHandler.cs | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/Services/OrderService/Order.Application/Queries/Admin/GetSystemAdminDashboard/GetSystemAdminDashboardHandler.cs b/src/Services/OrderService/Order.Application/Queries/Admin/GetSystemAdminDashboard/GetSystemAdminDashboardHandler.cs index 27b4fcde2..559b55c61 100644 --- a/src/Services/OrderService/Order.Application/Queries/Admin/GetSystemAdminDashboard/GetSystemAdminDashboardHandler.cs +++ b/src/Services/OrderService/Order.Application/Queries/Admin/GetSystemAdminDashboard/GetSystemAdminDashboardHandler.cs @@ -523,7 +523,7 @@ private PeriodComparisonModel CalculatePeriodComparison( EnrollmentGrowth = CalculatePercentageChange(current.TotalEnrollments, previous.TotalEnrollments), StudentGrowth = CalculatePercentageChange(current.TotalStudents, previous.TotalStudents), RevenueGrowth = CalculatePercentageChange((int)current.TotalRevenue, (int)previous.TotalRevenue), - OrganizationGrowth = 0 // Organizations don't change per period, need different calculation + OrganizationGrowth = CalculatePercentageChange(current.TotalOrganizations, previous.TotalOrganizations) }; } From e4e6818bfb50f51f5a84818f6d47de003f1bf7b0 Mon Sep 17 00:00:00 2001 From: halinhtvn3a <77691576+halinhtvn3a@users.noreply.github.com> Date: Mon, 22 Dec 2025 16:58:42 +0700 Subject: [PATCH 15/29] Update GetOrganizationUsersByOrganizationIdQueryHandler.cs --- ...zationUsersByOrganizationIdQueryHandler.cs | 37 +++++++++++-------- 1 file changed, 22 insertions(+), 15 deletions(-) diff --git a/src/Services/Identity/Identity.Application/Users/Queries/GetOrganizationUsersByOrganizationId/GetOrganizationUsersByOrganizationIdQueryHandler.cs b/src/Services/Identity/Identity.Application/Users/Queries/GetOrganizationUsersByOrganizationId/GetOrganizationUsersByOrganizationIdQueryHandler.cs index bb7e9d9fe..36a1d58c1 100644 --- a/src/Services/Identity/Identity.Application/Users/Queries/GetOrganizationUsersByOrganizationId/GetOrganizationUsersByOrganizationIdQueryHandler.cs +++ b/src/Services/Identity/Identity.Application/Users/Queries/GetOrganizationUsersByOrganizationId/GetOrganizationUsersByOrganizationIdQueryHandler.cs @@ -49,20 +49,21 @@ public async Task> Handle( try { - var (userIds, totalUniqueUsers) = await _organizationUserRepository.GetDistinctUserIdsByOrganizationAsync( + // Fetch all distinct user ids first so filters can be applied before paging + var (allUserIds, totalDistinctUsers) = await _organizationUserRepository.GetDistinctUserIdsByOrganizationAsync( request.OrganizationId, request.ActiveOnly, - request.PageNumber, - request.PageSize, + pageNumber: 1, + pageSize: int.MaxValue, cancellationToken); _logger.LogInformation( "Retrieved {UserCount} distinct user IDs for organization {OrganizationId}. Total unique users: {TotalUniqueUsers}", - userIds.Count, + allUserIds.Count, request.OrganizationId, - totalUniqueUsers); + totalDistinctUsers); - if (userIds.Count == 0) + if (allUserIds.Count == 0) { _logger.LogInformation( "No users found for organization {OrganizationId} with ActiveOnly={ActiveOnly}. Returning empty result.", @@ -70,21 +71,21 @@ public async Task> Handle( request.ActiveOnly); return new PagedResult( Enumerable.Empty(), - totalUniqueUsers, + 0, request.PageNumber, request.PageSize); } var organizationUsers = await _organizationUserRepository.GetSubscriptionsForUsersAsync( request.OrganizationId, - userIds, + allUserIds, request.ActiveOnly, cancellationToken); _logger.LogInformation( "Retrieved {OrgUserCount} organization users for {UserCount} users in organization {OrganizationId}", organizationUsers.Count, - userIds.Count, + allUserIds.Count, request.OrganizationId); if (!string.IsNullOrWhiteSpace(request.Role)) @@ -154,7 +155,7 @@ public async Task> Handle( var groupId = request.GroupId.Value; var beforeCount = organizationUsers.Count; organizationUsers = organizationUsers - .Where(ou => ou.GroupId == groupId) + .Where(ou => groupId == 0 ? ou.GroupId == null : ou.GroupId == groupId) .ToList(); _logger.LogInformation( @@ -310,17 +311,23 @@ public async Task> Handle( .ThenBy(u => u.Email) .ToList(); + var filteredTotalUsers = groupedByUser.Count; + var pagedUsers = groupedByUser + .Skip((request.PageNumber - 1) * request.PageSize) + .Take(request.PageSize) + .ToList(); + _logger.LogInformation( - "Successfully processed query for organization {OrganizationId}. Returning {ResultCount} users (grouped), TotalUniqueUsers: {TotalUniqueUsers}, PageNumber: {PageNumber}, PageSize: {PageSize}", + "Successfully processed query for organization {OrganizationId}. Returning {ResultCount} users (grouped) after paging, FilteredTotalUsers: {FilteredTotalUsers}, PageNumber: {PageNumber}, PageSize: {PageSize}", request.OrganizationId, - groupedByUser.Count, - totalUniqueUsers, + pagedUsers.Count, + filteredTotalUsers, request.PageNumber, request.PageSize); return new PagedResult( - groupedByUser, - totalUniqueUsers, + pagedUsers, + filteredTotalUsers, request.PageNumber, request.PageSize); } From 52623cc4df355c42d6c234f2099f8302be03a30a Mon Sep 17 00:00:00 2001 From: meewaldor Date: Mon, 22 Dec 2025 17:57:46 +0700 Subject: [PATCH 16/29] Add namespaces and localize error message in handler Changed the error message for non-unique group codes from English to Vietnamese to support localization efforts. --- .../Groups/Commands/CreateGroup/CreateGroupCommandHandler.cs | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/src/Services/Identity/Identity.Application/Groups/Commands/CreateGroup/CreateGroupCommandHandler.cs b/src/Services/Identity/Identity.Application/Groups/Commands/CreateGroup/CreateGroupCommandHandler.cs index 891ced837..0a6a40cc3 100644 --- a/src/Services/Identity/Identity.Application/Groups/Commands/CreateGroup/CreateGroupCommandHandler.cs +++ b/src/Services/Identity/Identity.Application/Groups/Commands/CreateGroup/CreateGroupCommandHandler.cs @@ -1,4 +1,4 @@ -using Identity.Application.Common.Interfaces; +using Identity.Application.Common.Interfaces; using Identity.Application.Common.Interfaces.Repositories; using Identity.Application.Groups.Dtos; using Identity.Domain.Entities; @@ -41,7 +41,7 @@ public async Task Handle( cancellationToken: cancellationToken); if (!isCodeUnique) - throw new InvalidOperationException($"Group code '{request.Code}' already exists in this organization"); + throw new InvalidOperationException($"Mã nhóm '{request.Code}' đã tồn tại trong tổ chức"); } var group = Group.CreateWithCode( From 122858f06d385c80bc2be0a37839ec260a627679 Mon Sep 17 00:00:00 2001 From: meewaldor Date: Mon, 22 Dec 2025 18:05:20 +0700 Subject: [PATCH 17/29] Update correct answer for QuestionId 39 MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Changed the correct answer's `QuestionId` from 19 to 39. Updated the content from "Science – Technology – Engineering – Mathematics" to "Science – Teaching – English – Math" to reflect the new subject matter. --- .../Resource.Infrastructure/Helpers/SeedData/answerData.json | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/Services/Resource/Resource.Infrastructure/Helpers/SeedData/answerData.json b/src/Services/Resource/Resource.Infrastructure/Helpers/SeedData/answerData.json index 2d009409a..bbbb6e752 100644 --- a/src/Services/Resource/Resource.Infrastructure/Helpers/SeedData/answerData.json +++ b/src/Services/Resource/Resource.Infrastructure/Helpers/SeedData/answerData.json @@ -797,7 +797,7 @@ { "Content": "Science – Technology – Engineering – Mathematics", "IsCorrect": true, - "QuestionId": 19 + "QuestionId": 39 }, { From cdd9baba534f452f83b1ad65bc9cbdc7c9bec289 Mon Sep 17 00:00:00 2001 From: th3y3m Date: Mon, 22 Dec 2025 19:06:40 +0700 Subject: [PATCH 18/29] feat: Add cancel organization subscription order feature Introduces the ability to cancel organization subscription orders via gRPC and application command. Adds new proto definitions, command, command handler, and event for handling cancellation, including revoking active license assignments and publishing a cancellation event. --- .../SubscriptionCancelledEvent.cs | 9 ++ .../organization_subscription_order.proto | 11 +++ .../SubscriptionCancelledEventConsumer.cs | 59 ++++++++++++ .../DependencyInjection.cs | 15 +++ ...rganizationSubscriptionOrderGrpcService.cs | 15 +++ ...celOrganizationSubscriptionOrderCommand.cs | 21 +++++ ...nizationSubscriptionOrderCommandHandler.cs | 91 +++++++++++++++++++ 7 files changed, 221 insertions(+) create mode 100644 src/BuildingBlocks/EventBus.Messages/Subscription/SubscriptionCancelledEvent.cs create mode 100644 src/Services/Identity/Identity.Infrastructure/BackgroundServices/Consumers/SubscriptionCancelledEventConsumer.cs create mode 100644 src/Services/OrderService/Order.Application/Commands/OrganizationSubscriptionOrders/CancelOrganizationSubscriptionOrder/CancelOrganizationSubscriptionOrderCommand.cs create mode 100644 src/Services/OrderService/Order.Application/Commands/OrganizationSubscriptionOrders/CancelOrganizationSubscriptionOrder/CancelOrganizationSubscriptionOrderCommandHandler.cs diff --git a/src/BuildingBlocks/EventBus.Messages/Subscription/SubscriptionCancelledEvent.cs b/src/BuildingBlocks/EventBus.Messages/Subscription/SubscriptionCancelledEvent.cs new file mode 100644 index 000000000..4cbc6b549 --- /dev/null +++ b/src/BuildingBlocks/EventBus.Messages/Subscription/SubscriptionCancelledEvent.cs @@ -0,0 +1,9 @@ +using Contracts.Domains; + +namespace EventBus.Messages.Subscription; + +public record SubscriptionCancelledEvent : DomainEvent +{ + public List LicenseAssignmentIds { get; set; } = new(); +} + diff --git a/src/BuildingBlocks/Shared/Protos/Order/organization_subscription_order.proto b/src/BuildingBlocks/Shared/Protos/Order/organization_subscription_order.proto index d8f3202f0..45008ff75 100644 --- a/src/BuildingBlocks/Shared/Protos/Order/organization_subscription_order.proto +++ b/src/BuildingBlocks/Shared/Protos/Order/organization_subscription_order.proto @@ -33,6 +33,13 @@ service GrpcOrganizationSubscriptionOrderService { }; } + rpc CancelOrganizationSubscriptionOrder (CancelOrganizationSubscriptionOrderRequest) returns (google.protobuf.Empty) { + option (google.api.http) = { + post: "/api/organization-subscription-orders/{id}/cancel" + body: "*" + }; + } + rpc GetOrganizationSubscriptionOrderById (GetOrganizationSubscriptionOrderRequest) returns (GrpcOrganizationSubscriptionOrderDetail) { option (google.api.http) = { get: "/api/organization-subscription-orders/{id}" @@ -80,6 +87,10 @@ message DeleteOrganizationSubscriptionOrderRequest { int32 id = 1; } +message CancelOrganizationSubscriptionOrderRequest { + int32 id = 1; +} + message GetOrganizationSubscriptionOrderRequest { int32 id = 1; } diff --git a/src/Services/Identity/Identity.Infrastructure/BackgroundServices/Consumers/SubscriptionCancelledEventConsumer.cs b/src/Services/Identity/Identity.Infrastructure/BackgroundServices/Consumers/SubscriptionCancelledEventConsumer.cs new file mode 100644 index 000000000..b0f3ebe89 --- /dev/null +++ b/src/Services/Identity/Identity.Infrastructure/BackgroundServices/Consumers/SubscriptionCancelledEventConsumer.cs @@ -0,0 +1,59 @@ +using EventBus.Messages.Subscription; +using Identity.Application.Common.Interfaces.Services; +using MassTransit; +using Microsoft.Extensions.Logging; + +namespace Identity.Infrastructure.BackgroundServices.Consumers; + +/// +/// Consumer that handles subscription cancelled events +/// Marks related license projections as revoked +/// +public class SubscriptionCancelledEventConsumer : IConsumer +{ + private readonly ILogger _logger; + private readonly IOrganizationUserLicenseProjectionService _licenseProjectionService; + + public SubscriptionCancelledEventConsumer( + IOrganizationUserLicenseProjectionService licenseProjectionService, + ILogger logger) + { + _logger = logger; + _licenseProjectionService = licenseProjectionService; + } + + public async Task Consume(ConsumeContext context) + { + var @event = context.Message; + + _logger.LogInformation( + "Processing SubscriptionCancelledEvent for SubscriptionId: LicenseAssignmentCount: {Count}", + @event.LicenseAssignmentIds?.Count ?? 0); + + if (@event.LicenseAssignmentIds == null || !@event.LicenseAssignmentIds.Any()) + { + _logger.LogInformation("No license assignments found in SubscriptionCancelledEvent for Subscription"); + return; + } + + var distinctIds = @event.LicenseAssignmentIds + .Where(id => id > 0) + .Distinct() + .ToList(); + + foreach (var licenseAssignmentId in distinctIds) + { + await _licenseProjectionService.ApplyLicenseRevokedAsync( + licenseAssignmentId, + context.CancellationToken); + + _logger.LogDebug( + "Applied revocation to projection for LicenseAssignmentId {LicenseAssignmentId}", + licenseAssignmentId); + } + + _logger.LogInformation( + "Completed processing SubscriptionCancelledEvent for Subscription: revoked {Count} license assignments", + distinctIds.Count); + } +} \ No newline at end of file diff --git a/src/Services/Identity/Identity.Infrastructure/DependencyInjection.cs b/src/Services/Identity/Identity.Infrastructure/DependencyInjection.cs index fdf7f2f69..b17c23cca 100644 --- a/src/Services/Identity/Identity.Infrastructure/DependencyInjection.cs +++ b/src/Services/Identity/Identity.Infrastructure/DependencyInjection.cs @@ -335,6 +335,7 @@ private static void AddMassTransitConfiguration( x.AddConsumer(); x.AddConsumer(); x.AddConsumer(); + x.AddConsumer(); } x.AddEntityFrameworkOutbox(o => @@ -473,6 +474,20 @@ private static void AddMassTransitConfiguration( e.PrefetchCount = 20; e.ConcurrentMessageLimit = 10; }); + + cfg.ReceiveEndpoint("subscription-deleted", e => + { + e.ConfigureConsumer(context); + + e.UseMessageRetry(r => r.Exponential( + retryLimit: 3, + minInterval: TimeSpan.FromSeconds(1), + maxInterval: TimeSpan.FromSeconds(10), + intervalDelta: TimeSpan.FromSeconds(1))); + + e.PrefetchCount = 20; + e.ConcurrentMessageLimit = 10; + }); } // Global retry diff --git a/src/Services/OrderService/Order.API/Services/OrganizationSubscriptionOrderGrpcService.cs b/src/Services/OrderService/Order.API/Services/OrganizationSubscriptionOrderGrpcService.cs index 1f29e0763..ae30f45ba 100644 --- a/src/Services/OrderService/Order.API/Services/OrganizationSubscriptionOrderGrpcService.cs +++ b/src/Services/OrderService/Order.API/Services/OrganizationSubscriptionOrderGrpcService.cs @@ -1,6 +1,7 @@ using Google.Protobuf.WellKnownTypes; using Grpc.Core; using MediatR; +using Order.Application.Commands.OrganizationSubscriptionOrders.CancelOrganizationSubscriptionOrder; using Order.Application.Commands.OrganizationSubscriptionOrders.CreateOrganizationSubscriptionOrder; using Order.Application.Commands.OrganizationSubscriptionOrders.DeleteOrganizationSubscriptionOrder; using Order.Application.Commands.OrganizationSubscriptionOrders.UpdateOrganizationSubscriptionOrder; @@ -68,6 +69,20 @@ ServerCallContext context return result; } + public override async Task CancelOrganizationSubscriptionOrder( + CancelOrganizationSubscriptionOrderRequest request, + ServerCallContext context + ) + { + var command = new CancelOrganizationSubscriptionOrderCommand + { + Id = request.Id + }; + await _mediator.Send(command); + + return new Empty(); + } + public override async Task UpdateOrganizationSubscriptionOrder( UpdateOrganizationSubscriptionOrderRequest request, ServerCallContext context diff --git a/src/Services/OrderService/Order.Application/Commands/OrganizationSubscriptionOrders/CancelOrganizationSubscriptionOrder/CancelOrganizationSubscriptionOrderCommand.cs b/src/Services/OrderService/Order.Application/Commands/OrganizationSubscriptionOrders/CancelOrganizationSubscriptionOrder/CancelOrganizationSubscriptionOrderCommand.cs new file mode 100644 index 000000000..54078a87d --- /dev/null +++ b/src/Services/OrderService/Order.Application/Commands/OrganizationSubscriptionOrders/CancelOrganizationSubscriptionOrder/CancelOrganizationSubscriptionOrderCommand.cs @@ -0,0 +1,21 @@ +using FluentValidation; +using MediatR; + +namespace Order.Application.Commands.OrganizationSubscriptionOrders.CancelOrganizationSubscriptionOrder +{ + public class CancelOrganizationSubscriptionOrderCommand : IRequest + { + public int Id { get; set; } + } + + + public class CancelOrganizationSubscriptionOrderCommandValidator : AbstractValidator + { + public CancelOrganizationSubscriptionOrderCommandValidator() + { + RuleFor(x => x.Id) + .GreaterThan(0) + .WithMessage("Subscription ID must be greater than 0."); + } + } +} diff --git a/src/Services/OrderService/Order.Application/Commands/OrganizationSubscriptionOrders/CancelOrganizationSubscriptionOrder/CancelOrganizationSubscriptionOrderCommandHandler.cs b/src/Services/OrderService/Order.Application/Commands/OrganizationSubscriptionOrders/CancelOrganizationSubscriptionOrder/CancelOrganizationSubscriptionOrderCommandHandler.cs new file mode 100644 index 000000000..1d6e52083 --- /dev/null +++ b/src/Services/OrderService/Order.Application/Commands/OrganizationSubscriptionOrders/CancelOrganizationSubscriptionOrder/CancelOrganizationSubscriptionOrderCommandHandler.cs @@ -0,0 +1,91 @@ +using EventBus.Messages.Subscription; +using MassTransit; +using MediatR; +using Microsoft.Extensions.Logging; +using Order.Application.Common.Interfaces; +using Order.Domain.Enums; + +namespace Order.Application.Commands.OrganizationSubscriptionOrders.CancelOrganizationSubscriptionOrder +{ + public class CancelOrganizationSubscriptionOrderCommandHandler : IRequestHandler + { + private readonly IOrderUnitOfWork _unitOfWork; + private readonly IPublishEndpoint _publishEndpoint; + private readonly ILogger _logger; + + public CancelOrganizationSubscriptionOrderCommandHandler( + IOrderUnitOfWork unitOfWork, + IPublishEndpoint publishEndpoint, + ILogger logger) + { + _unitOfWork = unitOfWork; + _publishEndpoint = publishEndpoint; + _logger = logger; + } + + public async Task Handle(CancelOrganizationSubscriptionOrderCommand request, CancellationToken cancellationToken) + { + _logger.LogInformation("Starting cancellation for OrganizationSubscriptionOrder {OrderId}", request.Id); + + var organizationSubscriptionOrder = await _unitOfWork.OrganizationSubscriptionOrders.FindByIdAsync( + request.Id, + cancellationToken + ); + + if (organizationSubscriptionOrder == null) + { + _logger.LogWarning("OrganizationSubscriptionOrder with ID {OrderId} not found", request.Id); + throw new KeyNotFoundException($"OrganizationSubscriptionOrder with ID {request.Id} not found."); + } + + // Update in-memory; rely on unit of work SaveChanges for a single DB round-trip. + organizationSubscriptionOrder.Status = OrganizationSubscriptionOrderStatus.Cancelled; + organizationSubscriptionOrder.LastModifiedDate = DateTimeOffset.UtcNow; + + // Load active license assignments for the subscription. + var licenseAssignments = (await _unitOfWork.LicenseAssignments.FindAsync( + predicate: la => la.OrganizationSubscriptionOrderId == organizationSubscriptionOrder.Id + && la.Status != LicenseAssignmentStatus.Revoked + && la.Status != LicenseAssignmentStatus.Expired, + cancellationToken: cancellationToken + )).ToList(); + + if (licenseAssignments.Count == 0) + { + _logger.LogInformation("No active license assignments found for subscription {OrderId}", organizationSubscriptionOrder.Id); + } + else + { + foreach (var la in licenseAssignments) + { + la.Status = LicenseAssignmentStatus.Revoked; + la.RevokedAt = DateTime.UtcNow; + } + + _logger.LogInformation("Marked {Count} license assignments as Revoked for subscription {OrderId}", + licenseAssignments.Count, organizationSubscriptionOrder.Id); + } + + // Persist all changes in one SaveChanges call to reduce round-trips. + var saved = await _unitOfWork.SaveChangesAsync(cancellationToken); + if (saved <= 0) + { + _logger.LogWarning("No changes were saved when cancelling subscription {OrderId}", organizationSubscriptionOrder.Id); + return false; + } + + // Publish event after persistence to avoid publishing before DB commit. + var @event = new SubscriptionCancelledEvent + { + LicenseAssignmentIds = licenseAssignments.Select(la => la.Id).ToList(), + }; + + await _publishEndpoint.Publish(@event, cancellationToken); + + _logger.LogInformation("Published SubscriptionCancelledEvent for subscription {OrderId} with {Count} license assignments", + organizationSubscriptionOrder.Id, @event.LicenseAssignmentIds.Count); + + return true; + } + } +} \ No newline at end of file From 46c7a377866c4ccb14b84e19c26e9dc8604d91f1 Mon Sep 17 00:00:00 2001 From: th3y3m Date: Mon, 22 Dec 2025 19:53:55 +0700 Subject: [PATCH 19/29] Update PdfService.cs --- .../Abstractions/Services/PdfLayer/PdfService.cs | 4 +--- 1 file changed, 1 insertion(+), 3 deletions(-) diff --git a/src/BuildingBlocks/Infrastructure/Abstractions/Services/PdfLayer/PdfService.cs b/src/BuildingBlocks/Infrastructure/Abstractions/Services/PdfLayer/PdfService.cs index ef454158b..d6224dd6f 100644 --- a/src/BuildingBlocks/Infrastructure/Abstractions/Services/PdfLayer/PdfService.cs +++ b/src/BuildingBlocks/Infrastructure/Abstractions/Services/PdfLayer/PdfService.cs @@ -1,14 +1,12 @@ using Contracts.Abstractions.Services; using Microsoft.Extensions.Configuration; -using System; -using System.Threading.Tasks; namespace Infrastructure.Abstractions.Services.PdfLayer { public class PdfService(HttpClient httpClient, IConfiguration configuration) : IPdfService { private readonly HttpClient _httpClient = httpClient; - private readonly string _apiKey = configuration["Pdflayer:ApiKey"] ?? throw new ArgumentNullException("pdflayer:ApiKey"); + private readonly string _apiKey = configuration["Pdflayer:ApiKey"] ?? throw new ArgumentNullException("Pdflayer:ApiKey"); public async Task ConvertHtmlToPdfAsync(string htmlContent) { From 31d71b96390237d5d923f6b8e5ee4894470cb571 Mon Sep 17 00:00:00 2001 From: meewaldor Date: Mon, 22 Dec 2025 20:21:17 +0700 Subject: [PATCH 20/29] Update docker-compose.yml for environment variables Removed OTEL_RESOURCE_ATTRIBUTES and added Pdflayer__ApiKey. Retained existing API keys and adjusted port formatting. Commented out depends_on section and set restart policy to unless-stopped. --- docker-compose.yml | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/docker-compose.yml b/docker-compose.yml index 94095414e..34123859c 100644 --- a/docker-compose.yml +++ b/docker-compose.yml @@ -79,6 +79,7 @@ services: - Cloudinary__CloudName=${CLOUDINARY_CLOUD_NAME} - Cloudinary__ApiKey=${CLOUDINARY_API_KEY} - Cloudinary__ApiSecret=${CLOUDINARY_API_SECRET} + - Pdflayer__ApiKey=e4a39484d4c94acacd0da61ba5970b09 ports: - 7001:80 - 5001:5001 @@ -608,7 +609,7 @@ services: - DEEPSEEK_API_KEY=${DEEPSEEK_API_KEY} - RESOURCE_GRPC_CERT_PATH=${RESOURCE_GRPC_CERT_PATH} ports: - - '7010:80' + - '7010:80' - '5010:5010' # gRPC # depends_on: # - qdrant From c7cf429adaa9eed015a337396f2d3aba57731571 Mon Sep 17 00:00:00 2001 From: th3y3m Date: Mon, 22 Dec 2025 20:55:58 +0700 Subject: [PATCH 21/29] Update CreateCertificateCommandHandler.cs --- .../CreateCertificate/CreateCertificateCommandHandler.cs | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/src/Services/ClassroomService/Classroom.Application/Features/Certificates/Commands/CreateCertificate/CreateCertificateCommandHandler.cs b/src/Services/ClassroomService/Classroom.Application/Features/Certificates/Commands/CreateCertificate/CreateCertificateCommandHandler.cs index d21244115..bee9b1034 100644 --- a/src/Services/ClassroomService/Classroom.Application/Features/Certificates/Commands/CreateCertificate/CreateCertificateCommandHandler.cs +++ b/src/Services/ClassroomService/Classroom.Application/Features/Certificates/Commands/CreateCertificate/CreateCertificateCommandHandler.cs @@ -52,7 +52,7 @@ CancellationToken cancellationToken string code; string description; - var user = await _userClient.GetOrganizationUserByIdAsync(Guid.Parse(request.UserId), cancellationToken); + var user = await _userClient.GetUserByIdAsync(Guid.Parse(request.UserId)); if (user == null) throw new ArgumentException("User not found."); @@ -106,7 +106,7 @@ CancellationToken cancellationToken var certificate = new Domain.Entities.Certificate { UserId = Guid.Parse(request.UserId), - UserName = user.FullName, + UserName = user.Name, Title = certificateName, VerificationCode = verificationCode, CertificateType = request.CertificateType, @@ -159,7 +159,7 @@ await _publishEndpoint.Publish( new CertificateCreatedEvent { StudentId = user.UserId, - Name = user?.FullName ?? "Unknown Student", + Name = user?.Name ?? "Unknown Student", Email = user?.Email ?? string.Empty, CertificateTitile = certificate.Title, CertificateUrl = certificate.CertificateUrl, From 4f5af3899cd07f8a1af5cb4a5426c4ecadc7c675 Mon Sep 17 00:00:00 2001 From: th3y3m Date: Mon, 22 Dec 2025 23:01:09 +0700 Subject: [PATCH 22/29] Update CertificateCreatedEvent.cs --- .../Notification.API/Consumers/CertificateCreatedEvent.cs | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/src/Services/Notification/Notification.API/Consumers/CertificateCreatedEvent.cs b/src/Services/Notification/Notification.API/Consumers/CertificateCreatedEvent.cs index 732df45fd..2bd693363 100644 --- a/src/Services/Notification/Notification.API/Consumers/CertificateCreatedEvent.cs +++ b/src/Services/Notification/Notification.API/Consumers/CertificateCreatedEvent.cs @@ -35,9 +35,9 @@ public async Task Consume(ConsumeContext context) var request = context.Message; var command = new CreateNotificationCommand { - Title = "New Certificate Available", + Title = "Chứng chỉ mới đã sẵn sàng", UserId = request.StudentId, - Message = $"Congratulations {request.Name}! Your certificate '{request.CertificateTitile}' is now available. You can view it here: {request.CertificateUrl}", + Message = $"Chúc mừng {request.Name}! Chứng chỉ '{request.CertificateTitile}' của bạn đã sẵn sàng.", ClickUrl = $"/verify/{request.Code}", }; From 4ad4e41fd2b9f719cbe2e6061b8c54d096de9afa Mon Sep 17 00:00:00 2001 From: th3y3m Date: Mon, 22 Dec 2025 23:26:34 +0700 Subject: [PATCH 23/29] Update GetCertificateByIdQueryHandler.cs --- .../GetCertificateById/GetCertificateByIdQueryHandler.cs | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/Services/ClassroomService/Classroom.Application/Features/Certificates/Queries/GetCertificateById/GetCertificateByIdQueryHandler.cs b/src/Services/ClassroomService/Classroom.Application/Features/Certificates/Queries/GetCertificateById/GetCertificateByIdQueryHandler.cs index c93e4fb77..2ebbdac86 100644 --- a/src/Services/ClassroomService/Classroom.Application/Features/Certificates/Queries/GetCertificateById/GetCertificateByIdQueryHandler.cs +++ b/src/Services/ClassroomService/Classroom.Application/Features/Certificates/Queries/GetCertificateById/GetCertificateByIdQueryHandler.cs @@ -39,7 +39,7 @@ CancellationToken cancellationToken throw new NotFoundException($"Certificate with ID {request.Id} not found."); } - var student = await _userClient.GetOrganizationUserByIdAsync(certificate.UserId, cancellationToken); + var student = await _userClient.GetUserByIdAsync(certificate.UserId); if (student == null) throw new ArgumentException("Student not found."); From 5b80047d4745f72fd09dd2ddcaa32f91c802d05a Mon Sep 17 00:00:00 2001 From: th3y3m Date: Tue, 23 Dec 2025 01:10:02 +0700 Subject: [PATCH 24/29] Update GetOrganizationDashboardQueryHandler.cs --- .../GetOrganizationDashboardQueryHandler.cs | 33 ++++++++----------- 1 file changed, 13 insertions(+), 20 deletions(-) diff --git a/src/Services/OrderService/Order.Application/Queries/Organizations/GetOrganizationDashboard/GetOrganizationDashboardQueryHandler.cs b/src/Services/OrderService/Order.Application/Queries/Organizations/GetOrganizationDashboard/GetOrganizationDashboardQueryHandler.cs index a1ffc2ec9..8d52b34f3 100644 --- a/src/Services/OrderService/Order.Application/Queries/Organizations/GetOrganizationDashboard/GetOrganizationDashboardQueryHandler.cs +++ b/src/Services/OrderService/Order.Application/Queries/Organizations/GetOrganizationDashboard/GetOrganizationDashboardQueryHandler.cs @@ -16,7 +16,7 @@ public class GetOrganizationDashboardQueryHandler private readonly IGrpcCurriculumEnrollmentClient _curriculumEnrollmentClient; private readonly IGrpcCourseEnrollmentClient _courseEnrollmentClient; private readonly IGrpcCertificateClient _certificateClient; - private readonly ICurriculumCacheService _curriculumCacheService; + private readonly IGrpcCurriculumClient _curriculumClient; private readonly IGrpcQuizAttemptClient _grpcQuizAttemptClient; private readonly IGrpcAssignmentAttemptClient _assignmentAttemptClient; @@ -24,7 +24,7 @@ public GetOrganizationDashboardQueryHandler( IOrderUnitOfWork unitOfWork, IGrpcCurriculumEnrollmentClient curriculumEnrollmentClient, IGrpcCertificateClient certificateClient, - ICurriculumCacheService curriculumCacheService, + IGrpcCurriculumClient curriculumClient, IGrpcQuizAttemptClient grpcQuizAttemptClient, IGrpcCourseEnrollmentClient courseEnrollmentClient, IGrpcAssignmentAttemptClient assignmentAttemptClient, @@ -34,7 +34,7 @@ public GetOrganizationDashboardQueryHandler( _classroomClient = classroomClient; _curriculumEnrollmentClient = curriculumEnrollmentClient; _certificateClient = certificateClient; - _curriculumCacheService = curriculumCacheService; + _curriculumClient = curriculumClient; _grpcQuizAttemptClient = grpcQuizAttemptClient; _courseEnrollmentClient = courseEnrollmentClient; _assignmentAttemptClient = assignmentAttemptClient; @@ -190,19 +190,19 @@ CancellationToken cancellationToken ); var totalStudents = licenseAssignments - .Where(x => x.LicenseType.ToString() == "Student" && x.Status.ToString() == "Active") + .Where(x => x.LicenseType.ToString() == "Student") .Select(x => x.OrganizationUserId) .Distinct() .Count(); var totalTeachers = licenseAssignments - .Where(x => x.LicenseType.ToString() == "Teacher" && x.Status.ToString() == "Active") + .Where(x => x.LicenseType.ToString() == "Teacher") .Select(x => x.OrganizationUserId) .Distinct() .Count(); var totalUsers = licenseAssignments - .Where(x => x.Status.ToString() == "Active") + //.Where(x => x.Status.ToString() == "Active") .Select(x => x.OrganizationUserId) .Distinct() .Count(); @@ -247,7 +247,7 @@ CancellationToken cancellationToken { PageNumber = 1, PageSize = 1000, - CurriculumEnrollmentId = enrollmentId + CourseEnrollmentId = enrollmentId }; var certificatesResponse = await _certificateClient.GetPagedCertificates(certificatesRequest); @@ -311,13 +311,13 @@ CancellationToken cancellationToken foreach (var curriculumId in distinctCurriculumIds) { - var ordersContainingCurriculum = subscriptionOrders - .Where(o => o.SubscriptionOrderCurriculums != null && o.SubscriptionOrderCurriculums.Any(sc => sc.CurriculumId == curriculumId)) - .ToList(); + var curriculum = await _curriculumClient.GetCurriculumByIdAsync( + curriculumId + ); var allEnrollmentsForCurriculum = new List(); - foreach (var order in ordersContainingCurriculum) + foreach (var course in curriculum.Courses) { var getClassroomsRequest = new GetClassroomsRequest { @@ -325,7 +325,7 @@ CancellationToken cancellationToken PageSize = 1000, FromDate = Google.Protobuf.WellKnownTypes.Timestamp.FromDateTime(periodStart.ToUniversalTime()), ToDate = Google.Protobuf.WellKnownTypes.Timestamp.FromDateTime(periodEnd.ToUniversalTime()), - OrganizationSubscriptionOrderId = order.Id + CourseId = course.Id }; var classroomsResponse = await _classroomClient.GetPagedClassrooms(getClassroomsRequest); @@ -352,17 +352,10 @@ CancellationToken cancellationToken ? (double)completedCount / allEnrollmentsForCurriculum.Count() * 100 : 0; - var curriculum = await _curriculumCacheService.GetCurriculumByIdAsync( - curriculumId, - cancellationToken - ); - - var titleFallback = ordersContainingCurriculum.FirstOrDefault()?.PlanName ?? string.Empty; - stats.Add(new CurriculumStatisticModel { Id = curriculumId, - Title = curriculum?.Title ?? titleFallback, + Title = curriculum?.Title ?? "Unknown", ImageUrl = curriculum?.ImageUrl ?? string.Empty, CourseCount = curriculum?.CourseCount ?? 0, PassRate = passRate, From 56052e013860639d20266725bb7e074e4a676970 Mon Sep 17 00:00:00 2001 From: th3y3m Date: Tue, 23 Dec 2025 01:30:36 +0700 Subject: [PATCH 25/29] feat: Include lesson title in course certificate --- .../Protos/Classroom/certificates.proto | 17 ++++++- .../Services/CertificateGrpcService.cs | 2 +- .../GetCertificateByIdQuery.cs | 2 +- .../GetCertificateByIdQueryHandler.cs | 49 ++++++++++--------- 4 files changed, 43 insertions(+), 27 deletions(-) diff --git a/src/BuildingBlocks/Shared/Protos/Classroom/certificates.proto b/src/BuildingBlocks/Shared/Protos/Classroom/certificates.proto index 505bedfd8..43dbb1071 100644 --- a/src/BuildingBlocks/Shared/Protos/Classroom/certificates.proto +++ b/src/BuildingBlocks/Shared/Protos/Classroom/certificates.proto @@ -22,7 +22,7 @@ service GrpcCertificate { // }; // } - rpc GetCertificateById (GetCertificateRequest) returns (GrpcCertificateResponse) { + rpc GetCertificateById (GetCertificateRequest) returns (GrpcCertificateDetail) { option (google.api.http) = { get: "/api/certificates/{id}" }; @@ -91,6 +91,21 @@ message GrpcCertificateModel { google.protobuf.Timestamp completedAt = 11; } +message GrpcCertificateDetail { + int32 id = 1; + string userId = 2; + google.protobuf.Int32Value courseEnrollmentId = 3; + google.protobuf.Int32Value curriculumEnrollmentId = 4; + string certificateType = 5; + google.protobuf.Timestamp issueDate = 6; + string verificationCode = 7; + string certificateUrl = 8; + google.protobuf.StringValue userName = 9; + google.protobuf.StringValue title = 10; + google.protobuf.Timestamp completedAt = 11; + repeated string lessons = 12; +} + enum CertificateType { UNKNOWN = 0; COURSE = 1; diff --git a/src/Services/ClassroomService/Classroom.API/Services/CertificateGrpcService.cs b/src/Services/ClassroomService/Classroom.API/Services/CertificateGrpcService.cs index b24558c28..7b46ef72b 100644 --- a/src/Services/ClassroomService/Classroom.API/Services/CertificateGrpcService.cs +++ b/src/Services/ClassroomService/Classroom.API/Services/CertificateGrpcService.cs @@ -41,7 +41,7 @@ public CertificateGrpcService(IMediator mediator) // } //} - public override async Task GetCertificateById( + public override async Task GetCertificateById( GetCertificateRequest request, ServerCallContext context ) diff --git a/src/Services/ClassroomService/Classroom.Application/Features/Certificates/Queries/GetCertificateById/GetCertificateByIdQuery.cs b/src/Services/ClassroomService/Classroom.Application/Features/Certificates/Queries/GetCertificateById/GetCertificateByIdQuery.cs index 44f3f4e1f..cf0ef600b 100644 --- a/src/Services/ClassroomService/Classroom.Application/Features/Certificates/Queries/GetCertificateById/GetCertificateByIdQuery.cs +++ b/src/Services/ClassroomService/Classroom.Application/Features/Certificates/Queries/GetCertificateById/GetCertificateByIdQuery.cs @@ -3,7 +3,7 @@ namespace Classroom.Application.Features.Certificates.Queries.GetCertificateById { - public class GetCertificateByIdQuery(int id) : IRequest + public class GetCertificateByIdQuery(int id) : IRequest { public int Id { get; } = id; } diff --git a/src/Services/ClassroomService/Classroom.Application/Features/Certificates/Queries/GetCertificateById/GetCertificateByIdQueryHandler.cs b/src/Services/ClassroomService/Classroom.Application/Features/Certificates/Queries/GetCertificateById/GetCertificateByIdQueryHandler.cs index 2ebbdac86..14c5d0f38 100644 --- a/src/Services/ClassroomService/Classroom.Application/Features/Certificates/Queries/GetCertificateById/GetCertificateByIdQueryHandler.cs +++ b/src/Services/ClassroomService/Classroom.Application/Features/Certificates/Queries/GetCertificateById/GetCertificateByIdQueryHandler.cs @@ -10,21 +10,21 @@ namespace Classroom.Application.Features.Certificates.Queries.GetCertificateById { public class GetCertificateByIdQueryHandler - : IRequestHandler + : IRequestHandler { private readonly IClassroomUnitOfWork _unitOfWork; - private readonly IGrpcUserClient _userClient; + private readonly IGrpcCourseClient _courseClient; public GetCertificateByIdQueryHandler( IClassroomUnitOfWork unitOfWork, - IGrpcUserClient userClient + IGrpcCourseClient courseClient ) { - _userClient = userClient ?? throw new ArgumentNullException(nameof(userClient)); + _courseClient = courseClient ?? throw new ArgumentNullException(nameof(courseClient)); _unitOfWork = unitOfWork ?? throw new ArgumentNullException(nameof(unitOfWork)); } - public async Task Handle( + public async Task Handle( GetCertificateByIdQuery request, CancellationToken cancellationToken ) @@ -39,11 +39,8 @@ CancellationToken cancellationToken throw new NotFoundException($"Certificate with ID {request.Id} not found."); } - var student = await _userClient.GetUserByIdAsync(certificate.UserId); - if (student == null) - throw new ArgumentException("Student not found."); - DateTimeOffset? completedAt = null; + List lessonTitles = new(); if (certificate.CourseEnrollmentId != null) { var courseEnrollmentByIdSpecification = new GetCourseEnrollmentByIdSpecification(certificate.CourseEnrollmentId.Value); @@ -51,6 +48,12 @@ CancellationToken cancellationToken courseEnrollmentByIdSpecification, cancellationToken ); + if (courseEnrollment == null) + { + throw new NotFoundException($"Course Enrollment with ID {certificate.CourseEnrollmentId.Value} not found."); + } + var course = await _courseClient.GetCourseByIdAsync(courseEnrollment.CourseId); + lessonTitles = course.Lessons.Select(lesson => lesson.Title).ToList(); completedAt = courseEnrollment?.CompletedAt; } else if (certificate.CurriculumEnrollmentId != null) @@ -63,26 +66,24 @@ CancellationToken cancellationToken completedAt = curriculumEnrollment?.CompletedAt; } - return new GrpcCertificateResponse + return new GrpcCertificateDetail() { - Certificate = new GrpcCertificateModel() - { - Id = certificate.Id, - UserId = certificate.UserId.ToString(), - CourseEnrollmentId = certificate.CourseEnrollmentId, - CurriculumEnrollmentId = certificate.CurriculumEnrollmentId, - CertificateType = certificate.CertificateType.ToString(), - IssueDate = Google.Protobuf.WellKnownTypes.Timestamp.FromDateTimeOffset( + Id = certificate.Id, + UserId = certificate.UserId.ToString(), + CourseEnrollmentId = certificate.CourseEnrollmentId, + CurriculumEnrollmentId = certificate.CurriculumEnrollmentId, + CertificateType = certificate.CertificateType.ToString(), + IssueDate = Google.Protobuf.WellKnownTypes.Timestamp.FromDateTimeOffset( certificate.IssueDate ), - VerificationCode = certificate.VerificationCode, - CertificateUrl = certificate.CertificateUrl, - UserName = certificate.UserName, - Title = certificate.Title, - CompletedAt = completedAt.HasValue + VerificationCode = certificate.VerificationCode, + CertificateUrl = certificate.CertificateUrl, + UserName = certificate.UserName, + Title = certificate.Title, + Lessons = { lessonTitles }, + CompletedAt = completedAt.HasValue ? Google.Protobuf.WellKnownTypes.Timestamp.FromDateTimeOffset(completedAt.Value) : null, - } }; } } From 4fdfcceaef5a4b9d758c287b063f594ba5dc9f78 Mon Sep 17 00:00:00 2001 From: halinhtvn3a <77691576+halinhtvn3a@users.noreply.github.com> Date: Tue, 23 Dec 2025 11:56:24 +0700 Subject: [PATCH 26/29] Add per-student progress summaries and RabbitMQ config Introduced compact per-student progress summaries in GetClassroomLearningSnapshotQueryHandler to provide assessment and content completion rates. Updated ServiceExtensions to add RabbitMQ service reference and environment variable configuration for improved service integration. --- ...etClassroomLearningSnapshotQueryHandler.cs | 60 +++++++++++++++---- .../Extensions/ServiceExtensions.cs | 5 +- 2 files changed, 54 insertions(+), 11 deletions(-) diff --git a/src/Services/ClassroomService/Classroom.Application/Features/Classrooms/Queries/GetClassroomLearningSnapshot/GetClassroomLearningSnapshotQueryHandler.cs b/src/Services/ClassroomService/Classroom.Application/Features/Classrooms/Queries/GetClassroomLearningSnapshot/GetClassroomLearningSnapshotQueryHandler.cs index 9ce45adac..cf4ae5789 100644 --- a/src/Services/ClassroomService/Classroom.Application/Features/Classrooms/Queries/GetClassroomLearningSnapshot/GetClassroomLearningSnapshotQueryHandler.cs +++ b/src/Services/ClassroomService/Classroom.Application/Features/Classrooms/Queries/GetClassroomLearningSnapshot/GetClassroomLearningSnapshotQueryHandler.cs @@ -401,19 +401,27 @@ public async Task Handle( response.StudentAssignments.Add(assignmentData); } - // Map engagement metrics (simplified - calculate from activity) + // Map engagement metrics & per-student progress summaries foreach (var student in students) { var studentGuid = Guid.Parse(student.StudentId); - var studentQuizCount = filteredStudentQuizzes.Count(sq => sq.StudentId == studentGuid.ToString()); - var studentAssignmentCount = filteredStudentAssignments.Count(sa => sa.StudentId == studentGuid.ToString()); - // Calculate completion rate (simplified) - var totalActivities = studentQuizCount + studentAssignmentCount; - var completedActivities = filteredStudentQuizzes.Count(sq => sq.StudentId == studentGuid.ToString() && sq.Status.ToString() == "Passed") - + filteredStudentAssignments.Count(sa => sa.StudentId == studentGuid.ToString() && sa.Status.ToString() == "Passed"); - - var completionRate = totalActivities > 0 ? (double)completedActivities / totalActivities : 0; + // --- Assessment-based metrics (quizzes + assignments) --- + var studentQuizCount = filteredStudentQuizzes + .Count(sq => sq.StudentId == studentGuid.ToString()); + var completedStudentQuizzes = filteredStudentQuizzes + .Count(sq => sq.StudentId == studentGuid.ToString() && sq.Status.ToString() == "Passed"); + + var studentAssignmentCount = filteredStudentAssignments + .Count(sa => sa.StudentId == studentGuid.ToString()); + var completedStudentAssignments = filteredStudentAssignments + .Count(sa => sa.StudentId == studentGuid.ToString() && sa.Status.ToString() == "Passed"); + + var totalAssessments = studentQuizCount + studentAssignmentCount; + var completedAssessments = completedStudentQuizzes + completedStudentAssignments; + var assessmentCompletionRate = totalAssessments > 0 + ? (double)completedAssessments / totalAssessments + : 0d; // Calculate days since last activity var lastQuizActivity = filteredStudentQuizzes @@ -467,16 +475,48 @@ public async Task Handle( ? attemptDurations.Average() : 0d; + // Content / section progress (reading + activities) + var studentSectionProgress = courseEnrollments + .Where(ce => ce.StudentId == studentGuid) + .SelectMany(ce => ce.LessonProgress) + .SelectMany(lp => lp.SectionProgress) + .ToList(); + + var totalSections = studentSectionProgress.Count; + var completedSections = studentSectionProgress + .Count(sp => sp.Status.ToString() == "Completed"); + + var contentCompletionRate = totalSections > 0 + ? (double)completedSections / totalSections + : 0d; + var engagementMetric = new GrpcEngagementMetricData { StudentId = student.StudentId, - CompletionRate = completionRate, + // Keep engagement completion_rate aligned with assessment-based view, + // as UI and downstream consumers already rely on this meaning. + CompletionRate = assessmentCompletionRate, DaysSinceLastActivity = daysSinceLastActivity, ActiveDaysLast7Days = activeDays, AvgSessionDurationMinutes = avgSessionDuration }; response.EngagementMetrics.Add(engagementMetric); + + // Compact per-student progress summary to avoid scanning + // deeply nested event-level records on the AI side. + var progressSummary = new GrpcStudentProgressSummary + { + StudentId = student.StudentId, + AssessmentCompletionRate = assessmentCompletionRate, + TotalAssessments = totalAssessments, + CompletedAssessments = completedAssessments, + ContentCompletionRate = contentCompletionRate, + TotalSections = totalSections, + CompletedSections = completedSections + }; + + response.StudentProgressSummaries.Add(progressSummary); } // Map section progress diff --git a/src/Services/STEMify-Backend/STEMify-Backend.AppHost/Extensions/ServiceExtensions.cs b/src/Services/STEMify-Backend/STEMify-Backend.AppHost/Extensions/ServiceExtensions.cs index 1c8bed506..2e349e76c 100644 --- a/src/Services/STEMify-Backend/STEMify-Backend.AppHost/Extensions/ServiceExtensions.cs +++ b/src/Services/STEMify-Backend/STEMify-Backend.AppHost/Extensions/ServiceExtensions.cs @@ -319,7 +319,9 @@ public static IDistributedApplicationBuilder AddApplicationServices(this IDistri .WithExternalHttpEndpoints() .WithHttpHealthCheck("/health") .WithReference(aiMemoryDb) + .WithReference(rabbitmqReference) .WithEnvironment("AI_MEMORY_DB_CONNECTION", aiMemoryDb.Resource.ConnectionStringExpression) + .WithEnvironment("RABBITMQ_URL", rabbitmqReference.Resource.ConnectionStringExpression) .WithEnvironment("RESOURCE_GRPC_ENDPOINT", resourceGrpcEndpoint) .WithEnvironment("RESOURCE_GRPC_USE_TLS", "false") .WithEnvironment("PYTHONUNBUFFERED", "1") @@ -334,7 +336,8 @@ public static IDistributedApplicationBuilder AddApplicationServices(this IDistri ?? Environment.GetEnvironmentVariable("DEEPSEEK_API_KEY") ?? "") .WithReference(resourceApiService) - .WaitFor(resourceApiService); + .WaitFor(resourceApiService) + .WaitFor(rabbitmqReference); ConfigureObservability(aiService); var apiGateway = builder From fa659e5a71035341b6b37b600a486a0253a7ecaf Mon Sep 17 00:00:00 2001 From: halinhtvn3a <77691576+halinhtvn3a@users.noreply.github.com> Date: Tue, 23 Dec 2025 11:56:32 +0700 Subject: [PATCH 27/29] Update classrooms.proto --- .../Shared/Protos/Classroom/classrooms.proto | 14 ++++++++++++++ 1 file changed, 14 insertions(+) diff --git a/src/BuildingBlocks/Shared/Protos/Classroom/classrooms.proto b/src/BuildingBlocks/Shared/Protos/Classroom/classrooms.proto index b1684272e..cec8ca5dd 100644 --- a/src/BuildingBlocks/Shared/Protos/Classroom/classrooms.proto +++ b/src/BuildingBlocks/Shared/Protos/Classroom/classrooms.proto @@ -255,6 +255,18 @@ message GetClassroomLearningSnapshotRequest { google.protobuf.Int32Value days_back = 3; } +message GrpcStudentProgressSummary { + string student_id = 1; + + double assessment_completion_rate = 2; + int32 total_assessments = 3; + int32 completed_assessments = 4; + + double content_completion_rate = 5; + int32 total_sections = 6; + int32 completed_sections = 7; +} + message GrpcClassroomLearningSnapshotResponse { GrpcClassroomBasicInfo classroom = 1; repeated GrpcStudentLearningData students = 2; @@ -265,6 +277,8 @@ message GrpcClassroomLearningSnapshotResponse { repeated GrpcSectionProgressData section_progress = 7; repeated GrpcTopicCatalogItem topics_catalog = 8; GrpcAnalysisPeriod analysis_period = 9; + + repeated GrpcStudentProgressSummary student_progress_summaries = 10; } message GrpcClassroomBasicInfo { From 9564390683a9dc47506026201d8084e6f32ce5c2 Mon Sep 17 00:00:00 2001 From: halinhtvn3a <77691576+halinhtvn3a@users.noreply.github.com> Date: Tue, 23 Dec 2025 12:33:27 +0700 Subject: [PATCH 28/29] Integrate RAG ingestion service and enhance context pipeline Adds a new IngestionService for RAG indexing with debouncing and TTL, integrates it into event handling and teacher service, and exposes a test endpoint for triggering progress events. Improves context gathering to prioritize ingestion documents, adds richer logging throughout the context and agent pipelines, and enhances student/class data tools to utilize progress summaries. Also updates content generation to support language selection and improves robustness in graph building and agent analysis. --- .../AIService/app/api/http/dependencies.py | 29 ++ .../AIService/app/api/http/routers/teacher.py | 143 +++++++ .../app/core/agent/plan_solve_agent.py | 20 +- .../AIService/app/core/context/builder.py | 14 + .../AIService/app/core/context/gather.py | 163 ++++++- .../AIService/app/core/graph/builder.py | 69 ++- .../core/llm/providers/deepseek_provider.py | 3 - .../app/core/memory/memory_manager.py | 12 +- .../app/core/rag/ingestion_service.py | 170 ++++++++ .../core/snapshot/classroom_snapshot_store.py | 2 +- .../AIService/app/core/snapshot/events.py | 15 + .../app/core/tools/student_data_tool.py | 96 ++++- .../app/features/content_generation/models.py | 8 +- .../features/content_generation/prompts.py | 15 +- .../features/content_generation/service.py | 3 +- .../AIService/app/features/teacher/service.py | 78 +++- .../teacher/student_analysis_agent.py | 405 +++++++++++++----- .../app/infrastructure/config/settings.py | 8 +- .../data/grpc_classroom_repository.py | 104 +++++ .../events/rabbitmq_consumer.py | 7 +- .../scripts/test_trigger_progress_event.py | 179 ++++++++ 21 files changed, 1369 insertions(+), 174 deletions(-) create mode 100644 src/Services/AIService/app/core/rag/ingestion_service.py create mode 100644 src/Services/AIService/scripts/test_trigger_progress_event.py diff --git a/src/Services/AIService/app/api/http/dependencies.py b/src/Services/AIService/app/api/http/dependencies.py index b560f4dbc..4d0059863 100644 --- a/src/Services/AIService/app/api/http/dependencies.py +++ b/src/Services/AIService/app/api/http/dependencies.py @@ -9,6 +9,7 @@ from app.core.llm.client import LLMClient from app.core.rag.ingestion_pipeline import IngestionPipeline +from app.core.rag.ingestion_service import IngestionService from app.core.rag.document_processor import DocumentProcessor from app.core.embedding.pipeline import EmbeddingPipeline, get_embedding_pipeline from app.core.graph.builder import GraphBuilder @@ -285,11 +286,38 @@ def get_classroom_snapshot_updater() -> ClassroomSnapshotUpdater: ) +@lru_cache(maxsize=1) +def get_ingestion_service() -> Optional[IngestionService]: + """ + Provide ingestion service for RAG indexing with debouncing. + Returns None if RAG features are disabled or unavailable. + """ + try: + ingestion_pipeline = get_ingestion_pipeline() + if not ingestion_pipeline: + return None + + classroom_repository = get_classroom_repository() + + return IngestionService( + ingestion_pipeline=ingestion_pipeline, + classroom_repository=classroom_repository, + debounce_seconds=getattr(settings, 'RAG_INGESTION_DEBOUNCE_SECONDS', 300), + ingestion_ttl_hours=getattr(settings, 'RAG_INGESTION_TTL_HOURS', 24), + ) + except Exception as e: + logger = logging.getLogger(__name__) + logger.warning(f"Failed to initialize ingestion service: {e}. Continuing without RAG ingestion.") + return None + + @lru_cache(maxsize=1) def get_classroom_snapshot_event_handler() -> ClassroomSnapshotEventHandler: + ingestion_service = get_ingestion_service() return ClassroomSnapshotEventHandler( snapshot_store=get_classroom_snapshot_store(), snapshot_updater=get_classroom_snapshot_updater(), + ingestion_service=ingestion_service, ) @@ -383,6 +411,7 @@ def get_teacher_service() -> TeacherService: classroom_snapshot_store=get_classroom_snapshot_store(), classroom_snapshot_updater=get_classroom_snapshot_updater(), direct_grading_pipeline=direct_grading_pipeline, + ingestion_service=get_ingestion_service(), ) diff --git a/src/Services/AIService/app/api/http/routers/teacher.py b/src/Services/AIService/app/api/http/routers/teacher.py index 6811f2bcd..5f20b544d 100644 --- a/src/Services/AIService/app/api/http/routers/teacher.py +++ b/src/Services/AIService/app/api/http/routers/teacher.py @@ -44,6 +44,16 @@ class BuildGraphRequest(BaseModel): force_rebuild: bool = False +class TriggerProgressEventRequest(BaseModel): + """Request model for triggering test progress event""" + classroom_id: int + student_id: str + course_enrollment_id: int = 1 + course_id: int = 1 + progress_percentage: int = 50 + status: str = "InProgress" + + @router.post("/student-analysis", response_model=InterventionResponse) async def student_analysis( request: StudentAnalysisRequest, @@ -132,3 +142,136 @@ async def build_graph( raise HTTPException(status_code=500, detail=str(e)) +@router.post("/test/trigger-progress-event") +async def trigger_progress_event( + request: TriggerProgressEventRequest, + direct: bool = False, # Query parameter: ?direct=true +): + """ + Test endpoint to trigger ClassroomStudentProgressUpdatedEvent. + + This can work in two modes: + 1. RabbitMQ mode (default): Publishes event to RabbitMQ + 2. Direct mode (direct=true): Directly calls event handler (useful when RabbitMQ unavailable) + + The event will trigger: + 1. Snapshot refresh + 2. RAG ingestion (with debouncing - waits 5 minutes before ingesting) + + Use this to test the event-driven ingestion flow. + """ + from app.core.snapshot.events import ClassroomEvent + from app.api.http.dependencies import get_classroom_snapshot_event_handler + + # Create event payload matching C# event structure + event_data = { + "StudentId": request.student_id, + "ClassroomId": request.classroom_id, + "CourseEnrollmentId": request.course_enrollment_id, + "CourseId": request.course_id, + "ProgressPercentage": request.progress_percentage, + "Status": request.status, + } + + if direct: + # Direct mode: Call event handler directly (bypass RabbitMQ) + try: + event_handler = get_classroom_snapshot_event_handler() + classroom_event = ClassroomEvent( + type="STUDENT_PROGRESS_UPDATED", + classroom_id=request.classroom_id, + student_id=request.student_id, + payload={ + "course_enrollment_id": request.course_enrollment_id, + "course_id": request.course_id, + "progress_percentage": request.progress_percentage, + "status": request.status, + }, + ) + await event_handler.handle_event(classroom_event) + + logger.info( + f"[TeacherRouter] Test progress event handled directly for classroom {request.classroom_id}, " + f"student {request.student_id}" + ) + + return { + "success": True, + "message": "Event handled directly (bypassed RabbitMQ)", + "event_data": event_data, + "note": "Event was processed directly. RAG ingestion will be scheduled with 5-minute debounce.", + } + except Exception as e: + logger.error("[TeacherRouter] Error handling event directly: %s", e, exc_info=True) + raise HTTPException(status_code=500, detail=f"Failed to handle event: {str(e)}") + else: + # RabbitMQ mode: Publish to RabbitMQ + try: + import aio_pika + import json + from app.infrastructure.config.settings import settings + + exchange_name = "EventBus.Messages:ClassroomStudentProgressUpdatedEvent" + routing_key = "EventBus.Messages:ClassroomStudentProgressUpdatedEvent" + + # Connect and publish + connection = await aio_pika.connect_robust(settings.RABBITMQ_URL) + + try: + async with connection: + channel = await connection.channel() + + # Declare exchange + try: + exchange = await channel.declare_exchange( + exchange_name, + aio_pika.ExchangeType.TOPIC, + durable=True, + ) + except Exception: + exchange = await channel.declare_exchange( + exchange_name, + aio_pika.ExchangeType.FANOUT, + durable=True, + ) + + # Publish message + message_body = json.dumps(event_data).encode("utf-8") + message = aio_pika.Message( + body=message_body, + content_type="application/json", + delivery_mode=aio_pika.DeliveryMode.PERSISTENT, + ) + + await exchange.publish( + message, + routing_key=routing_key, + ) + + logger.info( + f"[TeacherRouter] Test progress event published to RabbitMQ for classroom {request.classroom_id}, " + f"student {request.student_id}" + ) + + return { + "success": True, + "message": "Event published to RabbitMQ successfully", + "event_data": event_data, + "note": "Event will be consumed by ClassroomProgressEventConsumer. " + "RAG ingestion will be scheduled with 5-minute debounce.", + } + finally: + await connection.close() + + except Exception as e: + logger.warning( + f"[TeacherRouter] Failed to publish to RabbitMQ: {e}. " + f"Hint: Use ?direct=true to test without RabbitMQ" + ) + raise HTTPException( + status_code=503, + detail=f"Failed to publish event to RabbitMQ: {str(e)}. " + f"Use ?direct=true query parameter to test without RabbitMQ." + ) + + diff --git a/src/Services/AIService/app/core/agent/plan_solve_agent.py b/src/Services/AIService/app/core/agent/plan_solve_agent.py index 4ad57b8b5..7f7eb4052 100644 --- a/src/Services/AIService/app/core/agent/plan_solve_agent.py +++ b/src/Services/AIService/app/core/agent/plan_solve_agent.py @@ -86,17 +86,9 @@ async def _generate_plan(self, question: str) -> List[str]: """Generate action plan""" prompt = self.PLANNER_PROMPT.format(question=question) messages: List[LLMMessage] = [{"role": "user", "content": prompt}] - - # Log request data before calling LLM (full prompt, no truncate) - logger.info( - f"[Plan-Solve] Calling LLM to generate plan | " - f"question={question}, prompt_length={len(prompt)}, use_remote={self.use_remote} | " - f"full_prompt={prompt}" - ) - response = await self.llm.generate(messages, use_remote=self.use_remote) response_text = response.content if hasattr(response, 'content') else str(response) - + # Parse Python list try: if "```python" in response_text: @@ -107,6 +99,7 @@ async def _generate_plan(self, question: str) -> List[str]: plan_str = response_text.strip() plan = ast.literal_eval(plan_str) + return plan if isinstance(plan, list) else [] except Exception as e: logger.warning(f"[Plan-Solve] Failed to parse plan: {e}") @@ -128,15 +121,6 @@ async def _execute_step( current_step=current_step ) messages: List[LLMMessage] = [{"role": "user", "content": prompt}] - - # Log request data before calling LLM (full prompt, no truncate) - logger.info( - f"[Plan-Solve] Calling LLM to execute step | " - f"current_step={current_step}, question={question}, " - f"prompt_length={len(prompt)}, use_remote={self.use_remote} | " - f"full_prompt={prompt}" - ) - response = await self.llm.generate(messages, use_remote=self.use_remote) return response.content if hasattr(response, 'content') else str(response) diff --git a/src/Services/AIService/app/core/context/builder.py b/src/Services/AIService/app/core/context/builder.py index 7f495595b..150b73397 100644 --- a/src/Services/AIService/app/core/context/builder.py +++ b/src/Services/AIService/app/core/context/builder.py @@ -59,11 +59,25 @@ async def build( return bundle candidates = await self.gatherer.gather(query=query, user_id=user_id, top_k=top_k) + logger.info(f"[JITContextBuilder] Gathered {len(candidates)} candidates") + selected = self.selector.select(candidates) + logger.info(f"[JITContextBuilder] Selected {len(selected)} items after selection") + structured = self.structurer.structure(selected) + logger.info( + f"[JITContextBuilder] Structured: memory={len(structured.get('memory', []))}, " + f"retrieval={len(structured.get('retrieval', []))}, other={len(structured.get('other', []))}" + ) + compressed = self.compressor.compress(structured) + logger.info( + f"[JITContextBuilder] Compressed: memory={len(compressed.get('memory', []))}, " + f"retrieval={len(compressed.get('retrieval', []))}, other={len(compressed.get('other', []))}" + ) total_tokens = self._estimate_tokens(compressed) + logger.info(f"[JITContextBuilder] Estimated {total_tokens} tokens") notes = None if total_tokens > self.token_budget: diff --git a/src/Services/AIService/app/core/context/gather.py b/src/Services/AIService/app/core/context/gather.py index 462338ca2..24e0de706 100644 --- a/src/Services/AIService/app/core/context/gather.py +++ b/src/Services/AIService/app/core/context/gather.py @@ -47,12 +47,16 @@ async def gather( ) for layer, items in mem_results.items(): for item in items: + metadata = item.get("metadata", {}) or {} + if metadata.get("type") == "teacher_student_analysis": + continue + candidates.append( ContextItem( content=item.get("content", ""), score=item.get("relevance_score", 0.5), source=f"memory:{layer}", - metadata=item.get("metadata", {}), + metadata=metadata, ) ) except Exception as e: @@ -60,16 +64,167 @@ async def gather( # Retrieval (vector + graph hybrid) try: - retrieval_results = await self.hybrid_retriever.retrieve(query, top_k=top_k) + retrieval_top_k = max(top_k * 3, 30) # Request at least 30 documents + + # Query 1: General retrieval (may include teacher_student_analysis) + general_results = await self.hybrid_retriever.retrieve(query, top_k=retrieval_top_k) + + # Query 2: Try to get documents with document_type (from ingestion) + # Request many more documents to find ingestion documents that may have lower similarity scores + ingestion_results = [] + try: + # Request significantly more documents to increase chance of finding ingestion documents + # that may rank lower due to embedding mismatch but are still relevant + ingestion_results = await self.hybrid_retriever.retrieve_vector_only( + query=query, + top_k=retrieval_top_k * 5 # Request 5x more to find ingestion documents + ) + + logger.info( + f"[ContextGatherer] Vector-only retrieval found {len(ingestion_results)} documents " + f"(requested {retrieval_top_k * 5} to find ingestion documents)" + ) + except Exception as e: + logger.debug(f"[ContextGatherer] Vector-only retrieval failed: {e}") + + + seen_docs = {} # doc_id -> (doc, priority) + + for doc in ingestion_results: + doc_id = doc.get("document_id") or doc.get("id") + if doc_id: + inner_meta = doc.get("metadata", {}).get("metadata", {}) or {} + has_document_type = "document_type" in inner_meta + priority = 1 if has_document_type else 3 # Higher priority for ingestion docs + if doc_id not in seen_docs or seen_docs[doc_id][1] > priority: + seen_docs[doc_id] = (doc, priority) + + # Priority 2: General results that weren't already included + for doc in general_results: + doc_id = doc.get("document_id") or doc.get("id") + if doc_id and doc_id not in seen_docs: + inner_meta = doc.get("metadata", {}).get("metadata", {}) or {} + has_document_type = "document_type" in inner_meta + priority = 2 if has_document_type else 4 # Lower priority for general docs + seen_docs[doc_id] = (doc, priority) + + # Sort by priority (lower number = higher priority), then by retrieval_score + retrieval_results = sorted( + [doc for doc, _ in seen_docs.values()], + key=lambda d: ( + seen_docs.get(d.get("document_id") or d.get("id"), (None, 999))[1], + -d.get("retrieval_score", 0) # Negative for descending + ) + ) + + + + logger.info( + f"[ContextGatherer] Combined retrieval: {len(retrieval_results)} unique documents " + f"(from {len(general_results)} general + {len(ingestion_results)} ingestion-focused, " + f"prioritized by document_type)" + ) + + # Log document types for debugging + doc_types = {} + filtered_count = 0 + added_count = 0 + + + for doc in retrieval_results: + metadata = {k: v for k, v in doc.items() if k not in ("content", "retrieval_score", "score")} + inner_metadata = metadata.get("metadata", {}) or {} + + doc_type = ( + metadata.get("type") or # Top level (episodic memory) + inner_metadata.get("type") or # Inner metadata + inner_metadata.get("document_type") or # Ingestion documents + "unknown" + ) + doc_types[doc_type] = doc_types.get(doc_type, 0) + 1 + + if doc_type == "teacher_student_analysis": + filtered_count += 1 + continue + + score = doc.get("retrieval_score") or doc.get("score", 0.0) + candidates.append( ContextItem( content=doc.get("content", ""), - score=doc.get("score", 0.0), + score=float(score), source="retrieval", - metadata={k: v for k, v in doc.items() if k != "content"}, + metadata=metadata, ) ) + added_count += 1 + + # Log summary with document IDs for debugging + sample_doc_ids = [doc.get("document_id", "unknown") for doc in retrieval_results[:5]] + # Check if any documents have classroom_id pattern (from ingestion) + ingestion_pattern_count = sum( + 1 for doc in retrieval_results + if doc.get("document_id", "").startswith("classroom_") + or (metadata.get("metadata", {}).get("classroom_id") is not None) + ) + + logger.info( + f"[ContextGatherer] Document types retrieved: {doc_types} | " + f"Filtered {filtered_count} teacher_student_analysis | " + f"Added {added_count} classroom data documents | " + f"Documents with ingestion pattern: {ingestion_pattern_count}/{len(retrieval_results)} | " + f"Sample doc_ids: {sample_doc_ids}" + ) + + if ingestion_pattern_count == 0 and len(retrieval_results) > 0: + logger.warning( + f"[ContextGatherer] No documents with ingestion pattern found. " + f"All {len(retrieval_results)} documents appear to be from memory, not ingestion. " + f"This suggests: 1) Ingestion documents not in vector store, " + f"2) Embeddings don't match query, 3) Documents overwritten by memory." + ) + + # Fallback: If no classroom data documents found, use a few teacher_student_analysis + # documents with lower score to provide some context (better than empty context) + if added_count == 0 and filtered_count > 0: + logger.warning( + f"[ContextGatherer] WARNING: All {filtered_count} retrieved documents are teacher_student_analysis. " + f"No classroom data documents found. This may indicate: " + f"1) Classroom not ingested yet, 2) Only memory documents in vector store, " + f"3) Need to ingest classroom data first. " + f"Using {min(3, filtered_count)} teacher_student_analysis documents as fallback." + ) + + # Add a few teacher_student_analysis documents with reduced score as fallback + fallback_count = 0 + for doc in retrieval_results: + if fallback_count >= 3: # Limit to 3 fallback documents + break + + metadata = {k: v for k, v in doc.items() if k not in ("content", "retrieval_score", "score")} + inner_metadata = metadata.get("metadata", {}) or {} + doc_type = inner_metadata.get("type") or inner_metadata.get("document_type") or "unknown" + + if doc_type == "teacher_student_analysis": + # Use lower score for fallback documents + score = (doc.get("retrieval_score") or doc.get("score", 0.0)) * 0.3 # Reduce score by 70% + + candidates.append( + ContextItem( + content=doc.get("content", ""), + score=float(score), + source="retrieval:fallback", + metadata={**metadata, "fallback": True, "original_type": doc_type}, + ) + ) + fallback_count += 1 + + if fallback_count > 0: + logger.info( + f"[ContextGatherer] Added {fallback_count} fallback teacher_student_analysis documents " + f"with reduced scores (score * 0.3)" + ) except Exception as e: logger.warning(f"[ContextGatherer] Retrieval gather failed: {e}") diff --git a/src/Services/AIService/app/core/graph/builder.py b/src/Services/AIService/app/core/graph/builder.py index 2ed1d363b..afac9db39 100644 --- a/src/Services/AIService/app/core/graph/builder.py +++ b/src/Services/AIService/app/core/graph/builder.py @@ -646,14 +646,49 @@ async def _create_student_assignment_nodes(self, data: Dict[str, Any]): """Create StudentAssignment nodes""" student_assignments = data.get("assignments", {}).get("student_assignments", []) - for sa in student_assignments: + # Track synthesized IDs to avoid duplicates + seen_synthesized_ids = set() + synthesis_counter = {} # (student_id, assignment_id) -> counter + + for idx, sa in enumerate(student_assignments): node_id = sa.get("id") student_id = sa.get("student_id", "") if not student_id: logger.warning("Skipping student_assignment with missing student_id: %s", sa) continue if not node_id: - node_id = f"sa-{student_id}-{sa.get('assignment_id', 'unknown')}" + + assignment_id = sa.get("assignment_id") + if assignment_id: + node_id = f"sa-{student_id}-{assignment_id}" + else: + unique_parts = [] + if sa.get("due_date"): + unique_parts.append(str(hash(sa.get("due_date")) % 10000)) + if sa.get("submitted_at"): + unique_parts.append(str(hash(sa.get("submitted_at")) % 10000)) + if sa.get("assigned_at"): + unique_parts.append(str(hash(sa.get("assigned_at")) % 10000)) + + if not unique_parts: + unique_parts.append(str(hash(str(sa)) % 100000)) + + # Use counter as last resort + key = (student_id, "unknown") + if key not in synthesis_counter: + synthesis_counter[key] = 0 + synthesis_counter[key] += 1 + unique_parts.append(str(synthesis_counter[key])) + + node_id = f"sa-{student_id}-{'-'.join(unique_parts)}" + + original_node_id = node_id + counter = 1 + while node_id in seen_synthesized_ids: + node_id = f"{original_node_id}-{counter}" + counter += 1 + + seen_synthesized_ids.add(node_id) sa["id"] = node_id logger.info("Synthesized student_assignment id=%s for student_id=%s", node_id, student_id) node_id = str(node_id) @@ -941,6 +976,11 @@ async def _create_enrollment_relationships(self, data: Dict[str, Any]): "FOR_COURSE", "Course", course_id ) + else: + logger.debug( + f"CourseEnrollment {ce_id} has no course_id - will be orphaned. " + f"Backend should provide course_id in course_enrollments data." + ) # Also create Student -> Classroom relationship for backward compatibility conflicts = self.monitor.check_relationship( @@ -1236,7 +1276,11 @@ async def _create_quiz_relationships(self, data: Dict[str, Any]): continue if not quiz_id: - logger.warning(f"StudentQuiz for QuizAttempt {attempt_id} has no quiz_id - skipping") + logger.warning( + f"StudentQuiz for QuizAttempt {attempt_id} has no quiz_id - skipping relationship creation. " + f"Backend should provide quiz_id in student_quizzes data. " + f"This will result in orphan QuizAttempt node." + ) continue student_id = str(student_id) @@ -1764,8 +1808,21 @@ async def _create_performance_relationships(self, data: Dict[str, Any]) -> Dict[ if not question_attempts: continue + # Try to get quiz_id for fallback + quiz_id = student_quiz.get("quiz_id") + for qa in question_attempts: topics = qa.get("topics", []) + + # Fallback: If question_attempt has no topics, try to get from quiz level + if not topics and quiz_id: + # Try to find quiz node and get its topics from HAS_TOPIC relationships + # This is a fallback when question-level topics are missing + logger.debug( + f"[LEVEL 5] Question attempt missing topics, quiz_id={quiz_id}. " + f"Note: Backend should provide topics in question_attempts for accurate performance analysis." + ) + if not topics: continue @@ -1788,6 +1845,12 @@ async def _create_performance_relationships(self, data: Dict[str, Any]) -> Dict[ quiz_attempts_with_topics += 1 else: quiz_attempts_without_topics += 1 + if quiz_id: + logger.debug( + f"[LEVEL 5] Quiz attempt {attempt.get('id', 'unknown')} has no topics in question_attempts. " + f"quiz_id={quiz_id}, student_id={student_id}. " + f"Backend should populate question_attempts[].topics[] for Level 5 performance analysis." + ) logger.info( f"[LEVEL 5] Quiz attempts: {quiz_attempts_processed} processed, " diff --git a/src/Services/AIService/app/core/llm/providers/deepseek_provider.py b/src/Services/AIService/app/core/llm/providers/deepseek_provider.py index 3e891feff..f0c3aa26b 100644 --- a/src/Services/AIService/app/core/llm/providers/deepseek_provider.py +++ b/src/Services/AIService/app/core/llm/providers/deepseek_provider.py @@ -66,16 +66,13 @@ async def generate( for msg in messages ] - # Log request data before API call temperature = kwargs.get("temperature", self.temperature) max_tokens = kwargs.get("max_tokens", self.max_tokens) - # Prepare messages summary for logging (full content, no truncate) messages_summary = [] for msg in deepseek_messages: role = msg.get("role", "unknown") content = msg.get("content", "") - # Log full content without truncation messages_summary.append(f"{role}: {content} (length={len(content)})") other_params = {k: v for k, v in kwargs.items() if k not in ["temperature", "max_tokens"]} diff --git a/src/Services/AIService/app/core/memory/memory_manager.py b/src/Services/AIService/app/core/memory/memory_manager.py index 6f3b5b51c..4a28c16e1 100644 --- a/src/Services/AIService/app/core/memory/memory_manager.py +++ b/src/Services/AIService/app/core/memory/memory_manager.py @@ -63,17 +63,7 @@ async def add_memory( memory_type: str, metadata: Dict[str, Any] ) -> str: - """ - Add memory to appropriate layer - - Args: - content: Memory content - memory_type: Type of memory ("working", "episodic", "semantic", "perceptual") - metadata: Memory metadata - - Returns: - Memory ID - """ + if memory_type == "working": return await self.working_memory.add(content, metadata) diff --git a/src/Services/AIService/app/core/rag/ingestion_service.py b/src/Services/AIService/app/core/rag/ingestion_service.py new file mode 100644 index 000000000..3f952eee4 --- /dev/null +++ b/src/Services/AIService/app/core/rag/ingestion_service.py @@ -0,0 +1,170 @@ +import asyncio +from typing import Dict, Any, Optional, Set +from datetime import datetime, timedelta +import logging + +from app.core.rag.ingestion_pipeline import IngestionPipeline +from app.core.data.classroom_repository import ClassroomRepository + +logger = logging.getLogger(__name__) + + +class IngestionService: + def __init__( + self, + ingestion_pipeline: IngestionPipeline, + classroom_repository: ClassroomRepository, + debounce_seconds: int = 300, # 5 minutes default + ingestion_ttl_hours: int = 24, # Consider ingestion stale after 24h + ): + self.ingestion_pipeline = ingestion_pipeline + self.classroom_repository = classroom_repository + self.debounce_seconds = debounce_seconds + self.ingestion_ttl_hours = ingestion_ttl_hours + + self._pending_tasks: Dict[int, asyncio.Task] = {} + self._ingestion_status: Dict[int, datetime] = {} + + self._ingesting: Set[int] = set() + + logger.info( + f"[IngestionService] Initialized with debounce={debounce_seconds}s, " + f"ttl={ingestion_ttl_hours}h" + ) + + async def schedule_ingestion( + self, + classroom_id: int, + force: bool = False, + ) -> bool: + if not force and self._is_recently_ingested(classroom_id): + logger.debug( + f"[IngestionService] Classroom {classroom_id} already ingested recently, skipping" + ) + return False + + if classroom_id in self._pending_tasks: + task = self._pending_tasks[classroom_id] + if not task.done(): + task.cancel() + logger.debug( + f"[IngestionService] Cancelled pending ingestion for classroom {classroom_id}" + ) + + if force: + asyncio.create_task(self._ingest_classroom(classroom_id)) + return True + else: + async def debounced_ingest(): + try: + await asyncio.sleep(self.debounce_seconds) + await self._ingest_classroom(classroom_id) + except asyncio.CancelledError: + logger.debug( + f"[IngestionService] Debounced ingestion cancelled for classroom {classroom_id}" + ) + raise + + self._pending_tasks[classroom_id] = asyncio.create_task(debounced_ingest()) + logger.info( + f"[IngestionService] Scheduled ingestion for classroom {classroom_id} " + f"(debounce={self.debounce_seconds}s)" + ) + return True + + async def ensure_ingested( + self, + classroom_id: int, + max_wait_seconds: int = 0, + ) -> bool: + + if self._is_recently_ingested(classroom_id): + return True + + if classroom_id in self._ingesting: + if max_wait_seconds > 0: + wait_interval = 1 + waited = 0 + while classroom_id in self._ingesting and waited < max_wait_seconds: + await asyncio.sleep(wait_interval) + waited += wait_interval + return self._is_recently_ingested(classroom_id) + return True + + logger.info( + f"[IngestionService] Triggering immediate ingestion for classroom {classroom_id} " + f"(lazy loading)" + ) + asyncio.create_task(self._ingest_classroom(classroom_id)) + return True + + def _is_recently_ingested(self, classroom_id: int) -> bool: + if classroom_id not in self._ingestion_status: + return False + + ingestion_time = self._ingestion_status[classroom_id] + age = datetime.utcnow() - ingestion_time + return age < timedelta(hours=self.ingestion_ttl_hours) + + async def _ingest_classroom(self, classroom_id: int) -> None: + + # Prevent concurrent ingestion of same classroom + if classroom_id in self._ingesting: + logger.warning( + f"[IngestionService] Classroom {classroom_id} is already being ingested, skipping" + ) + return + + self._ingesting.add(classroom_id) + + try: + logger.info(f"[IngestionService] Starting ingestion for classroom {classroom_id}") + + # Fetch classroom data + classroom_data = await self.classroom_repository.get_classroom_data( + classroom_id=classroom_id, + student_id=None, + analysis_period_days=None, + ) + + if not classroom_data: + logger.warning( + f"[IngestionService] No data found for classroom {classroom_id}, skipping ingestion" + ) + return + + # Perform ingestion + result = await self.ingestion_pipeline.ingest(classroom_data) + + if result.get("errors"): + logger.error( + f"[IngestionService] Ingestion completed with errors for classroom {classroom_id}: " + f"{result['errors']}" + ) + else: + # Mark as ingested + self._ingestion_status[classroom_id] = datetime.utcnow() + logger.info( + f"[IngestionService] Successfully ingested classroom {classroom_id}: " + f"{result.get('documents_stored', 0)} documents, " + f"{result.get('graph_nodes', 0)} graph nodes" + ) + + # Clean up pending task + if classroom_id in self._pending_tasks: + del self._pending_tasks[classroom_id] + + except Exception as e: + logger.error( + f"[IngestionService] Error ingesting classroom {classroom_id}: {e}", + exc_info=True + ) + finally: + self._ingesting.discard(classroom_id) + + def get_ingestion_status(self, classroom_id: int) -> Optional[datetime]: + return self._ingestion_status.get(classroom_id) + + def is_ingesting(self, classroom_id: int) -> bool: + return classroom_id in self._ingesting + diff --git a/src/Services/AIService/app/core/snapshot/classroom_snapshot_store.py b/src/Services/AIService/app/core/snapshot/classroom_snapshot_store.py index 51607f2a0..905d29fb1 100644 --- a/src/Services/AIService/app/core/snapshot/classroom_snapshot_store.py +++ b/src/Services/AIService/app/core/snapshot/classroom_snapshot_store.py @@ -99,7 +99,7 @@ async def get_or_refresh_snapshot( snapshot = self._snapshot_store.get_snapshot(classroom_id) if not force_full_refresh and snapshot and not self._snapshot_store.needs_full_refresh(classroom_id): - logger.debug( + logger.info( "[ClassroomSnapshotUpdater] Using cached snapshot within cooldown window", extra={"classroom_id": classroom_id}, ) diff --git a/src/Services/AIService/app/core/snapshot/events.py b/src/Services/AIService/app/core/snapshot/events.py index 39ecf94e6..a0569b18d 100644 --- a/src/Services/AIService/app/core/snapshot/events.py +++ b/src/Services/AIService/app/core/snapshot/events.py @@ -9,6 +9,7 @@ ClassroomSnapshotStore, ClassroomSnapshotUpdater, ) +from app.core.rag.ingestion_service import IngestionService logger = logging.getLogger(__name__) @@ -27,9 +28,11 @@ def __init__( self, snapshot_store: ClassroomSnapshotStore, snapshot_updater: ClassroomSnapshotUpdater, + ingestion_service: Optional[IngestionService] = None, ) -> None: self._snapshot_store = snapshot_store self._snapshot_updater = snapshot_updater + self._ingestion_service = ingestion_service async def handle_event(self, event: ClassroomEvent) -> None: try: @@ -76,6 +79,18 @@ async def handle_event(self, event: ClassroomEvent) -> None: analysis_period_days=analysis_period_days, force_full_refresh=force_full_refresh, ) + if self._ingestion_service: + try: + await self._ingestion_service.schedule_ingestion( + classroom_id=classroom_id, + force=False, + ) + except Exception as ingestion_error: + logger.warning( + f"[ClassroomSnapshotEventHandler] Failed to schedule ingestion for " + f"classroom {classroom_id}: {ingestion_error}", + exc_info=True + ) except Exception as exc: logger.exception( "[ClassroomSnapshotEventHandler] Failed to handle event", diff --git a/src/Services/AIService/app/core/tools/student_data_tool.py b/src/Services/AIService/app/core/tools/student_data_tool.py index 4d67bb83a..037924a6f 100644 --- a/src/Services/AIService/app/core/tools/student_data_tool.py +++ b/src/Services/AIService/app/core/tools/student_data_tool.py @@ -76,6 +76,19 @@ async def _student_overview(self, parameters: Dict[str, Any]) -> str: if not student: return json.dumps({"error": "Student not found"}) + progress_summaries = data.get("student_progress_summaries", []) or data.get( + "studentProgressSummaries", [] + ) + progress_summary = next( + ( + s + for s in progress_summaries + if s.get("student_id") == student_id + or s.get("studentId") == student_id + ), + None, + ) + # Normalize key metrics for analysis overview = { "student_id": student_id, @@ -87,6 +100,28 @@ async def _student_overview(self, parameters: Dict[str, Any]) -> str: "engagement_score": student.get("engagement_score"), "last_active_at": student.get("last_active_at"), } + + if progress_summary: + overview["assessment_completion_rate"] = ( + progress_summary.get("assessment_completion_rate") + or progress_summary.get("assessmentCompletionRate") + ) + overview["content_completion_rate"] = ( + progress_summary.get("content_completion_rate") + or progress_summary.get("contentCompletionRate") + ) + overview["total_assessments"] = progress_summary.get( + "total_assessments" + ) or progress_summary.get("totalAssessments") + overview["completed_assessments"] = progress_summary.get( + "completed_assessments" + ) or progress_summary.get("completedAssessments") + overview["total_sections"] = progress_summary.get("total_sections") or progress_summary.get( + "totalSections" + ) + overview["completed_sections"] = progress_summary.get( + "completed_sections" + ) or progress_summary.get("completedSections") return json.dumps(overview) async def _class_overview(self, parameters: Dict[str, Any]) -> str: @@ -108,16 +143,52 @@ async def _class_overview(self, parameters: Dict[str, Any]) -> str: if count == 0: return json.dumps({"classroom_id": classroom_id, "student_count": 0}) - # Aggregate simple stats - avg_completion = sum(s.get("completion_rate", 0.0) for s in students) / count - avg_score = sum(s.get("average_score", 0.0) for s in students) / count + progress_summaries = data.get("student_progress_summaries", []) or data.get( + "studentProgressSummaries", [] + ) - overview = { - "classroom_id": classroom_id, - "student_count": count, - "average_completion_rate": round(avg_completion, 2), - "average_score": round(avg_score, 2), - } + if progress_summaries: + assessment_rates = [] + content_rates = [] + for s in progress_summaries: + ar = s.get("assessment_completion_rate") or s.get( + "assessmentCompletionRate" + ) + cr = s.get("content_completion_rate") or s.get( + "contentCompletionRate" + ) + if ar is not None: + assessment_rates.append(float(ar)) + if cr is not None: + content_rates.append(float(cr)) + + avg_assessment = ( + sum(assessment_rates) / len(assessment_rates) if assessment_rates else 0.0 + ) + avg_content = ( + sum(content_rates) / len(content_rates) if content_rates else 0.0 + ) + avg_score = sum(s.get("average_score", 0.0) for s in students) / count + + overview = { + "classroom_id": classroom_id, + "student_count": count, + "average_assessment_completion_rate": round(avg_assessment, 3), + "average_content_completion_rate": round(avg_content, 3), + "average_score": round(avg_score, 2), + } + else: + avg_completion = sum( + s.get("completion_rate", 0.0) for s in students + ) / count + avg_score = sum(s.get("average_score", 0.0) for s in students) / count + + overview = { + "classroom_id": classroom_id, + "student_count": count, + "average_completion_rate": round(avg_completion, 2), + "average_score": round(avg_score, 2), + } return json.dumps(overview) async def _detailed_data(self, parameters: Dict[str, Any]) -> str: @@ -164,8 +235,15 @@ async def _detailed_data(self, parameters: Dict[str, Any]) -> str: if not student_quizzes: student_quizzes = data.get("studentQuizzes", []) or data.get("student_quizzes", []) + progress_summaries = ( + data.get("student_progress_summaries") + or data.get("studentProgressSummaries") + or [] + ) + detailed = { "classroom_id": classroom_id, + "student_progress_summaries": progress_summaries, "quizAttempts": quiz_attempts, "studentAssignments": student_assignments, "sectionProgress": section_progress, diff --git a/src/Services/AIService/app/features/content_generation/models.py b/src/Services/AIService/app/features/content_generation/models.py index a0d23b249..82a8ca6de 100644 --- a/src/Services/AIService/app/features/content_generation/models.py +++ b/src/Services/AIService/app/features/content_generation/models.py @@ -15,11 +15,13 @@ class LessonSectionRequest(BaseModel): lesson_id: Optional[str] = Field( default=None, - description="Identifier of the lesson to extend. None falls back to mock repository.", - ) + ) force_mock: bool = Field( default=False, - description="Force using mock repository regardless of lesson_id (useful for testing).", + ) + lang: Optional[str] = Field( + default="vi", + description="Language code for the response (e.g., 'vi' for Vietnamese, 'en' for English).", ) diff --git a/src/Services/AIService/app/features/content_generation/prompts.py b/src/Services/AIService/app/features/content_generation/prompts.py index 62a19aec3..5beca5fae 100644 --- a/src/Services/AIService/app/features/content_generation/prompts.py +++ b/src/Services/AIService/app/features/content_generation/prompts.py @@ -59,7 +59,7 @@ def _get_default_section_prompt_template() -> str: """ -def build_section_prompt(context_text: str) -> str: +def build_section_prompt(context_text: str, lang: str = "vi") -> str: """ Return LLM prompt for generating a new lesson section. @@ -74,5 +74,16 @@ def build_section_prompt(context_text: str) -> str: template_str = None template = template_str or _get_default_section_prompt_template() + # Add language instruction to the prompt + lang_instruction = "" + if lang == "vi": + lang_instruction = "\n\nLANGUAGE REQUIREMENT:\nYou MUST respond in Vietnamese (Tiếng Việt). All text fields including title, description, and any other content MUST be in Vietnamese." + elif lang == "en": + lang_instruction = "\n\nLANGUAGE REQUIREMENT:\nYou MUST respond in English. All text fields including title, description, and any other content MUST be in English." + else: + lang_instruction = f"\n\nLANGUAGE REQUIREMENT:\nYou MUST respond in {lang}. All text fields including title, description, and any other content MUST be in {lang}." + + template_with_lang = template + lang_instruction + # Format template with context - return template.format(context_text=context_text) + return template_with_lang.format(context_text=context_text) diff --git a/src/Services/AIService/app/features/content_generation/service.py b/src/Services/AIService/app/features/content_generation/service.py index c7e0b9fda..8e50eaa4b 100644 --- a/src/Services/AIService/app/features/content_generation/service.py +++ b/src/Services/AIService/app/features/content_generation/service.py @@ -49,7 +49,8 @@ async def generate_lesson_section( is_fallback = self.lesson_repository.was_fallback_used() context_text = build_lesson_context(lesson) - prompt = build_section_prompt(context_text) + lang = request.lang or "vi" + prompt = build_section_prompt(context_text, lang=lang) logger.info("Generating lesson section via LLM client", extra={"lesson_id": lesson.id}) diff --git a/src/Services/AIService/app/features/teacher/service.py b/src/Services/AIService/app/features/teacher/service.py index 277ed643d..7950ec80a 100644 --- a/src/Services/AIService/app/features/teacher/service.py +++ b/src/Services/AIService/app/features/teacher/service.py @@ -20,6 +20,7 @@ ClassroomSnapshotStore, ClassroomSnapshotUpdater, ) +from app.core.rag.ingestion_service import IngestionService from app.features.recommendations.models import ( InterventionResponse, StudentOverview, @@ -59,6 +60,7 @@ def __init__( classroom_snapshot_store: Optional[ClassroomSnapshotStore] = None, classroom_snapshot_updater: Optional[ClassroomSnapshotUpdater] = None, direct_grading_pipeline: Optional[DirectGradingPipeline] = None, + ingestion_service: Optional[IngestionService] = None, ): self.llm = llm self.context_builder = context_builder @@ -73,6 +75,7 @@ def __init__( self.classroom_snapshot_store = classroom_snapshot_store self.classroom_snapshot_updater = classroom_snapshot_updater self.direct_grading_pipeline = direct_grading_pipeline + self.ingestion_service = ingestion_service logger.info("TeacherService initialized") @@ -177,7 +180,7 @@ async def analyze_student( classroom_snapshot_updater=self.classroom_snapshot_updater, ) - # Build context bundle (for budgeting + future reuse) + # Build context bundle context_bundle = await self.context_builder.build( query=question, user_id=teacher_id, @@ -185,21 +188,74 @@ async def analyze_student( session_id=session_id, ) + logger.info( + "[TeacherService] Context bundle for teacher %s: %s", + teacher_id, + context_bundle, + ) + + if classroom_id and self.ingestion_service: + try: + await self.ingestion_service.ensure_ingested( + classroom_id=classroom_id, + max_wait_seconds=0, + ) + except Exception as e: + logger.warning( + f"[TeacherService] Failed to ensure ingestion for classroom {classroom_id}: {e}" + ) + classroom_data = None if classroom_id: try: if self.classroom_snapshot_updater and self.classroom_snapshot_store: + # #region agent log + import json + debug_log_path = r"d:\8_LASTCHANGE\STEMify-Backend\.cursor\debug.log" + try: + with open(debug_log_path, "a", encoding="utf-8") as f: + f.write(json.dumps({ + "sessionId": "debug-session", + "runId": "run1", + "hypothesisId": "FLOW", + "location": "service.py:analyze_student:GET_SNAPSHOT", + "message": "Getting classroom snapshot", + "data": { + "classroom_id": classroom_id, + "analysis_period_days": analysis_period_days + }, + "timestamp": int(__import__("time").time() * 1000) + }) + "\n") + except: pass + # #endregion + snapshot = await self.classroom_snapshot_updater.get_or_refresh_snapshot( classroom_id=classroom_id, - student_id=None, # Get all students for mapping + student_id=None, analysis_period_days=analysis_period_days, - force_full_refresh=False, # Use cache if available + force_full_refresh=False, ) classroom_data = snapshot.data if snapshot else None - logger.debug( - "[TeacherService] Pre-loaded classroom data from snapshot for classroom %s", - classroom_id, - ) + + # #region agent log + try: + with open(debug_log_path, "a", encoding="utf-8") as f: + f.write(json.dumps({ + "sessionId": "debug-session", + "runId": "run1", + "hypothesisId": "FLOW", + "location": "service.py:analyze_student:SNAPSHOT_RECEIVED", + "message": "Classroom snapshot received", + "data": { + "has_snapshot": snapshot is not None, + "has_classroom_data": classroom_data is not None, + "classroom_data_keys": list(classroom_data.keys())[:15] if classroom_data else [], + "students_count": len(classroom_data.get("students", [])) if classroom_data else 0 + }, + "timestamp": int(__import__("time").time() * 1000) + }) + "\n") + except: pass + # #endregion except Exception as e: logger.warning( "[TeacherService] Failed to pre-load classroom data: %s", e @@ -212,9 +268,10 @@ async def analyze_student( force_mock=force_mock, analysis_period_days=analysis_period_days, lang=lang, + context_bundle=context_bundle, + classroom_data=classroom_data, ) - # Add teacher_id to result for post-processing result["teacher_id"] = teacher_id if not classroom_data and classroom_id: @@ -223,10 +280,7 @@ async def analyze_student( snapshot = self.classroom_snapshot_store.get_snapshot(classroom_id) if snapshot: classroom_data = snapshot.data - logger.debug( - "[TeacherService] Retrieved classroom data from cache after agent run for classroom %s", - classroom_id, - ) + except Exception as e: logger.warning( "[TeacherService] Failed to get classroom data from cache: %s", e diff --git a/src/Services/AIService/app/features/teacher/student_analysis_agent.py b/src/Services/AIService/app/features/teacher/student_analysis_agent.py index 1fb001575..7c953cb56 100644 --- a/src/Services/AIService/app/features/teacher/student_analysis_agent.py +++ b/src/Services/AIService/app/features/teacher/student_analysis_agent.py @@ -1,4 +1,5 @@ from typing import Dict, Any, Optional, List +from collections import defaultdict import logging import json @@ -117,6 +118,8 @@ async def analyze_student( force_mock: bool = False, analysis_period_days: Optional[int] = 7, lang: Optional[str] = "vi", + context_bundle: Optional[Any] = None, + classroom_data: Optional[Dict[str, Any]] = None, ) -> Dict[str, Any]: """ High-level entrypoint for teacher to analyze a student or a classroom. @@ -137,10 +140,10 @@ async def analyze_student( if focus: question += f" Focus on: {focus}." - # Phase 1 – Planning (single LLM call) + # Phase 1 – Planning (LLM) plan: List[str] = await self._generate_plan(question) - # Phase 2 – Execute concrete tool pipeline (no extra LLM calls) + # Phase 2 – Execute concrete tool pipeline tool_results = await self._execute_analysis_tools( classroom_id=classroom_id, student_id=student_id, @@ -148,12 +151,14 @@ async def analyze_student( analysis_period_days=analysis_period_days, ) - # Phase 3 – Summarize for teacher (single LLM call) + # Phase 3 – Summarize for teacher (LLM) summary = await self._summarize_for_teacher( question=question, plan=plan, tool_results=tool_results, lang=lang, + context_bundle=context_bundle, + classroom_data=classroom_data, ) return { @@ -184,8 +189,17 @@ async def _execute_analysis_tools( # 1) Student & class snapshot-backed data student_data_tool = self.tool_registry.get_tool("student_data") + + logger.info( + "[StudentAnalysisAgent] Executing analysis tools | " + "classroom_id=%s, student_id=%s, force_mock=%s, analysis_period_days=%s", + classroom_id, + student_id, + force_mock, + analysis_period_days, + ) + if student_data_tool and classroom_id is not None: - # Student-level overview (if student_id is provided) if student_id: try: student_overview_raw = await student_data_tool.run( @@ -214,6 +228,10 @@ async def _execute_analysis_tools( } ) results["class_overview"] = json.loads(class_overview_raw) + logger.info( + "[StudentAnalysisAgent] Class overview: %s", + results["class_overview"], + ) except Exception as exc: logger.warning( "[StudentAnalysisAgent] class_overview failed: %s", exc @@ -229,83 +247,22 @@ async def _execute_analysis_tools( } ) results["detailed_classroom_data"] = json.loads(detailed_data_raw) + logger.info( + "[StudentAnalysisAgent] Detailed classroom data (summarized): %s", + results["detailed_classroom_data"], + ) except Exception as exc: - # If detailed_data action doesn't exist, try to get raw snapshot data - logger.debug( - "[StudentAnalysisAgent] detailed_data action not available, attempting fallback: %s", exc + logger.warning( + "[StudentAnalysisAgent] detailed_data failed: %s", exc ) - # Fallback: Try to get raw data directly - try: - if hasattr(student_data_tool, '_get_classroom_data'): - raw_data = await student_data_tool._get_classroom_data( - classroom_id=classroom_id, - student_id=None, - force_mock=force_mock, - analysis_period_days=analysis_period_days, - ) - # Extract key detailed fields (handle both camelCase and snake_case) - quiz_attempts = raw_data.get("quizAttempts", []) or raw_data.get("quiz_attempts", []) - assignments = raw_data.get("studentAssignments", []) or raw_data.get("student_assignments", []) - section_progress = raw_data.get("sectionProgress", []) or raw_data.get("section_progress", []) - engagement = raw_data.get("engagementMetrics", []) or raw_data.get("engagement_metrics", []) - student_quizzes = raw_data.get("studentQuizzes", []) or raw_data.get("student_quizzes", []) - - detailed_summary = { - "quizAttempts": quiz_attempts, - "studentAssignments": assignments, - "sectionProgress": section_progress, - "engagementMetrics": engagement, - "studentQuizzes": student_quizzes, - } - # Count and summarize for AI - if quiz_attempts: - quiz_scores = [ - q.get("totalScore") or q.get("total_score", 0) - for q in quiz_attempts - if q.get("totalScore") or q.get("total_score") - ] - detailed_summary["quiz_summary"] = { - "total_attempts": len(quiz_attempts), - "completed_attempts": len([q for q in quiz_attempts if q.get("status") in ["Passed", "Completed"]]), - "average_score": round(sum(quiz_scores) / len(quiz_scores), 2) if quiz_scores else 0, - "scores": quiz_scores, - } - if assignments: - assignment_scores = [ - a.get("finalScore") or a.get("final_score", 0) - for a in assignments - if a.get("finalScore") or a.get("final_score") - ] - detailed_summary["assignment_summary"] = { - "total_assignments": len(assignments), - "submitted_count": len([a for a in assignments if a.get("finalScore") or a.get("final_score")]), - "average_score": round(sum(assignment_scores) / len(assignment_scores), 2) if assignment_scores else 0, - "scores": assignment_scores, - } - if section_progress: - detailed_summary["section_summary"] = { - "total_sections": len(section_progress), - "completed_count": len([s for s in section_progress if s.get("status") == "Completed"]), - "in_progress_count": len([s for s in section_progress if s.get("status") == "InProgress"]), - } - if engagement: - completion_rates = [ - e.get("completionRate") or e.get("completion_rate", 0) - for e in engagement - if e.get("completionRate") or e.get("completion_rate") - ] - detailed_summary["engagement_summary"] = { - "students_with_data": len(engagement), - "average_completion_rate": round(sum(completion_rates) / len(completion_rates), 3) if completion_rates else 0, - } - results["detailed_classroom_data"] = detailed_summary - except Exception as fallback_exc: - logger.warning( - "[StudentAnalysisAgent] Failed to get detailed data (fallback): %s", fallback_exc - ) # 2) Performance analysis (Neo4j patterns per student) performance_tool = self.tool_registry.get_tool("performance_analysis") + logger.info( + "[StudentAnalysisAgent] Executing performance analysis tools | " + "student_id=%s", + student_id, + ) if performance_tool and student_id: try: performance_raw = await performance_tool.run( @@ -322,6 +279,11 @@ async def _execute_analysis_tools( # 3) Pattern recognition (class-level and/or student-level) pattern_tool = self.tool_registry.get_tool("pattern_recognition") + logger.info( + "[StudentAnalysisAgent] Executing pattern recognition tools | " + "student_id=%s", + student_id, + ) if pattern_tool: # Student struggles/excels if student_id: @@ -365,6 +327,14 @@ async def _execute_analysis_tools( "classroom_id": classroom_id, } ) + logger.info( + "[StudentAnalysisAgent] Pattern recognition (class) struggles: %s", + class_struggles_raw, + ) + logger.info( + "[StudentAnalysisAgent] Pattern recognition (class) excels: %s", + class_excels_raw, + ) results["pattern_class_struggles"] = json.loads( class_struggles_raw ) @@ -383,14 +353,193 @@ async def _summarize_for_teacher( plan: List[str], tool_results: Dict[str, Any], lang: Optional[str], + context_bundle: Optional[Any] = None, + classroom_data: Optional[Dict[str, Any]] = None, ) -> str: """ Final LLM summarization step that turns structured data into a teacher-friendly narrative. """ + from datetime import datetime, timezone + now = datetime.now(timezone.utc) + current_date_str = now.strftime("%Y-%m-%d") + current_datetime_str = now.strftime("%Y-%m-%d %H:%M:%S UTC") + + from datetime import datetime, timezone + # Get current date/time for AI to understand timeline context + now = datetime.now(timezone.utc) + current_date_str = now.strftime("%Y-%m-%d") + current_datetime_str = now.strftime("%Y-%m-%d %H:%M:%S UTC") + + enrollment_context = {} + if classroom_data: + + students = classroom_data.get("students", []) + for student in students: + student_id = student.get("student_id") + joined_at_str = student.get("joined_at") + if student_id and joined_at_str: + try: + if isinstance(joined_at_str, str): + if joined_at_str.endswith("Z"): + joined_at = datetime.fromisoformat(joined_at_str.replace("Z", "+00:00")) + else: + joined_at = datetime.fromisoformat(joined_at_str) + if joined_at.tzinfo is None: + joined_at = joined_at.replace(tzinfo=timezone.utc) + + days_enrolled = (now - joined_at).days + enrollment_context[student_id] = { + "days_enrolled": days_enrolled, + "joined_at": joined_at_str, + } + except Exception as e: + logger.warning( + f"[StudentAnalysisAgent] Failed to parse joined_at for student {student_id}: {e}" + ) + + # Extract RAG context from context_bundle + rag_context = "" + if context_bundle and hasattr(context_bundle, "items"): + rag_items = [] + for item in context_bundle.items[:5]: + rag_items.append(f"- {item.content[:200]}...") # Truncate long content + if rag_items: + rag_context = "\n\nRELEVANT CONTEXT FROM KNOWLEDGE BASE:\n" + "\n".join(rag_items) + + slimmed_results: Dict[str, Any] = {} + try: - # Build a compact JSON context for the LLM - context_json = json.dumps(tool_results, ensure_ascii=False) + # Keep student_overview and class_overview as-is (already compact) + if tool_results.get("student_overview"): + slimmed_results["student_overview"] = tool_results["student_overview"] + if tool_results.get("class_overview"): + slimmed_results["class_overview"] = tool_results["class_overview"] + + detailed = tool_results.get("detailed_classroom_data") or {} + if detailed: + progress_summaries = None + if "student_progress_summaries" in detailed: + progress_summaries = detailed["student_progress_summaries"] + elif "studentProgressSummaries" in detailed: + progress_summaries = detailed["studentProgressSummaries"] + + quiz_attempts = detailed.get("quizAttempts", []) or detailed.get("quiz_attempts", []) + wrong_answers = [] + for attempt in quiz_attempts[:10]: # Limit to recent 10 attempts + student_quiz_id = attempt.get("student_quiz_id") + total_score = attempt.get("total_score", 0) + status = attempt.get("status") + started_at = attempt.get("started_at") + question_attempts = attempt.get("question_attempts", []) + + # Collect wrong answers with question details + for qa in question_attempts: + if not qa.get("is_correct", True): + wrong_answers.append({ + "student_quiz_id": student_quiz_id, + "question_content": qa.get("question_content", ""), + "answer_content": qa.get("answer_content", ""), + "question_type": qa.get("question_type", ""), + "topics": qa.get("topics", []), + "quiz_score": total_score, + "quiz_status": status, + "started_at": started_at, + }) + + # Extract quiz titles from studentQuizzes + student_quizzes = detailed.get("studentQuizzes", []) or detailed.get("student_quizzes", []) + quiz_info = [] + for sq in student_quizzes[:20]: # Limit to 20 quizzes + if sq.get("final_score", 0) > 0 or sq.get("attempt_count", 0) > 0: + quiz_info.append({ + "quiz_id": sq.get("id"), + "quiz_title": sq.get("quiz_title", ""), + "final_score": sq.get("final_score", 0), + "attempt_count": sq.get("attempt_count", 0), + "student_id": sq.get("student_id"), + }) + + # Extract in-progress sections with names + section_progress = detailed.get("sectionProgress", []) or detailed.get("section_progress", []) + in_progress_sections = [] + completed_sections_recent = [] + for sp in section_progress: + status_val = sp.get("status", "") + if status_val == "InProgress": + in_progress_sections.append({ + "student_id": sp.get("student_id"), + "section_id": sp.get("section_id"), + "section_name": sp.get("section_name", ""), + "last_activity_at": sp.get("last_activity_at"), + }) + elif status_val == "Completed": + # Keep recent completed sections (last 10 per student) + completed_sections_recent.append({ + "student_id": sp.get("student_id"), + "section_id": sp.get("section_id"), + "section_name": sp.get("section_name", ""), + "last_activity_at": sp.get("last_activity_at"), + }) + + # Group completed sections by student and keep only recent ones + student_completed = defaultdict(list) + for cs in completed_sections_recent: + student_completed[cs["student_id"]].append(cs) + + recent_completed = [] + for student_id, sections in student_completed.items(): + # Sort by last_activity_at descending and take top 5 + sorted_sections = sorted( + sections, + key=lambda x: x.get("last_activity_at", ""), + reverse=True + )[:5] + recent_completed.extend(sorted_sections) + + student_assignments = detailed.get("studentAssignments", []) or detailed.get("student_assignments", []) + submitted_assignments = [] + for sa in student_assignments: + if sa.get("submission_count", 0) > 0: + submitted_assignments.append({ + "student_id": sa.get("student_id"), + "final_score": sa.get("final_score", 0), + "submitted_at": sa.get("submitted_at"), + "due_date": sa.get("due_date"), + "submission_count": sa.get("submission_count", 0), + }) + + slimmed_detailed: Dict[str, Any] = { + "classroom_id": detailed.get("classroom_id"), + "student_progress_summaries": progress_summaries, + "quiz_summary": detailed.get("quiz_summary"), + "assignment_summary": detailed.get("assignment_summary"), + "section_summary": detailed.get("section_summary"), + "engagement_summary": detailed.get("engagement_summary"), + "wrong_answers": wrong_answers[:20], + "quiz_info": quiz_info, + "in_progress_sections": in_progress_sections, + "recent_completed_sections": recent_completed[:30], + "submitted_assignments": submitted_assignments, + } + slimmed_results["detailed_classroom_data"] = slimmed_detailed + + # Performance and pattern tools usually return already-aggregated JSON. + for key in [ + "performance_patterns", + "pattern_student_struggles", + "pattern_student_excels", + "pattern_class_struggles", + "pattern_class_excels", + ]: + if key in tool_results: + slimmed_results[key] = tool_results[key] + + # Add enrollment context to slimmed_results + if enrollment_context: + slimmed_results["enrollment_context"] = enrollment_context + + context_json = json.dumps(slimmed_results, ensure_ascii=False) except Exception: context_json = "{}" @@ -400,39 +549,93 @@ async def _summarize_for_teacher( f"{self.get_system_prompt()}\n\n" f"Teacher question/context:\n{question}\n\n" f"Planned steps:\n- " + "\n- ".join(plan or []) + "\n\n" + f"CURRENT DATE/TIME CONTEXT:\n" + f"- Today's date: {current_date_str}\n" + f"- Current date and time: {current_datetime_str}\n" + f"- Use this as reference when analyzing dates in the data (started_at, submitted_at, due_date, last_activity_at, joined_at).\n" + f"- Calculate days since events by comparing with today's date.\n" + f"- Identify overdue assignments by comparing due_date with today's date.\n" + f"- Assess recency of activities (e.g., 'completed 2 days ago' means {current_date_str} minus 2 days).\n\n" "You also have structured data from tools (JSON below). " "Use it as the primary source of truth for metrics and patterns:\n\n" f"{context_json}\n\n" "IMPORTANT: Student names are available in the 'students' array within the classroom data. " "ALWAYS use student names (e.g., 'Nhan Thanh', 'Man Trieu') instead of student IDs (UUIDs) when referring to students in your response.\n\n" "CRITICAL DATA INTERPRETATION RULES:\n" - "- If 'class_overview' shows average_completion_rate=0.0 or average_score=0.0, " - "ALWAYS check 'detailed_classroom_data' for actual quizAttempts, studentAssignments, " - "sectionProgress, and engagementMetrics.\n" - "- The aggregated metrics in 'class_overview' may be incomplete or incorrectly calculated. " - "The detailed data (quizAttempts, assignments, sectionProgress) is the TRUE source of truth.\n" - "- If detailed_classroom_data shows quizAttempts with scores > 0, assignments with finalScore > 0, " - "or sectionProgress with Completed status, then students HAVE been learning and submitting work.\n" - "- Do NOT conclude 'no data' or 'students haven't submitted' if detailed_classroom_data shows " - "actual quiz attempts, assignment submissions, or completed sections.\n" - "- When analyzing mistakes or weaknesses, examine ALL quiz attempts for each student across different quizzes. " - "If a student answered correctly in one quiz but incorrectly in another, mention this nuance. " - "Do NOT say 'all students made the same mistake' if even one student got it right in any quiz.\n" - "- When evaluating student status (AtRisk, Good, etc.), consider:\n" - " * Quiz scores and assignment scores (quality of work)\n" - " * Number of completed sections (progress)\n" - " * Engagement metrics (completionRate, activeDays)\n" - " * Do NOT rely solely on aggregated average_completion_rate if it contradicts detailed data.\n\n" + "- Use the summary fields (quiz_summary, assignment_summary, section_summary) for overall statistics.\n" + "- Use detailed fields (wrong_answers, quiz_info, in_progress_sections) for specific, actionable insights.\n" + "- In 'student_progress_summaries', interpret:\n" + " * assessment_completion_rate as progress on quizzes and assignments only.\n" + " * content_completion_rate as progress on reading/section content (theory + activities).\n" + "- If content_completion_rate is high but assessment_completion_rate is low, DO NOT label the " + "student as 'AtRisk' solely because of low assessment completion.\n" + " * In that case, describe them as having engaged with content but needing more formal assessments.\n" + "- Only consider a student truly 'AtRisk' when there is evidence such as:\n" + " * consistently low quiz/assignment scores despite sufficient assessment attempts, and/or\n" + " * long inactivity (high days_since_last_activity) combined with low content and assessment progress.\n" + "- If quiz_summary, assignment_summary, or section_summary show real activity (scores > 0, " + "completed sections, submitted assignments), do NOT conclude that 'students haven't submitted' " + "or that there is no data.\n" + "- When analyzing mistakes or weaknesses, use 'wrong_answers' array to identify SPECIFIC questions students got wrong:\n" + " * Mention the actual question content and the wrong answer they selected.\n" + " * Group similar mistakes to identify learning gaps (e.g., 'students struggle with questions about servo motor').\n" + " * Use 'quiz_info' to identify which quizzes students have attempted and their scores.\n" + "- When analyzing progress over time (use current date {current_date_str} as reference):\n" + " * Use 'in_progress_sections' to see what students are currently working on.\n" + " * Use 'recent_completed_sections' with 'last_activity_at' to understand learning sequence and pace.\n" + " * Calculate days since last activity: compare 'last_activity_at' with today ({current_date_str}).\n" + " * Use 'submitted_assignments' with 'submitted_at' and 'due_date' to assess timeliness:\n" + " - If 'due_date' is before today, the assignment is OVERDUE.\n" + " - If 'submitted_at' is close to 'due_date', student submitted on time.\n" + " * Compare 'started_at' from wrong_answers with today to identify if mistakes are recent or from earlier attempts.\n" + " * When mentioning dates, use relative terms like '2 ngày trước' (2 days ago) or 'tuần trước' (last week) based on comparison with today.\n" + "- When evaluating student status, consider:\n" + " * assessment_completion_rate and related quiz/assignment scores.\n" + " * content_completion_rate and number of completed sections.\n" + " * Engagement metrics (completionRate, activeDays, days_since_last_activity).\n" + " * Specific mistakes from wrong_answers array.\n" + " * Do NOT rely solely on a single percentage if it contradicts the detailed summaries.\n" + "- ENROLLMENT ADJUSTMENT: When evaluating student progress, consider how long they have been enrolled:\n" + " * If a student enrolled recently (less than 7 days), their lower completion rates are EXPECTED and NORMAL.\n" + " * For new students (enrolled < 7 days), focus on engagement quality rather than quantity.\n" + " * Compare progress relative to enrollment duration, not absolute numbers.\n" + " * Example: A student enrolled 2 days ago with 20% completion is actually doing well, not poorly.\n" + f"{rag_context}\n\n" + "WRITING STYLE REQUIREMENTS:\n" + "- Use NATURAL, CONVERSATIONAL language as if talking directly to the teacher.\n" + "- AVOID technical jargon, abbreviations, or code-like terms. For example:\n" + " * Instead of 'assessment_completion_rate is 0.75', say 'học sinh đã hoàn thành 75% các bài kiểm tra'\n" + " * Instead of 'student_id c06ff241...', say 'học sinh Nhan Thanh'\n" + " * Instead of 'AtRisk status', say 'học sinh cần được quan tâm đặc biệt' hoặc 'học sinh có nguy cơ tụt hậu'\n" + " * Instead of 'engagement metrics', say 'mức độ tham gia học tập'\n" + " * Instead of 'section_progress', say 'tiến độ học tập theo từng phần'\n" + "- Use Vietnamese educational terminology naturally:\n" + " * 'bài kiểm tra' instead of 'quiz'\n" + " * 'bài tập' instead of 'assignment'\n" + " * 'phần học' or 'chương' instead of 'section'\n" + " * 'điểm số' instead of 'score'\n" + " * 'hoàn thành' instead of 'completed'\n" + "- When mentioning specific data, make it conversational:\n" + " * 'Trong bài kiểm tra về cầu nâng, học sinh đã trả lời sai câu hỏi về chức năng của servo motor'\n" + " * 'Học sinh đang làm bài tập ở phần \"Lập trình micro:bit\"'\n" + " * 'Học sinh đã nộp bài tập đúng hạn và đạt điểm 85'\n" + "- Structure your response in a friendly, supportive tone that helps teachers understand and act.\n\n" "TASK:\n" - f"- Write a concise, well-structured analysis for the teacher in language='{lang_hint}'.\n" + f"- Write a comprehensive, well-structured analysis for the teacher in language='{lang_hint}'.\n" "- Use student names (from classroom.students) instead of student IDs when referring to students.\n" "- Do NOT include teacher IDs or technical IDs in the response - use natural language only.\n" - "- Include: current status, key strengths, key weaknesses, and 1–3 practical interventions.\n" + "- Include: current status, key strengths, key weaknesses with SPECIFIC examples from wrong_answers, " + "and 1–3 practical interventions.\n" "- If a specific student is provided, focus on that student but reference class context when helpful.\n" - "- Base your analysis on detailed_classroom_data when available, not just aggregated metrics.\n" + "- Use detailed data (wrong_answers, quiz_info, in_progress_sections) to provide SPECIFIC, ACTIONABLE insights:\n" + " * Mention specific questions students got wrong and what they answered incorrectly.\n" + " * Identify which quizzes students have completed and their performance.\n" + " * Point out what sections students are currently working on.\n" + " * Analyze patterns over time using dates (started_at, submitted_at, last_activity_at).\n" "- When identifying patterns, be precise: if a student made a mistake in one quiz but got it right in another, " - "mention this as 'inconsistent understanding' rather than saying they always get it wrong.\n" - "- Do NOT repeat the raw JSON; summarize it into natural language.\n" + "mention this as 'hiểu chưa vững' or 'cần củng cố thêm' rather than saying they always get it wrong.\n" + "- Do NOT repeat the raw JSON; summarize it into natural, conversational language.\n" + "- Make your analysis feel like a helpful colleague explaining student progress, not a technical report.\n" ) messages = [{"role": "user", "content": prompt}] @@ -451,8 +654,6 @@ async def _summarize_for_teacher( f"tool_results={tool_results_json}" ) - # Use higher max_tokens for summarization to avoid truncation - # Prompt is ~3800 chars, need enough tokens for full response response = await self.llm.generate( messages, use_remote=self.use_remote, diff --git a/src/Services/AIService/app/infrastructure/config/settings.py b/src/Services/AIService/app/infrastructure/config/settings.py index f4574a938..9ee3afba3 100644 --- a/src/Services/AIService/app/infrastructure/config/settings.py +++ b/src/Services/AIService/app/infrastructure/config/settings.py @@ -239,7 +239,13 @@ class Settings(BaseSettings): CLASSROOM_SNAPSHOT_REFRESH_COOLDOWN_SECONDS: int = 60 # RabbitMQ / Event Bus - RABBITMQ_URL: str = os.getenv("RABBITMQ_URL", "amqp://guest:guest@localhost:5672/") + # Aspire exposes connection strings via ConnectionStrings__{resource_name} + # Fallback to RABBITMQ_URL or default localhost + RABBITMQ_URL: str = ( + os.getenv("ConnectionStrings__messaging") or + os.getenv("RABBITMQ_URL") or + "amqp://guest:guest@localhost:5672/" + ) RABBITMQ_QUEUE_CLASSROOM_PROGRESS: str = "classroom-student-progress-updated" ENABLE_EVENT_CONSUMER: bool = os.getenv("ENABLE_EVENT_CONSUMER", "true").lower() == "true" diff --git a/src/Services/AIService/app/infrastructure/data/grpc_classroom_repository.py b/src/Services/AIService/app/infrastructure/data/grpc_classroom_repository.py index 82aad0824..0b41e14c0 100644 --- a/src/Services/AIService/app/infrastructure/data/grpc_classroom_repository.py +++ b/src/Services/AIService/app/infrastructure/data/grpc_classroom_repository.py @@ -234,6 +234,12 @@ def _map_snapshot_to_classroom_data( enrollment_type = None if enrollment_proto.HasField("enrollment_type") and enrollment_proto.enrollment_type.value: enrollment_type = enrollment_proto.enrollment_type.value + try: + if enrollment_proto.HasField("course_id") and enrollment_proto.course_id.value: + enrollment_data["course_id"] = enrollment_proto.course_id.value + except ValueError: + if hasattr(enrollment_proto, "course_id") and enrollment_proto.course_id: + enrollment_data["course_id"] = enrollment_proto.course_id if enrollment_proto.HasField("curriculum_name") and enrollment_proto.curriculum_name.value: enrollment_data["curriculum_name"] = enrollment_proto.curriculum_name.value @@ -248,6 +254,12 @@ def _map_snapshot_to_classroom_data( "student_id": quiz_proto.student_id, "final_score": quiz_proto.final_score, } + try: + if quiz_proto.HasField("quiz_id") and quiz_proto.quiz_id.value: + quiz_data["quiz_id"] = quiz_proto.quiz_id.value + except ValueError: + if hasattr(quiz_proto, "quiz_id") and quiz_proto.quiz_id: + quiz_data["quiz_id"] = quiz_proto.quiz_id if quiz_proto.quiz_title: quiz_data["quiz_title"] = quiz_proto.quiz_title if quiz_proto.HasField("quiz_description") and quiz_proto.quiz_description.value: @@ -394,12 +406,104 @@ def _map_snapshot_to_classroom_data( classroom_data["topics_catalog"].append(topic_data) + classroom_data["student_progress_summaries"] = [] + + if hasattr(snapshot_proto, "student_progress_summaries") and snapshot_proto.student_progress_summaries: + for summary_proto in snapshot_proto.student_progress_summaries: + summary_data = { + "student_id": summary_proto.student_id, + "assessment_completion_rate": summary_proto.assessment_completion_rate, + "total_assessments": summary_proto.total_assessments, + "completed_assessments": summary_proto.completed_assessments, + "content_completion_rate": summary_proto.content_completion_rate, + "total_sections": summary_proto.total_sections, + "completed_sections": summary_proto.completed_sections, + } + classroom_data["student_progress_summaries"].append(summary_data) + else: + student_ids = set() + + for student_data in classroom_data["students"]: + student_ids.add(student_data["student_id"]) + + for quiz_data in classroom_data["quizzes"]["student_quizzes"]: + if quiz_data.get("student_id"): + student_ids.add(quiz_data["student_id"]) + + for assignment_data in classroom_data["assignments"]["student_assignments"]: + if assignment_data.get("student_id"): + student_ids.add(assignment_data["student_id"]) + + for progress_data in classroom_data["progress"]["section_progress"]: + if progress_data.get("student_id"): + student_ids.add(progress_data["student_id"]) + + for engagement_data in classroom_data["time_metrics"]["engagement_metrics"]: + if engagement_data.get("student_id"): + student_ids.add(engagement_data["student_id"]) + + for student_id in student_ids: + student_quizzes_map = { + quiz_data["id"]: quiz_data + for quiz_data in classroom_data["quizzes"]["student_quizzes"] + if quiz_data["student_id"] == student_id + } + total_quizzes = set(student_quizzes_map.keys()) + + completed_quizzes = set() + for attempt in classroom_data["quizzes"]["quiz_attempts"]: + student_quiz_id = attempt.get("student_quiz_id") + if student_quiz_id in student_quizzes_map: + if attempt.get("status") == "Passed" or attempt.get("completed_at"): + completed_quizzes.add(student_quiz_id) + + completed_assignments = 0 + total_assignments = 0 + for assignment_data in classroom_data["assignments"]["student_assignments"]: + if assignment_data["student_id"] == student_id: + total_assignments += 1 + if assignment_data.get("submission_count", 0) > 0: + completed_assignments += 1 + + total_assessments = len(total_quizzes) + total_assignments + completed_assessments = len(completed_quizzes) + completed_assignments + assessment_completion_rate = ( + completed_assessments / total_assessments + if total_assessments > 0 else 0.0 + ) + + # Count sections progress + total_sections = 0 + completed_sections = 0 + for progress_data in classroom_data["progress"]["section_progress"]: + if progress_data["student_id"] == student_id: + total_sections += 1 + if progress_data.get("status") == "Completed": + completed_sections += 1 + + content_completion_rate = ( + completed_sections / total_sections + if total_sections > 0 else 0.0 + ) + + summary_data = { + "student_id": student_id, + "assessment_completion_rate": assessment_completion_rate, + "total_assessments": total_assessments, + "completed_assessments": completed_assessments, + "content_completion_rate": content_completion_rate, + "total_sections": total_sections, + "completed_sections": completed_sections, + } + classroom_data["student_progress_summaries"].append(summary_data) + logger.info( "Mapped learning snapshot to classroom data format", extra={ "students_count": len(classroom_data["students"]), "quizzes_count": len(classroom_data["quizzes"]["student_quizzes"]), "assignments_count": len(classroom_data["assignments"]["student_assignments"]), + "progress_summaries_count": len(classroom_data["student_progress_summaries"]), } ) diff --git a/src/Services/AIService/app/infrastructure/events/rabbitmq_consumer.py b/src/Services/AIService/app/infrastructure/events/rabbitmq_consumer.py index 4e1870e9f..9f067c3b4 100644 --- a/src/Services/AIService/app/infrastructure/events/rabbitmq_consumer.py +++ b/src/Services/AIService/app/infrastructure/events/rabbitmq_consumer.py @@ -33,12 +33,11 @@ async def connect(self) -> None: extra={"url": settings.RABBITMQ_URL.split("@")[-1] if "@" in settings.RABBITMQ_URL else "***"}, ) except Exception as e: - logger.error( - "[ClassroomProgressEventConsumer] Failed to connect to RabbitMQ: %s. Event consumer will be disabled.", + logger.warning( + "[ClassroomProgressEventConsumer] Failed to connect to RabbitMQ: %s. Event consumer will be disabled. " + "This is OK if RabbitMQ is not available - the service will continue without event processing.", e, - exc_info=True, ) - # Don't raise - let the caller handle gracefully self._connection = None raise diff --git a/src/Services/AIService/scripts/test_trigger_progress_event.py b/src/Services/AIService/scripts/test_trigger_progress_event.py new file mode 100644 index 000000000..6b2acbbf3 --- /dev/null +++ b/src/Services/AIService/scripts/test_trigger_progress_event.py @@ -0,0 +1,179 @@ +""" +Test script to trigger ClassroomStudentProgressUpdatedEvent +This script publishes a test event to RabbitMQ to test the ingestion pipeline. +""" + +import asyncio +import json +import sys +from pathlib import Path + +# Add parent directory to path +sys.path.insert(0, str(Path(__file__).parent.parent)) + +import aio_pika +from app.infrastructure.config.settings import settings + + +async def publish_test_event( + classroom_id: int, + student_id: str, + course_enrollment_id: int = 1, + course_id: int = 1, + progress_percentage: int = 50, + status: str = "InProgress", +): + """ + Publish a test ClassroomStudentProgressUpdatedEvent to RabbitMQ + + Args: + classroom_id: Classroom ID + student_id: Student ID (UUID string) + course_enrollment_id: Course enrollment ID + course_id: Course ID + progress_percentage: Progress percentage (0-100) + status: Status string (e.g., "InProgress", "Completed") + """ + exchange_name = "EventBus.Messages:ClassroomStudentProgressUpdatedEvent" + routing_key = "EventBus.Messages:ClassroomStudentProgressUpdatedEvent" + + # Create event payload matching C# event structure + event_data = { + "StudentId": student_id, + "ClassroomId": classroom_id, + "CourseEnrollmentId": course_enrollment_id, + "CourseId": course_id, + "ProgressPercentage": progress_percentage, + "Status": status, + } + + print(f"Connecting to RabbitMQ at {settings.RABBITMQ_URL.split('@')[-1] if '@' in settings.RABBITMQ_URL else '***'}") + + try: + # Connect to RabbitMQ + connection = await aio_pika.connect_robust(settings.RABBITMQ_URL) + print("✓ Connected to RabbitMQ") + + async with connection: + channel = await connection.channel() + + # Declare exchange + try: + exchange = await channel.declare_exchange( + exchange_name, + aio_pika.ExchangeType.TOPIC, + durable=True, + ) + except Exception: + exchange = await channel.declare_exchange( + exchange_name, + aio_pika.ExchangeType.FANOUT, + durable=True, + ) + + print(f"✓ Exchange '{exchange_name}' declared") + + # Publish message + message_body = json.dumps(event_data).encode("utf-8") + message = aio_pika.Message( + body=message_body, + content_type="application/json", + delivery_mode=aio_pika.DeliveryMode.PERSISTENT, + ) + + await exchange.publish( + message, + routing_key=routing_key, + ) + + print(f"✓ Event published successfully!") + print(f"\nEvent details:") + print(f" Classroom ID: {classroom_id}") + print(f" Student ID: {student_id}") + print(f" Course Enrollment ID: {course_enrollment_id}") + print(f" Course ID: {course_id}") + print(f" Progress: {progress_percentage}%") + print(f" Status: {status}") + print(f"\nThe event should be consumed by ClassroomProgressEventConsumer") + print(f"and trigger RAG ingestion (with debouncing) for classroom {classroom_id}") + + except Exception as e: + print(f"✗ Error publishing event: {e}") + import traceback + traceback.print_exc() + return False + + return True + + +async def main(): + """Main function with example usage""" + import argparse + + parser = argparse.ArgumentParser( + description="Trigger ClassroomStudentProgressUpdatedEvent for testing" + ) + parser.add_argument( + "--classroom-id", + type=int, + required=True, + help="Classroom ID" + ) + parser.add_argument( + "--student-id", + type=str, + required=True, + help="Student ID (UUID string)" + ) + parser.add_argument( + "--course-enrollment-id", + type=int, + default=1, + help="Course enrollment ID (default: 1)" + ) + parser.add_argument( + "--course-id", + type=int, + default=1, + help="Course ID (default: 1)" + ) + parser.add_argument( + "--progress", + type=int, + default=50, + help="Progress percentage 0-100 (default: 50)" + ) + parser.add_argument( + "--status", + type=str, + default="InProgress", + help="Status (default: InProgress)" + ) + + args = parser.parse_args() + + success = await publish_test_event( + classroom_id=args.classroom_id, + student_id=args.student_id, + course_enrollment_id=args.course_enrollment_id, + course_id=args.course_id, + progress_percentage=args.progress, + status=args.status, + ) + + if success: + print("\n✓ Test event published successfully!") + print("\nTo verify:") + print("1. Check logs for '[ClassroomProgressEventConsumer] Received event'") + print("2. Check logs for '[IngestionService] Scheduled ingestion' (after debounce)") + print("3. Check logs for '[IngestionService] Starting ingestion' (after 5 minutes)") + else: + print("\n✗ Failed to publish test event") + sys.exit(1) + + +if __name__ == "__main__": + asyncio.run(main()) + + + From 7a4ec5bf32b9c325a93740f47fca731c7ce913c4 Mon Sep 17 00:00:00 2001 From: halinhtvn3a <77691576+halinhtvn3a@users.noreply.github.com> Date: Tue, 23 Dec 2025 12:46:05 +0700 Subject: [PATCH 29/29] Refine student status logic and improve agent prompts Removed debug logging from TeacherService and enhanced student status classification to account for new students based on enrollment duration. Student 'joined_at' is now included in overviews, and the student analysis agent now provides a mapping of student IDs to names for more natural responses. The agent prompt was streamlined for clarity, emphasizing the use of student names, improved date handling, and more concise, actionable guidance for teachers. --- .../AIService/app/features/teacher/service.py | 99 +++++++++-------- .../teacher/student_analysis_agent.py | 104 ++++++------------ 2 files changed, 83 insertions(+), 120 deletions(-) diff --git a/src/Services/AIService/app/features/teacher/service.py b/src/Services/AIService/app/features/teacher/service.py index 7950ec80a..bbc03d8c5 100644 --- a/src/Services/AIService/app/features/teacher/service.py +++ b/src/Services/AIService/app/features/teacher/service.py @@ -209,26 +209,6 @@ async def analyze_student( if classroom_id: try: if self.classroom_snapshot_updater and self.classroom_snapshot_store: - # #region agent log - import json - debug_log_path = r"d:\8_LASTCHANGE\STEMify-Backend\.cursor\debug.log" - try: - with open(debug_log_path, "a", encoding="utf-8") as f: - f.write(json.dumps({ - "sessionId": "debug-session", - "runId": "run1", - "hypothesisId": "FLOW", - "location": "service.py:analyze_student:GET_SNAPSHOT", - "message": "Getting classroom snapshot", - "data": { - "classroom_id": classroom_id, - "analysis_period_days": analysis_period_days - }, - "timestamp": int(__import__("time").time() * 1000) - }) + "\n") - except: pass - # #endregion - snapshot = await self.classroom_snapshot_updater.get_or_refresh_snapshot( classroom_id=classroom_id, student_id=None, @@ -236,26 +216,6 @@ async def analyze_student( force_full_refresh=False, ) classroom_data = snapshot.data if snapshot else None - - # #region agent log - try: - with open(debug_log_path, "a", encoding="utf-8") as f: - f.write(json.dumps({ - "sessionId": "debug-session", - "runId": "run1", - "hypothesisId": "FLOW", - "location": "service.py:analyze_student:SNAPSHOT_RECEIVED", - "message": "Classroom snapshot received", - "data": { - "has_snapshot": snapshot is not None, - "has_classroom_data": classroom_data is not None, - "classroom_data_keys": list(classroom_data.keys())[:15] if classroom_data else [], - "students_count": len(classroom_data.get("students", [])) if classroom_data else 0 - }, - "timestamp": int(__import__("time").time() * 1000) - }) + "\n") - except: pass - # #endregion except Exception as e: logger.warning( "[TeacherService] Failed to pre-load classroom data: %s", e @@ -613,6 +573,8 @@ def _create_student_overview( student_data: Dict[str, Any], use_overview_text: bool = False ) -> StudentOverview: + from datetime import datetime, timezone + completion_rate = _safe_float(student_data.get("completion_rate", 0.0)) average_score = _safe_float(student_data.get("average_score", 0.0)) engagement_score = _safe_float( @@ -624,15 +586,44 @@ def _create_student_overview( completion_rate * 100.0 if completion_rate > 0.0 else average_score ) - # Simple status classification aligned with recommendations behavior - if progress_percent < 50.0 or engagement_score < 0.3: - current_status = "AtRisk" - elif progress_percent < 70.0: - current_status = "NeedsSupport" - elif progress_percent < 90.0: - current_status = "Good" + # Calculate days enrolled if joined_at is available + days_enrolled = None + joined_at_str = student_data.get("joined_at") + if joined_at_str: + try: + if isinstance(joined_at_str, str): + if joined_at_str.endswith("Z"): + joined_at = datetime.fromisoformat(joined_at_str.replace("Z", "+00:00")) + else: + joined_at = datetime.fromisoformat(joined_at_str) + if joined_at.tzinfo is None: + joined_at = joined_at.replace(tzinfo=timezone.utc) + days_enrolled = (datetime.now(timezone.utc) - joined_at).days + except Exception: + pass + + is_new_student = days_enrolled is not None and days_enrolled < 7 + + if is_new_student: + if (engagement_score < 0.1 and progress_percent < 5.0) or \ + (average_score > 0 and average_score < 30.0 and progress_percent < 10.0): + current_status = "AtRisk" + elif progress_percent < 30.0: + current_status = "NeedsSupport" + elif progress_percent < 60.0: + current_status = "Good" + else: + current_status = "Excellent" else: - current_status = "Excellent" + # For established students, use original thresholds + if progress_percent < 50.0 or engagement_score < 0.3: + current_status = "AtRisk" + elif progress_percent < 70.0: + current_status = "NeedsSupport" + elif progress_percent < 90.0: + current_status = "Good" + else: + current_status = "Excellent" status_text = ( f"Học sinh hiện đạt khoảng {progress_percent:.1f}% tiến độ, " @@ -677,11 +668,22 @@ def _create_student_overview( if student_info: student_name = student_info.get("student_name") or student_info.get("studentName") + joined_at = None + if classroom_data: + all_students = classroom_data.get("students", []) + student_info = next( + (s for s in all_students if str(s.get("student_id", "") or s.get("studentId", "")) == sid), + None + ) + if student_info: + joined_at = student_info.get("joined_at") or student_info.get("joinedAt") + student_data = { "completion_rate": student_overview.get("completion_rate", 0.0), "average_score": student_overview.get("average_score", 0.0), "engagement_score": student_overview.get("engagement_score"), "student_name": student_name, + "joined_at": joined_at, # Include enrollment date } students.append(_create_student_overview(sid, student_data, use_overview_text=True)) elif classroom_data: @@ -738,6 +740,7 @@ def _create_student_overview( "completion_rate": completion_rate, "average_score": average_score, "engagement_score": engagement_score, + "joined_at": student.get("joined_at") or student.get("joinedAt"), # Include enrollment date } students.append(_create_student_overview(sid, student_data, use_overview_text=False)) diff --git a/src/Services/AIService/app/features/teacher/student_analysis_agent.py b/src/Services/AIService/app/features/teacher/student_analysis_agent.py index 7c953cb56..058e3be42 100644 --- a/src/Services/AIService/app/features/teacher/student_analysis_agent.py +++ b/src/Services/AIService/app/features/teacher/student_analysis_agent.py @@ -409,6 +409,18 @@ async def _summarize_for_teacher( slimmed_results: Dict[str, Any] = {} + student_id_to_name: Dict[str, str] = {} + if classroom_data: + students = classroom_data.get("students", []) + for student in students: + student_id = str(student.get("student_id", "") or student.get("studentId", "")) + student_name = student.get("student_name") or student.get("studentName") + if student_id and student_name: + student_id_to_name[student_id] = student_name + + if student_id_to_name: + slimmed_results["student_names"] = student_id_to_name + try: # Keep student_overview and class_overview as-is (already compact) if tool_results.get("student_overview"): @@ -549,93 +561,41 @@ async def _summarize_for_teacher( f"{self.get_system_prompt()}\n\n" f"Teacher question/context:\n{question}\n\n" f"Planned steps:\n- " + "\n- ".join(plan or []) + "\n\n" - f"CURRENT DATE/TIME CONTEXT:\n" - f"- Today's date: {current_date_str}\n" - f"- Current date and time: {current_datetime_str}\n" - f"- Use this as reference when analyzing dates in the data (started_at, submitted_at, due_date, last_activity_at, joined_at).\n" - f"- Calculate days since events by comparing with today's date.\n" - f"- Identify overdue assignments by comparing due_date with today's date.\n" - f"- Assess recency of activities (e.g., 'completed 2 days ago' means {current_date_str} minus 2 days).\n\n" + f"CURRENT DATE: {current_date_str} ({current_datetime_str}). Use to calculate days since events and identify overdue assignments.\n\n" "You also have structured data from tools (JSON below). " "Use it as the primary source of truth for metrics and patterns:\n\n" f"{context_json}\n\n" - "IMPORTANT: Student names are available in the 'students' array within the classroom data. " - "ALWAYS use student names (e.g., 'Nhan Thanh', 'Man Trieu') instead of student IDs (UUIDs) when referring to students in your response.\n\n" + "IMPORTANT: Use 'student_names' mapping (student_id -> student_name) to convert all student IDs to names. " + "ALWAYS use student names (e.g., 'Nhan Thanh', 'Man Trieu') instead of student IDs (UUIDs) when referring to students.\n" + "When you see student_id in wrong_answers, quiz_info, in_progress_sections, submitted_assignments, etc., look up the name in 'student_names'.\n\n" "CRITICAL DATA INTERPRETATION RULES:\n" "- Use the summary fields (quiz_summary, assignment_summary, section_summary) for overall statistics.\n" "- Use detailed fields (wrong_answers, quiz_info, in_progress_sections) for specific, actionable insights.\n" - "- In 'student_progress_summaries', interpret:\n" - " * assessment_completion_rate as progress on quizzes and assignments only.\n" - " * content_completion_rate as progress on reading/section content (theory + activities).\n" - "- If content_completion_rate is high but assessment_completion_rate is low, DO NOT label the " - "student as 'AtRisk' solely because of low assessment completion.\n" - " * In that case, describe them as having engaged with content but needing more formal assessments.\n" + "- assessment_completion_rate = quizzes/assignments; content_completion_rate = reading/sections.\n" + "- If content_completion_rate is high but assessment_completion_rate is low, describe as 'engaged with content but needing more assessments', not 'AtRisk'.\n" "- Only consider a student truly 'AtRisk' when there is evidence such as:\n" " * consistently low quiz/assignment scores despite sufficient assessment attempts, and/or\n" " * long inactivity (high days_since_last_activity) combined with low content and assessment progress.\n" - "- If quiz_summary, assignment_summary, or section_summary show real activity (scores > 0, " - "completed sections, submitted assignments), do NOT conclude that 'students haven't submitted' " - "or that there is no data.\n" + "- If summaries show activity (scores > 0, completed sections), do NOT say 'no data' or 'students haven't submitted'.\n" "- When analyzing mistakes or weaknesses, use 'wrong_answers' array to identify SPECIFIC questions students got wrong:\n" " * Mention the actual question content and the wrong answer they selected.\n" " * Group similar mistakes to identify learning gaps (e.g., 'students struggle with questions about servo motor').\n" " * Use 'quiz_info' to identify which quizzes students have attempted and their scores.\n" - "- When analyzing progress over time (use current date {current_date_str} as reference):\n" - " * Use 'in_progress_sections' to see what students are currently working on.\n" - " * Use 'recent_completed_sections' with 'last_activity_at' to understand learning sequence and pace.\n" - " * Calculate days since last activity: compare 'last_activity_at' with today ({current_date_str}).\n" - " * Use 'submitted_assignments' with 'submitted_at' and 'due_date' to assess timeliness:\n" - " - If 'due_date' is before today, the assignment is OVERDUE.\n" - " - If 'submitted_at' is close to 'due_date', student submitted on time.\n" - " * Compare 'started_at' from wrong_answers with today to identify if mistakes are recent or from earlier attempts.\n" - " * When mentioning dates, use relative terms like '2 ngày trước' (2 days ago) or 'tuần trước' (last week) based on comparison with today.\n" - "- When evaluating student status, consider:\n" - " * assessment_completion_rate and related quiz/assignment scores.\n" - " * content_completion_rate and number of completed sections.\n" - " * Engagement metrics (completionRate, activeDays, days_since_last_activity).\n" - " * Specific mistakes from wrong_answers array.\n" - " * Do NOT rely solely on a single percentage if it contradicts the detailed summaries.\n" - "- ENROLLMENT ADJUSTMENT: When evaluating student progress, consider how long they have been enrolled:\n" - " * If a student enrolled recently (less than 7 days), their lower completion rates are EXPECTED and NORMAL.\n" - " * For new students (enrolled < 7 days), focus on engagement quality rather than quantity.\n" - " * Compare progress relative to enrollment duration, not absolute numbers.\n" - " * Example: A student enrolled 2 days ago with 20% completion is actually doing well, not poorly.\n" + "- When analyzing progress over time:\n" + " * Use 'in_progress_sections', 'recent_completed_sections', 'submitted_assignments' with dates.\n" + " * Compare dates with today ({current_date_str}) to calculate days since events and identify overdue assignments.\n" + " * Use relative terms like '2 ngày trước' when mentioning dates.\n" + "- When evaluating student status, consider all metrics together, not just one percentage.\n" + "- For new students (<7 days enrolled), lower completion rates are normal - focus on engagement quality, not quantity.\n" f"{rag_context}\n\n" - "WRITING STYLE REQUIREMENTS:\n" - "- Use NATURAL, CONVERSATIONAL language as if talking directly to the teacher.\n" - "- AVOID technical jargon, abbreviations, or code-like terms. For example:\n" - " * Instead of 'assessment_completion_rate is 0.75', say 'học sinh đã hoàn thành 75% các bài kiểm tra'\n" - " * Instead of 'student_id c06ff241...', say 'học sinh Nhan Thanh'\n" - " * Instead of 'AtRisk status', say 'học sinh cần được quan tâm đặc biệt' hoặc 'học sinh có nguy cơ tụt hậu'\n" - " * Instead of 'engagement metrics', say 'mức độ tham gia học tập'\n" - " * Instead of 'section_progress', say 'tiến độ học tập theo từng phần'\n" - "- Use Vietnamese educational terminology naturally:\n" - " * 'bài kiểm tra' instead of 'quiz'\n" - " * 'bài tập' instead of 'assignment'\n" - " * 'phần học' or 'chương' instead of 'section'\n" - " * 'điểm số' instead of 'score'\n" - " * 'hoàn thành' instead of 'completed'\n" - "- When mentioning specific data, make it conversational:\n" - " * 'Trong bài kiểm tra về cầu nâng, học sinh đã trả lời sai câu hỏi về chức năng của servo motor'\n" - " * 'Học sinh đang làm bài tập ở phần \"Lập trình micro:bit\"'\n" - " * 'Học sinh đã nộp bài tập đúng hạn và đạt điểm 85'\n" - "- Structure your response in a friendly, supportive tone that helps teachers understand and act.\n\n" + "WRITING STYLE:\n" + "- Use natural Vietnamese, avoid technical terms. Use 'bài kiểm tra', 'bài tập', 'phần học' instead of 'quiz', 'assignment', 'section'.\n" + "- Write as a helpful colleague, not a technical report. Use student names, not IDs.\n\n" "TASK:\n" - f"- Write a comprehensive, well-structured analysis for the teacher in language='{lang_hint}'.\n" - "- Use student names (from classroom.students) instead of student IDs when referring to students.\n" - "- Do NOT include teacher IDs or technical IDs in the response - use natural language only.\n" - "- Include: current status, key strengths, key weaknesses with SPECIFIC examples from wrong_answers, " - "and 1–3 practical interventions.\n" - "- If a specific student is provided, focus on that student but reference class context when helpful.\n" - "- Use detailed data (wrong_answers, quiz_info, in_progress_sections) to provide SPECIFIC, ACTIONABLE insights:\n" - " * Mention specific questions students got wrong and what they answered incorrectly.\n" - " * Identify which quizzes students have completed and their performance.\n" - " * Point out what sections students are currently working on.\n" - " * Analyze patterns over time using dates (started_at, submitted_at, last_activity_at).\n" - "- When identifying patterns, be precise: if a student made a mistake in one quiz but got it right in another, " - "mention this as 'hiểu chưa vững' or 'cần củng cố thêm' rather than saying they always get it wrong.\n" - "- Do NOT repeat the raw JSON; summarize it into natural, conversational language.\n" - "- Make your analysis feel like a helpful colleague explaining student progress, not a technical report.\n" + f"- Write analysis in {lang_hint}: status, strengths, weaknesses (with specific examples from wrong_answers), and 1-3 interventions.\n" + "- Use wrong_answers, quiz_info, in_progress_sections for specific insights. Analyze patterns over time using dates.\n" + "- Be precise: if a student got it wrong in one quiz but right in another, say 'hiểu chưa vững' not 'always wrong'.\n" + "- Do NOT repeat JSON; summarize naturally.\n" ) messages = [{"role": "user", "content": prompt}]