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:
@@ -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** | **后端数据库** | 满分(决定得分上限) |
|
||||
|
||||
|
||||
Reference in New Issue
Block a user