feat: add teacher help cards

ai_knowledge_base_v2/apps/backend/app/api/admin_records.py

@@ -16,12 +16,13 @@ from app.core.dependencies import get_current_admin
 from app.core.responses import api_success
 from app.models.admin import Admin
 from app.models.chat import ChatMessage, ChatSession, TopicSession
-from app.models.growth import TopicSummary
+from app.models.growth import TeacherHelpCard, TopicSummary
 from app.models.logs import AiRequestLog, OperationLog
 from app.models.user import User
 from app.api.pagination import page_result
 from app.services.question_insight_service import QuestionInsightService
 from app.services.growth_profile_service import topic_dict, topic_summary_dict
+from app.services.help_card_service import help_card_dict
 
 router = APIRouter()
 
@@ -138,6 +139,16 @@ def chat_detail(
         .order_by(AiRequestLog.created_at.asc(), AiRequestLog.id.asc())
     ).all()
     topics = _topic_rows(db, session_id)
+    topic_ids = [item["id"] for item in topics]
+    help_cards = []
+    if topic_ids:
+        help_cards = list(
+            db.scalars(
+                select(TeacherHelpCard)
+                .where(TeacherHelpCard.topic_session_id.in_(topic_ids))
+                .order_by(TeacherHelpCard.created_at.desc(), TeacherHelpCard.id.desc())
+            )
+        )
     return api_success(
         {
             "session": _chat_row_dict(session, user),
@@ -150,6 +161,7 @@ def chat_detail(
             ),
             "aiLogs": [_ai_log_dict(item, include_prompt=True) for item in ai_logs],
             "topics": topics,
+            "helpCards": [help_card_dict(item) for item in help_cards],
         }
     )
 

ai_knowledge_base_v2/apps/backend/app/api/chat.py

@@ -31,6 +31,7 @@ from app.services.chat_queue_runtime import (
 from app.services.chat_queue_service import load_chat_queue_config
 from app.services.chat_stream_service import ChatStreamService
 from app.services.growth_profile_service import GrowthProfileService
+from app.services.help_card_service import HelpCardService, help_card_dict
 from app.services.reasoning_policy_service import ReasoningPolicyService
 
 router = APIRouter()
@@ -96,6 +97,35 @@ def finish_topic(
     return api_success(GrowthProfileService.finish_active_topic(db, user=current_user, session=session))
 
 
+@router.post("/session/{session_id}/help-card")
+def generate_help_card(
+    session_id: int,
+    db: Session = Depends(get_db),
+    current_user: User = Depends(get_current_user),
+) -> dict:
+    session = ChatService._get_user_session(db, current_user, session_id)
+    card = HelpCardService.generate_for_session(db, user=current_user, session=session)
+    return api_success(help_card_dict(card))
+
+
+@router.get("/help-card/list")
+def list_help_cards(
+    limit: int = Query(default=20, ge=1, le=50),
+    db: Session = Depends(get_db),
+    current_user: User = Depends(get_current_user),
+) -> dict:
+    return api_success([help_card_dict(card) for card in HelpCardService.list_user_cards(db, user=current_user, limit=limit)])
+
+
+@router.post("/help-card/{card_id}/copied")
+def mark_help_card_copied(
+    card_id: int,
+    db: Session = Depends(get_db),
+    current_user: User = Depends(get_current_user),
+) -> dict:
+    return api_success(help_card_dict(HelpCardService.mark_copied(db, user=current_user, card_id=card_id)))
+
+
 @router.post("/completions")
 def completions(
     payload: ChatCompletionRequest,