- 将变更移动到 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>
3.2 KiB
3.2 KiB
word-lexicon Specification
Purpose
搜索并查看单个词条的完整词典内容,覆盖释义、短语、例句、易混词及其被词书收录的情况,支持在列表中快速切换词条。
Requirements
Requirement: 词条搜索与列表
系统 SHALL 提供分页的词条列表,支持按原形或归一化索引词模糊搜索;列表 MUST 展示原形、音标、释义摘要、义项数量和收录词书数。
Scenario: 默认浏览
- WHEN 管理员打开词条列表
- THEN 系统返回第一页词条及总数
Scenario: 按词搜索
- WHEN 管理员输入单词的一部分
- THEN 系统返回原形或索引词匹配的词条
Scenario: 无匹配结果
- WHEN 搜索结果为空
- THEN 页面展示空状态,而不是错误
Requirement: 词条基本信息
系统 SHALL 展示词条的原形、索引词、美式与英式音标、释义原文、数据版本、所属考试和来源标识。
Scenario: 查看基本信息
- WHEN 管理员进入词条详情
- THEN 页面展示该词条的基本字段
Scenario: 词条不存在
- WHEN 请求的词条 ID 不存在
- THEN 系统返回未找到错误,前端展示不存在提示
Requirement: 义项浏览
系统 SHALL 展示词条的结构化义项,包括序号、词性、中文释义、关联考试和义项关系。
Scenario: 有结构化义项
- WHEN 词条存在结构化义项
- THEN 页面按序号展示全部义项及其考试和关系
Scenario: 无结构化义项
- WHEN 词条没有任何结构化义项
- THEN 义项区域展示空状态,并在基本信息中保留原始释义文本
Requirement: 短语浏览
系统 SHALL 展示词条关联的短语,包括英文、中文、所属义项、分组类型和关联考试。
Scenario: 查看短语
- WHEN 管理员打开短语区域
- THEN 页面展示该词条的短语列表及其考试关联
Scenario: 无短语
- WHEN 词条没有短语
- THEN 短语区域展示空状态
Requirement: 例句浏览
系统 SHALL 按例句组展示例句,包含例句文本、翻译、使用模式和来源类型;数据量较大时 MUST 分页。
Scenario: 查看例句
- WHEN 管理员打开例句区域
- THEN 页面按例句组展示第一页例句
Scenario: 例句较多
- WHEN 词条例句数量超过一页
- THEN 页面提供分页,不得一次性加载全部例句
Scenario: 无例句
- WHEN 词条没有例句
- THEN 例句区域展示空状态
Requirement: 易混词浏览
系统 SHALL 展示词条的易混词及其辨析信息。
Scenario: 查看易混词
- WHEN 管理员打开易混词区域
- THEN 页面展示易混词列表及辨析内容
Requirement: 收录词书浏览
系统 SHALL 分页展示收录该词书的词书,包括词书名称、词书内展示词和顺序。
Scenario: 查看收录词书
- WHEN 管理员打开收录词书区域
- THEN 页面分页展示收录该词条的词书及词书内顺序
Scenario: 未被任何词书收录
- WHEN 词条没有被任何词书收录
- THEN 收录词书区域展示空状态