docs: 清理过时文档 + 更新关键文档

删除(10个):
- API与后端对接规范.md(已被后端对接规范.md 替代)
- image_processing_flow.md(已合入 RAG数据流程.md)
- 状态码功能更新说明.md(已合入后端对接规范.md)
- 题目模板.md(字段名与实际 API 不一致,以对接指南为准)
- 出题批卷系统设计.md(旧版出题设计,已被对接指南+变更说明替代)
- 测试指南.md(出题 API 格式过时,模型名过时)
- 企业文档更新管理方案.md(设计方案,已实施完成)
- 版本管理实施完成报告.md(里程碑报告,已完成归档)
- 生产路径优化计划.md(行号已偏移,阶段状态过时)

更新(7个):
- 出题批题后端对接指南.md:添加 generate-smart 端点、question_content→content
- 开发与系统模块说明.md:更新 reranker 和 LLM 模型名称
- 多源信息融合指南.md:标注生产路径 vs 备用路径
- 架构与部署方案.md:更新数据归属对照表(4个 SQLite DB)
- 认证与权限配置指南.md:出题 API 更新为 /exam/generate
- 向量库边界风险分析.md:标注 P1 旧切片残留和 P2 文件更新已修复
- 风险边界问题修复注意事项.md:标注所有场景已修复
This commit is contained in:
lacerate551
2026-06-21 20:53:33 +08:00
parent b2ccec79b9
commit d589c27bce
16 changed files with 40 additions and 4422 deletions

View File

@@ -4,9 +4,12 @@
| 接口 | 方法 | 功能 | 超时建议 |
|------|------|------|----------|
| `/exam/generate` | POST | 生成题目 | 120秒 |
| `/exam/generate` | POST | 生成题目(手动指定题型数量) | 120秒 |
| `/exam/generate-smart` | POST | 生成题目AI 自动分析文档结构出题) | 120秒 |
| `/exam/grade` | POST | 批阅答案 | 60秒 |
> **2026-06-05 变更**`/exam/grade` 请求字段 `question_content` 已重命名为 `content`(破坏性变更)。详见 [出题批阅接口变更说明2026-06-05](出题批阅接口变更说明2026-06-05.md)。
---
## 二、出题接口
@@ -175,7 +178,7 @@ Content-Type: application/json
|------|------|------|------|------|
| `question_id` | string | ✅ | 题目ID | 后端数据库 |
| `question_type` | string | ✅ | 题型 | 后端数据库 |
| `question_content` | object | ✅ | 题目内容(含正确答案) | 后端数据库 |
| `content` | object | ✅ | 题目内容(含正确答案) | 后端数据库 |
| `student_answer` | any | ✅ | 学生答案 | 学生提交 |
| `max_score` | number | ✅ | 满分 | 后端数据库 |
@@ -188,7 +191,7 @@ Content-Type: application/json
{
"question_id": "q-001",
"question_type": "single_choice",
"question_content": {
"content": {
"stem": "根据公司规定,员工薪资由哪几部分组成?",
"data": {
"options": [
@@ -206,7 +209,7 @@ Content-Type: application/json
{
"question_id": "q-002",
"question_type": "multiple_choice",
"question_content": {
"content": {
"stem": "以下哪些属于绩效奖金的评定因素?",
"data": {
"options": [
@@ -224,7 +227,7 @@ Content-Type: application/json
{
"question_id": "q-003",
"question_type": "true_false",
"question_content": {
"content": {
"stem": "公司规定员工每月绩效奖金上限为工资的20%。",
"answer": "F"
},
@@ -234,7 +237,7 @@ Content-Type: application/json
{
"question_id": "q-004",
"question_type": "fill_blank",
"question_content": {
"content": {
"stem": "员工薪资由___、___和___三部分组成。",
"data": {"blank_count": 3},
"answer": [["基本工资"], ["绩效奖金", "绩效"], ["津贴补贴", "补贴"]]
@@ -245,7 +248,7 @@ Content-Type: application/json
{
"question_id": "q-005",
"question_type": "subjective",
"question_content": {
"content": {
"stem": "请简述公司薪酬制度的核心原则。",
"data": {
"scoring_points": [
@@ -397,7 +400,7 @@ Content-Type: application/json
后端从数据库查询:
- question_id
- question_type
- question_content (含正确答案)
- content (含正确答案,原 question_content 已弃用)
- score (满分)
@@ -434,7 +437,7 @@ Content-Type: application/json
|------|------|------|
| question_id | 后端数据库 | 题目唯一标识 |
| question_type | 后端数据库 | 题型 |
| question_content | 后端数据库 | 题目内容(含正确答案) |
| content | 后端数据库 | 题目内容(含正确答案,原 question_content 已弃用 |
| student_answer | 学生提交 | 学生作答 |
| **max_score** | **后端数据库** | 满分(决定得分上限) |