chore: finalize backend feature scope

README.md

@@ -2,7 +2,7 @@
 
 本项目是医疗教学平台中的 FastAPI 后端服务，负责医疗问诊训练、教学互动、AI 评价、PDF 报告、AI 学习助手，以及后台预留的机构知识库能力。
 
-本服务不负责登录注册、用户管理、病例 PDF 解析入库、病例增删改、多租户后台、HIS/LIS/PACS 对接。用户身份由 Django 用户中心验证，病例、检查项、教学题和评分规则由平台数据库维护。
+本服务不负责登录注册、用户管理、病例 PDF 解析入库、病例增删改、多租户后台、HIS/LIS/PACS 连接。用户身份由 Django 用户中心验证，病例、检查项、教学题和评分规则由平台数据库维护。
 
 ## 1. 当前功能
 
@@ -36,9 +36,10 @@
 
 AI 学习助手：
 
-- 普通用户通过 SSE 流式接口提问
+- 普通用户先新建 AI 学习助手短期会话，再通过 SSE 流式接口提问
 - 后端优先检索本机构知识库
 - 知识库未初始化或检索失败时，自动降级为大模型通用学习回答
+- 学习助手会话使用 Redis 短期缓存保存最近问答上下文，不写入训练记录
 
 后台预留能力：
 
@@ -182,10 +183,20 @@ curl "http://8.160.178.88/fastapi/api/v1/auth/me" \
   -H "X-Entry-Scene: production_vue"
 ```
 
-AI 学习助手流式问答：
+AI 学习助手新建会话：
 
 ```bash
-curl -N -X POST "http://8.160.178.88/fastapi/api/v1/learning-assistant/chat/stream" \
+curl -X POST "http://8.160.178.88/fastapi/api/v1/learning-assistant/sessions" \
+  -H "Authorization: Bearer <access_token>" \
+  -H "X-Entry-Scene: production_vue" \
+  -H "Content-Type: application/json" \
+  -d '{"title":"儿科肺炎知识复习"}'
+```
+
+AI 学习助手会话式流式问答：
+
+```bash
+curl -N -X POST "http://8.160.178.88/fastapi/api/v1/learning-assistant/sessions/<assistant_session_id>/chat/stream" \
   -H "Authorization: Bearer <access_token>" \
   -H "X-Entry-Scene: production_vue" \
   -H "Content-Type: application/json" \
@@ -195,6 +206,7 @@ curl -N -X POST "http://8.160.178.88/fastapi/api/v1/learning-assistant/chat/stre
 正常应看到：
 
 ```text
+event: session_ready
 event: retrieval_done
 event: answer_delta
 event: answer_done
@@ -216,13 +228,14 @@ event: answer_done
 | `docs/00_project_overview.md` | 项目总览和功能讲解顺序 |
 | `docs/01_architecture.md` | 系统架构、调用链路和模块边界 |
 | `docs/02_database.md` | 核心数据库表和读写边界 |
-| `docs/03_api_design.md` | 前端联调 API 文档 |
+| `docs/03_api_design.md` | 前端 API 文档 |
 | `docs/04_deployment.md` | 云服务器部署、更新和回滚 |
 | `docs/05_modules.md` | 功能模块说明 |
 | `docs/06_maintenance_guide.md` | 开发维护说明和风险清单 |
 | `docs/07_troubleshooting.md` | 常见故障排查 |
 | `docs/08_feature_code_map.md` | 功能到接口、代码和数据表的映射表 |
 | `docs/09_prompt_template_catalog.md` | 提示词模板目录和调用说明 |
+| `docs/10_function_workflow.md` | 功能工作流、提示词和数据流说明 |
 
 ## 10. 重要约定