# 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** 页面展示统一的占位图