第 1 章
编写说明
本文档用于完整描述"局域网答题系统（题王 QKing）"的功能、运行环境、数据结构、接口与操作方法，使读者能够：
本页目录
1.1 编写目的
本文档用于完整描述"局域网答题系统（题王 QKing）“的功能、运行环境、数据结构、接口与操作方法，使读者能够：
- 了解软件的开发目的、适用领域与主要功能；
- 完成软件的安装、配置、启动、日常运维与故障排查；
- 掌握教师端（主持台）、学生端的全部操作流程；
- 供软件著作权登记、项目验收、教学培训与后续维护使用。
1.2 适用读者
| 读者 | 建议阅读章节 |
|---|---|
| 软件著作权登记 / 项目验收人员 | 第 2、3、5、6 章、《功能使用》，附录 F |
| 一线教师（主持人） | 第 4、7、8、11 章 |
| 学校信息管理员 / 运维人员 | 第 3、4、9、10、11 章，附录 A–D |
| 开发与维护人员 | 全书，重点第 5、6、9、10 章 |
1.3 术语与缩写
| 术语 | 说明 |
|---|---|
| 房间（Room）/ 房间码 | 班级级隔离空间，6 位字符码；实时答题、整卷大厅、统计报告均按房间隔离 |
| 场次（Session） | 一次组织答题的记录，分实时场（live_*）与整卷场（exam） |
| 考试码 | 整卷测验的进场凭证，6 位字符，独立于房间码 |
| 题池 | 一场实时答题所使用的题目集合 |
| 题位（qn） | 试卷/题池中的一个答题单元；材料大题整组算 1 个题位 |
| 题源类型 | qb（题库题）/ legacy（实时题表题） |
| 揭示策略（reveal_policy） | 解析可见性：inline / submit / scheduled / never |
| 补答（free） | 自由答题模式下学生对已出过题目的回头作答 |
| OJ | Online Judge，编程题的在线判分 |
| Excel/WPS 操作题 | 学生下载模板、操作后提交由前端引擎判分的表格类操作题（题型 excel_wps） |
| 三件套 | Excel 操作题的模板表格、考点 JSON、判分脚本 |
| 平台公共库 / 本校私有 / 公开 | 题库三种可见范围（school_id=0 为平台公共） |
| 多租户（学校） | 通过 school_id 隔离学校数据 |
1.4 引用文档
docs/ 目录下同项目分册（清单见附录 E），以及项目根 readme.md、build_config.ini、version.txt。