Files
voidandClaude Sonnet 4.6 dd928a9513 chore(openspec): 归档 add-admin-console
- 将变更移动到 changes/archive/2026-11-08-add-admin-console
- 同步 7 个能力、37 条需求到 openspec/specs/
- openspec validate --all 全部通过

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-11-08 23:00:53 +08:00

2.4 KiB

book-catalog Specification

Purpose

以只读方式浏览词书目录及每本词书的词条清单,帮助核对词书规模、考试归属、封面与内容完整性,并为词条详情提供入口。

Requirements

Requirement: 词书列表与筛选

系统 SHALL 提供分页的词书列表,支持按考试、关键词和是否存在词书文件筛选;列表 MUST 展示名称、业务编码、考试、声明词条数、实际词条数和文件状态。

Scenario: 默认分页浏览

  • WHEN 管理员打开词书列表
  • THEN 系统按稳定顺序返回第一页词书,并给出总数与总页数

Scenario: 按考试筛选

  • WHEN 管理员选择某个考试
  • THEN 列表只返回该考试下的词书

Scenario: 按关键词搜索

  • WHEN 管理员输入词书名称或编码的一部分
  • THEN 列表返回名称或编码匹配的词书

Scenario: 按文件状态筛选

  • WHEN 管理员筛选“无词书文件”
  • THEN 列表只返回没有对应清单文件的词书

Requirement: 词书详情

系统 SHALL 展示单本词书的名称、编码、考试、描述、声明词条数、实际词条数、内容版本、封面和文件状态。

Scenario: 查看词书详情

  • WHEN 管理员从列表进入某本词书
  • THEN 页面展示该词书的完整信息,并标明实际词条数与声明词条数是否一致

Scenario: 词书不存在

  • WHEN 请求的词书 ID 不存在
  • THEN 系统返回明确的未找到错误,前端展示不存在提示

Requirement: 词书词条清单

系统 SHALL 以分页方式展示词书内词条,默认按词书内顺序排列,并支持按展示词文本筛选。

Scenario: 浏览词条清单

  • WHEN 管理员打开词书详情的词条清单
  • THEN 系统按 seq_book 返回第一页词条,并给出总数

Scenario: 按词筛选

  • WHEN 管理员在词条清单中输入关键词
  • THEN 系统只返回展示词包含该关键词的词条

Requirement: 封面展示

系统 SHALL 将词书封面相对路径拼接到外部 CDN 地址展示;封面为空或加载失败时 MUST 显示占位图,不得展示破图。

Scenario: 正常封面

  • WHEN 词书存在封面路径
  • THEN 列表与详情展示来自 CDN 的封面图片

Scenario: 无封面或加载失败

  • WHEN 词书没有封面路径或图片加载失败
  • THEN 页面展示统一的占位图