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:
1 parent
4e68ba3890
commit
dd928a9513
19 files changed
+584
-7
No files matched your search
@@ -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** 页面展示统一的占位图
|
||||
Reference in new issue
Block a user