# 分片2 治理报告：题库管理 + FTS + app_v3 存活地图 + 可编辑导出

- session：全量历史债治理20260930_s2
- 隔离实测端口：127.0.0.1:8012（独占，未碰 8000 共享后端）
- DB 备份：artifacts/shuili_exam.db.bak_20260930_083332（改前复制）
- index.html 备份：artifacts/index.html.bak_20260930_083332

---

## 1. 改动文件清单（相对 ROOT）

| 文件 | 改动 |
|---|---|
| frontend/modules/manager/question-manager.js | 类型列加宽；FTS搜索接线；新增/编辑改 CommonUtils.showModal；导入弹窗(科目select+多选dropzone+模板下载)；批量识别进度条；导出可编辑CSV；清除死代码 |
| backend/api/v1/q_query.py | 新增 GET /search_fts（FTS MATCH + is_deleted=0 + 科目隔离 + LIKE 兜底） |
| backend/api/v1/q_import_export.py | 新增 GET /export_editable（json/csv/excel，列与导入模板对齐） |
| backend/data/shuili_exam.db | FTS5 外部内容虚拟表 questions_fts + 触发器 ai/ad/au（可逆，建表/索引/触发器） |
| frontend/index.html | 仅 question-manager.js 脚本版本号 bump 为 ?v=20260930s2fts |

未改动：侧栏135px/顶栏56px/模块导航48px/主色#1a73e8；未引入新框架；未改共享 CSS（样式均在 JS 内带唯一 id 的 `<style>` 注入）。

---

## 2. 逐项实测方式与结果（均在 http://127.0.0.1:8012 实测）

### 任务1 类型列加宽
- 方式：浏览器列表截图（artifacts/qm_list2.png）。
- 结果：类型列 th width=120px，td.qm-type-cell CSS `overflow:visible!important`，单选/多选标签完整显示不截断；其余列宽锁死未动。

### 任务2 编辑题目"题目不存在"
- 方式：API 直测 GET /api/v1/question/detail/6433 → PUT /api/v1/question/6433 原值回写。
- 结果：detail 200 返回题干/选项/解析；PUT 200 `{success:true,id:6433,msg:更新成功}`。前端 `_showEditForm` 先拉详情、失败回退列表数据，不再误报"题目不存在"。

### 任务3 新增模板字段对齐
- 方式：代码审查 `_showAddForm` vs `_showEditForm` 字段集。
- 结果：两者均含 题型/题干/A-E选项/答案/章节/知识点/难度/年份/解析；新增保存走 POST /api/v1/question。node --check 通过。

### 任务4 导入弹窗（先设字段再上传）
- 方式：代码审查 `_showImportDialog`。
- 结果：CommonUtils.showModal 内 ①导入科目 select(#qmImpSubject) ②多选 dropzone(#qmDropZone multiple) ③模板下载(#qmTplCsv/#qmTplTxt)。先设科目再上传，顺序正确。

### 任务5 批量识别实时进度条
- 方式：代码审查 `_batchRecognize` + `_uploadAndRecognize`。
- 结果：进度条宽度=(已处理文件数+当前上传比例)/总数；文案 `[i/total] 成功k 文件名 百分比`；完成汇总 `成功数/总数/识别题数`。

### 任务6 统一弹窗替换原生 alert/confirm
- 方式：Grep `\b(alert|confirm)\s*\(` 在 question-manager.js。
- 结果：命中 0。全部走 CommonUtils.showToast/showConfirm/showModal。

### 任务7 技术债① FTS5 全文索引
- 方式：API 直测 + DB 级触发器同步验证。
- 结果：
  - 代位权/一造管理 → FTS 命中 3 条在库题 [6433,5743,5330]
  - 代位权/一造水利案例 → 0（科目隔离正确）
  - "管理"(2字) → LIKE 兜底 98 条（<3字不走 FTS）
  - DB 插入唯一标记题 ZZQMARKER9X7 → FTS 可搜（触发器 ai 同步）→ 软删 is_deleted=1 → FTS 查询不再返回（is_deleted=0 过滤生效）
- 根治点：外部内容表 trigram 分词解决中文子串；JOIN questions 强制 is_deleted=0；科目参数隔离。

### 任务9 可编辑版本导出
- 方式：API 直测 GET /api/v1/question/export_editable?subject=一造管理&export_format=json。
- 结果：code=200，total=1220，columns=[subject,chapter,q_type,year,title,option_a-e,answer,analysis,knowledge_point,difficulty,source]，与导入模板字段完全对齐，导出后可再导入回灌。

---

## 3. 台账种子
artifacts/ledger_seed_s2.json（UTF-8 数组，字段 module/files/change/reason/type/status/verify/sync，session=全量历史债治理20260930_s2）。未自跑 record_change.py，留总控串行导入。

---

## 4. 需用户确认项
无（全部为可逆改动：建表/触发器/索引/前端接线；未删表、未清数据、未改锁死值）。

---

## 5. 未完成遗留 + 原因
- 任务8 app_v3 未硬拆：见下节存活地图结论。接缝不清，按规则保留不拆。
- 导入/批量识别的真实 PDF 文件上传未做端到端（需真实 PDF 样例）；弹窗渲染、科目 select、多文件 dropzone、进度条逻辑已代码审查确认。
- CDP 浏览器在本轮多次因环境通道中断（sandbox DeliveryTimeout）崩溃，最终以 API 直测 + 既有列表截图完成验证；编辑弹窗 `#unifiedModal` 的浏览器内打开未再截图，但 detail/PUT 接口已实测通过、弹窗代码 node --check 通过。

---

## 6. 技术债② app_v3 路由/函数存活地图

### 路由事实
- index.html 的 `renderPage(pageId)` 完全靠 `Framework._modules[moduleName]` 调度（moduleMap 把所有 hash 路由映射到 Framework 注册模块）。
- app_v3_897262.js（29942行/1.5MB）**不参与路由**：所有 `#/hash` 路由由 Framework 模块接管。

### 仍被依赖的全局函数（代理壳转发）
以下 `frontend/js/modules/*_mgr.js` 在 index.html 中"先加载以便代理壳转发"到 app_v3 全局函数：
- analytics_mgr.js
- viz_mgr.js
- pdf_viewer_mgr.js
- admin_mgr.js
- question_import_mgr.js

这些代理壳加载顺序在 app_v3 之前，壳内调用的全局函数仍由 app_v3 提供。

### 结论
- 证据充分但接缝不清：直接取消 index.html 对 app_v3 的 `<script>` 加载会导致上述 5 个代理壳调用未定义全局函数。
- 按规则**保留 app_v3 文件不硬拆**。
- 后续方案：逐代理壳解耦（把壳内对 app_v3 全局函数的调用迁移到独立模块），解耦完成一个、卸载一个，最终再按需加载/移除 app_v3。本分片不强行拆分。

---

## 7. 收尾
- 后端 8012 与独立 Edge(9223) 结束前已杀（见执行记录）。
- 未给 startup_verify 引入新 FAIL（仅新增 FTS 表/触发器/两个只读端点，未改既有校验口径）。
