fastapi/docs/07_demo_function_traceability.md

Demo 功能追踪表

1. 功能到代码映射

功能	前端页面/按钮	API	Router 函数	Service / Agent	数据表	状态
Agent 入口连接	入口页“连接/进入”	GET /api/v1/agent/hello	agent.hello	AuditService.log	audit_logs	已实现
病例列表	病例页刷新	GET /api/v1/cases	cases.list_cases	CaseService.list_cases	case_base	已实现
病例详情	点击病例卡片	GET /api/v1/cases/{case_id}	cases.get_case_detail	CaseService.get_case_detail	case_base、traditional_case、teaching_case、case_exam_item	已实现
病例 SQL 预检	导入页“解析检查”	POST /api/v1/imports/case-sql/preview	imports.preview_case_sql	CaseSqlImportService.preview	不写库	已实现
病例 SQL 导入	导入页“确认导入”	POST /api/v1/imports/case-sql/apply	imports.apply_case_sql	CaseSqlImportService.apply、scripts.import_source_case_sql	case_base、traditional_case、teaching_case、scoring_rule、case_exam_item	已实现
创建训练会话	“创建训练会话”	POST /api/v1/sessions	sessions.create_session	SessionService.create_session	training_session、runtime memory	已实现
普通问诊	Chat“发送问诊”	POST /api/v1/sessions/{session_id}/chat	sessions.chat	SessionService.chat、PatientAgent.reply	runtime memory	已实现
流式问诊	Chat 流式开关开启	POST /api/v1/sessions/{session_id}/chat/stream	sessions.chat_stream	SessionService.stream_chat、PatientAgent.stream_reply	runtime memory	已实现
查看提示	Chat“查看提示”	POST /api/v1/sessions/{session_id}/hints	sessions.generate_hints	SessionService.generate_hints、HintAgent.generate	runtime memory、training_order	已实现
检查项目列表	检查面板刷新	GET /api/v1/sessions/{session_id}/order-items	sessions.list_order_items	OrderService.list_order_items	case_exam_item	已实现
申请检查	“申请该检查”	POST /api/v1/sessions/{session_id}/orders	sessions.create_order	OrderService.create_order	case_exam_item、training_order	已实现
完成问诊	“完成问诊”	POST /api/v1/sessions/{session_id}/complete-inquiry	sessions.complete_inquiry	SessionService.complete_inquiry	training_session	已实现
提交诊断	“提交诊断”	POST /api/v1/sessions/{session_id}/diagnosis	sessions.submit_diagnosis	SessionService.submit_diagnosis	training_submission	已实现
提交治疗	“提交治疗方案”	POST /api/v1/sessions/{session_id}/treatment	sessions.submit_treatment	SessionService.submit_treatment	training_submission	已实现
生成评价	“生成 AI 评价报告”	POST /api/v1/sessions/{session_id}/evaluation	sessions.create_evaluation	EvaluationService.create_evaluation、ScoringAgent.score、ReportAgent	scoring_rule、knowledge_chunks、training_record	已实现
历史列表	历史页刷新	GET /api/v1/evaluations	evaluations.list_evaluations	EvaluationService.list_history	training_record	已实现
报告详情	历史详情/报告页	GET /api/v1/evaluations/{evaluation_id}	evaluations.get_evaluation_detail	EvaluationService.get_detail	training_record	已实现
PDF 导出	报告页“导出 PDF”	POST /api/v1/evaluations/{evaluation_id}/export-pdf	evaluations.export_pdf	PdfExportService.export	training_record	已实现
知识检索	后端预留/评价内部使用	GET /api/v1/knowledge/search	knowledge.search_knowledge	KnowledgeService.search_guidelines	knowledge_sources、knowledge_documents、knowledge_chunks	已实现
LLM Fast 测试	LLM 测试页“测试 Fast”	POST /api/v1/llm/test/deepseek-fast	llm_test.test_deepseek_fast	OpenAICompatibleLLMClient.chat	无长期表	已实现
LLM Reason 测试	LLM 测试页“测试 Reason”	POST /api/v1/llm/test/deepseek-reason	llm_test.test_deepseek_reason	OpenAICompatibleLLMClient.stream_chat/chat	无长期表	已实现

2. 当前数据表状态

当前功能只依赖新表：

case_base
traditional_case
teaching_case
scoring_rule
case_exam_item
training_session
training_order
training_submission
training_record
prompt_templates
knowledge_sources
knowledge_documents
knowledge_chunks
user_learning_profiles
audit_logs

旧表已不参与运行。旧表删除后，后端测试和前端构建均已通过。

3. 核心状态流

inquiry -> diagnosis -> treatment -> evaluating -> completed

• inquiry：允许 Chat、提示、申请检查。
• diagnosis：允许提交诊断。
• treatment：允许提交治疗方案。
• evaluating：允许生成 AI 评价。
• completed：允许查询历史、查看详情、导出 PDF。