feat: add teacher 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,