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>
This commit is contained in:
voidandClaude Sonnet 4.6 committed 2026-11-08 23:00:53 +08:00
1 parent 4e68ba3890
commit dd928a9513
19 files changed
+584 -7

No files matched your search

+73
View File
@@ -0,0 +1,73 @@
# 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** 页面展示统一的占位图