Files
word-market/openspec/specs/word-lexicon/spec.md
T
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

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 收录词书区域展示空状态