diff --git a/openspec/changes/add-admin-console/.openspec.yaml b/openspec/changes/archive/2026-11-08-add-admin-console/.openspec.yaml similarity index 100% rename from openspec/changes/add-admin-console/.openspec.yaml rename to openspec/changes/archive/2026-11-08-add-admin-console/.openspec.yaml diff --git a/openspec/changes/add-admin-console/README.md b/openspec/changes/archive/2026-11-08-add-admin-console/README.md similarity index 100% rename from openspec/changes/add-admin-console/README.md rename to openspec/changes/archive/2026-11-08-add-admin-console/README.md diff --git a/openspec/changes/add-admin-console/design.md b/openspec/changes/archive/2026-11-08-add-admin-console/design.md similarity index 100% rename from openspec/changes/add-admin-console/design.md rename to openspec/changes/archive/2026-11-08-add-admin-console/design.md diff --git a/openspec/changes/add-admin-console/proposal.md b/openspec/changes/archive/2026-11-08-add-admin-console/proposal.md similarity index 100% rename from openspec/changes/add-admin-console/proposal.md rename to openspec/changes/archive/2026-11-08-add-admin-console/proposal.md diff --git a/openspec/changes/add-admin-console/specs/admin-auth/spec.md b/openspec/changes/archive/2026-11-08-add-admin-console/specs/admin-auth/spec.md similarity index 95% rename from openspec/changes/add-admin-console/specs/admin-auth/spec.md rename to openspec/changes/archive/2026-11-08-add-admin-console/specs/admin-auth/spec.md index 993e8cb..62c5f96 100644 --- a/openspec/changes/add-admin-console/specs/admin-auth/spec.md +++ b/openspec/changes/archive/2026-11-08-add-admin-console/specs/admin-auth/spec.md @@ -1,6 +1,6 @@ ## Purpose -保护只读管理后台的访问入口,确保只有持有有效凭据的管理员才能查看词库数据。 +保护只读管理后台的访问入口,确保只有持有有效凭据的管理员才能查看词库数据,并在会话失效时要求重新登录。 ## ADDED Requirements diff --git a/openspec/changes/add-admin-console/specs/admin-overview/spec.md b/openspec/changes/archive/2026-11-08-add-admin-console/specs/admin-overview/spec.md similarity index 96% rename from openspec/changes/add-admin-console/specs/admin-overview/spec.md rename to openspec/changes/archive/2026-11-08-add-admin-console/specs/admin-overview/spec.md index ec6171f..a486132 100644 --- a/openspec/changes/add-admin-console/specs/admin-overview/spec.md +++ b/openspec/changes/archive/2026-11-08-add-admin-console/specs/admin-overview/spec.md @@ -1,6 +1,6 @@ ## Purpose -在一个页面汇总词库的规模、分布与健康度,作为后台入口和问题发现入口。 +在一个页面汇总词库的规模、分布与健康度,作为后台入口和问题发现入口,并支持从异常指标下钻到对应模块。 ## ADDED Requirements diff --git a/openspec/changes/add-admin-console/specs/book-catalog/spec.md b/openspec/changes/archive/2026-11-08-add-admin-console/specs/book-catalog/spec.md similarity index 95% rename from openspec/changes/add-admin-console/specs/book-catalog/spec.md rename to openspec/changes/archive/2026-11-08-add-admin-console/specs/book-catalog/spec.md index eeb78da..4687fca 100644 --- a/openspec/changes/add-admin-console/specs/book-catalog/spec.md +++ b/openspec/changes/archive/2026-11-08-add-admin-console/specs/book-catalog/spec.md @@ -1,6 +1,6 @@ ## Purpose -以只读方式浏览词书目录及每本词书的词条清单,帮助核对词书规模、考试归属和内容完整性。 +以只读方式浏览词书目录及每本词书的词条清单,帮助核对词书规模、考试归属、封面与内容完整性,并为词条详情提供入口。 ## ADDED Requirements diff --git a/openspec/changes/add-admin-console/specs/data-quality/spec.md b/openspec/changes/archive/2026-11-08-add-admin-console/specs/data-quality/spec.md similarity index 98% rename from openspec/changes/add-admin-console/specs/data-quality/spec.md rename to openspec/changes/archive/2026-11-08-add-admin-console/specs/data-quality/spec.md index e560a17..cad8934 100644 --- a/openspec/changes/add-admin-console/specs/data-quality/spec.md +++ b/openspec/changes/archive/2026-11-08-add-admin-console/specs/data-quality/spec.md @@ -1,6 +1,6 @@ ## Purpose -汇总词库的数据质量问题,提供可解释的指标口径和到明细的下钻入口,帮助定位需要修复的数据。 +汇总词库的数据质量问题,提供可解释的指标口径和到明细的下钻入口,帮助定位需要修复的数据,并说明跨域关联的弱约束边界。 ## ADDED Requirements diff --git a/openspec/changes/add-admin-console/specs/synonym-relations/spec.md b/openspec/changes/archive/2026-11-08-add-admin-console/specs/synonym-relations/spec.md similarity index 96% rename from openspec/changes/add-admin-console/specs/synonym-relations/spec.md rename to openspec/changes/archive/2026-11-08-add-admin-console/specs/synonym-relations/spec.md index 2d03cf6..2110427 100644 --- a/openspec/changes/add-admin-console/specs/synonym-relations/spec.md +++ b/openspec/changes/archive/2026-11-08-add-admin-console/specs/synonym-relations/spec.md @@ -1,6 +1,6 @@ ## Purpose -浏览近义词头、义项,以及按考试划分的近义词组和反义词关系。 +浏览近义词头、义项,以及按考试划分的近义词组和反义词关系,并通过组规模分布发现异常过大或过小的近义组。 ## ADDED Requirements diff --git a/openspec/changes/add-admin-console/specs/word-lexicon/spec.md b/openspec/changes/archive/2026-11-08-add-admin-console/specs/word-lexicon/spec.md similarity index 96% rename from openspec/changes/add-admin-console/specs/word-lexicon/spec.md rename to openspec/changes/archive/2026-11-08-add-admin-console/specs/word-lexicon/spec.md index edad418..6bb249d 100644 --- a/openspec/changes/add-admin-console/specs/word-lexicon/spec.md +++ b/openspec/changes/archive/2026-11-08-add-admin-console/specs/word-lexicon/spec.md @@ -1,6 +1,6 @@ ## Purpose -搜索并查看单个词条的完整词典内容,覆盖释义、短语、例句、易混词及其被词书收录的情况。 +搜索并查看单个词条的完整词典内容,覆盖释义、短语、例句、易混词及其被词书收录的情况,支持在列表中快速切换词条。 ## ADDED Requirements diff --git a/openspec/changes/add-admin-console/specs/word-morphology/spec.md b/openspec/changes/archive/2026-11-08-add-admin-console/specs/word-morphology/spec.md similarity index 96% rename from openspec/changes/add-admin-console/specs/word-morphology/spec.md rename to openspec/changes/archive/2026-11-08-add-admin-console/specs/word-morphology/spec.md index 41b37a7..26dde46 100644 --- a/openspec/changes/add-admin-console/specs/word-morphology/spec.md +++ b/openspec/changes/archive/2026-11-08-add-admin-console/specs/word-morphology/spec.md @@ -1,6 +1,6 @@ ## Purpose -浏览词素(前缀、词根、后缀)、单词卡片、词族及其层级关系,支持以树形结构理解词族组成。 +浏览词素(前缀、词根、后缀)、单词卡片、词族及其层级关系,支持以懒加载树形结构理解词族组成与成员归属。 ## ADDED Requirements diff --git a/openspec/changes/add-admin-console/tasks.md b/openspec/changes/archive/2026-11-08-add-admin-console/tasks.md similarity index 100% rename from openspec/changes/add-admin-console/tasks.md rename to openspec/changes/archive/2026-11-08-add-admin-console/tasks.md diff --git a/openspec/specs/admin-auth/spec.md b/openspec/specs/admin-auth/spec.md new file mode 100644 index 0000000..48318dd --- /dev/null +++ b/openspec/specs/admin-auth/spec.md @@ -0,0 +1,64 @@ +# admin-auth Specification + +## Purpose + +保护只读管理后台的访问入口,确保只有持有有效凭据的管理员才能查看词库数据,并在会话失效时要求重新登录。 + +## Requirements + +### Requirement: 管理员登录 + +系统 SHALL 提供登录接口,校验单一管理员账号与密码;凭据必须来自外部配置(环境变量),不得硬编码在代码或仓库中。校验成功后签发 JWT,失败时返回统一错误结构。 + +#### Scenario: 凭据正确 + +- **WHEN** 管理员提交正确的用户名和密码 +- **THEN** 系统返回 JWT 和过期时间,前端进入后台首页 + +#### Scenario: 凭据错误 + +- **WHEN** 管理员提交错误的用户名或密码 +- **THEN** 系统返回 401,且不返回任何 token 或账号信息 + +#### Scenario: 请求缺字段 + +- **WHEN** 登录请求缺少用户名或密码 +- **THEN** 系统返回 400,并说明缺少的字段 + +#### Scenario: 启动时缺少管理员配置 + +- **WHEN** 应用启动时未提供管理员账号或密码哈希 +- **THEN** 应用拒绝启动并输出明确的配置缺失错误 + +### Requirement: 受保护接口鉴权 + +除登录接口外,所有业务接口 MUST 要求携带有效 JWT。无效、过期或缺失 token 的请求 SHALL 被拒绝,不得返回业务数据。 + +#### Scenario: 未携带 token + +- **WHEN** 请求受保护接口时未提供 Authorization 头 +- **THEN** 系统返回 401 + +#### Scenario: token 无效或过期 + +- **WHEN** 请求携带格式错误、签名不匹配或已过期的 token +- **THEN** 系统返回 401,且不返回业务数据 + +#### Scenario: token 有效 + +- **WHEN** 请求携带有效 token +- **THEN** 系统正常返回业务数据 + +### Requirement: 前端会话处理 + +前端 SHALL 在本地保存登录状态;收到 401 时必须清除登录状态并跳转登录页,不得停留在空白或报错页面。 + +#### Scenario: token 过期 + +- **WHEN** 任意页面请求返回 401 +- **THEN** 前端清除本地 token 并跳转登录页 + +#### Scenario: 主动退出 + +- **WHEN** 管理员点击退出 +- **THEN** 前端清除本地 token 并返回登录页 diff --git a/openspec/specs/admin-overview/spec.md b/openspec/specs/admin-overview/spec.md new file mode 100644 index 0000000..71756a4 --- /dev/null +++ b/openspec/specs/admin-overview/spec.md @@ -0,0 +1,71 @@ +# admin-overview Specification + +## Purpose + +在一个页面汇总词库的规模、分布与健康度,作为后台入口和问题发现入口,并支持从异常指标下钻到对应模块。 + +## Requirements + +### Requirement: 总量指标 + +系统 SHALL 在概览页展示词书数、词条数、词书词条关联数、例句数、词族数、近义词头数六项核心指标。 + +#### Scenario: 打开概览页 + +- **WHEN** 已登录管理员进入概览页 +- **THEN** 页面展示六项指标及其当前数值 + +#### Scenario: 指标查询失败 + +- **WHEN** 某一指标查询失败 +- **THEN** 页面展示该指标的不可用状态,其余指标仍正常展示 + +### Requirement: 考试维度分布 + +系统 SHALL 按考试展示词书数与关联词条数,并 MUST 显式包含“未归类”分组,避免未设置考试的词书被忽略。 + +#### Scenario: 查看考试分布 + +- **WHEN** 管理员查看考试分布图 +- **THEN** 图中包含各考试的词书数、关联词条数以及“未归类”分组 + +### Requirement: 词书规模排行 + +系统 SHALL 展示实际词条数最多的前 10 本词书,同时给出各自声明的词条数,便于发现两者差异。 + +#### Scenario: 查看规模排行 + +- **WHEN** 管理员查看词书规模排行 +- **THEN** 页面按实际词条数降序列出前 10 本,并同时显示声明词条数 + +### Requirement: 词性分布 + +系统 SHALL 按 `part_of_speech` 汇总词义数量并展示主要词性占比。 + +#### Scenario: 查看词性分布 + +- **WHEN** 管理员查看词性分布 +- **THEN** 页面展示各词性的义项数及占比,空词性单独归类 + +### Requirement: 质量红绿灯 + +系统 SHALL 在概览页展示关键数据质量指标摘要,并提供进入数据质量模块的入口。 + +#### Scenario: 查看质量摘要 + +- **WHEN** 管理员查看质量红绿灯 +- **THEN** 页面展示异常项数量与状态,并可跳转到数据质量模块 + +### Requirement: 聚合结果缓存 + +概览聚合结果 SHALL 缓存一段时间;缓存有效期内重复请求直接返回缓存,过期后重新查询。系统 SHALL 提供手动刷新方式以强制重新计算。 + +#### Scenario: 缓存命中 + +- **WHEN** 缓存在有效期内,管理员重复打开概览页 +- **THEN** 系统直接返回缓存结果,不重新执行聚合查询 + +#### Scenario: 手动刷新 + +- **WHEN** 管理员触发刷新 +- **THEN** 系统忽略现有缓存并重新计算后返回 diff --git a/openspec/specs/book-catalog/spec.md b/openspec/specs/book-catalog/spec.md new file mode 100644 index 0000000..b6fa745 --- /dev/null +++ b/openspec/specs/book-catalog/spec.md @@ -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** 页面展示统一的占位图 diff --git a/openspec/specs/data-quality/spec.md b/openspec/specs/data-quality/spec.md new file mode 100644 index 0000000..36c198f --- /dev/null +++ b/openspec/specs/data-quality/spec.md @@ -0,0 +1,90 @@ +# data-quality Specification + +## Purpose + +汇总词库的数据质量问题,提供可解释的指标口径和到明细的下钻入口,帮助定位需要修复的数据,并说明跨域关联的弱约束边界。 + +## Requirements + +### Requirement: 质量摘要 + +系统 SHALL 提供数据质量摘要,至少包含:声明与实际词条数不一致的词书数、缺失词书文件数、缺失 zpk 引用数、无结构化义项的词条数、无义项的近义词头数、未设置考试的词书数。 + +#### Scenario: 查看质量摘要 + +- **WHEN** 管理员打开数据质量模块 +- **THEN** 页面展示上述指标的当前数值和状态 + +#### Scenario: 指标查询失败 + +- **WHEN** 某一质量指标查询失败 +- **THEN** 页面展示该指标不可用,其余指标正常展示 + +### Requirement: 指标口径说明 + +每个质量指标 SHALL 附带口径说明,明确统计范围和判定条件,避免管理员误读。 + +#### Scenario: 查看口径 + +- **WHEN** 管理员将鼠标悬停或点击指标说明 +- **THEN** 页面展示该指标的统计范围与判定条件 + +### Requirement: 声明与实际差异明细 + +系统 SHALL 列出声明词条数与实际词条数不一致的词书,展示两者数值及差值,并支持跳转到词书详情。 + +#### Scenario: 查看差异明细 + +- **WHEN** 管理员打开声明与实际差异明细 +- **THEN** 页面列出全部不一致词书及其声明数、实际数和差值 + +#### Scenario: 跳转到词书 + +- **WHEN** 管理员点击某本差异词书 +- **THEN** 前端跳转到该词书详情 + +### Requirement: 缺失引用与文件明细 + +系统 SHALL 列出缺失词书文件、缺失 zpk 引用等异常明细,并标明对应标识,便于人工核查。 + +#### Scenario: 查看缺失明细 + +- **WHEN** 管理员打开缺失明细 +- **THEN** 页面列出每个异常项的标识、来源和缺失类型 + +### Requirement: 跨域覆盖度 + +系统 SHALL 展示单词卡片、词族、近义词头与词条索引词之间的文本交集覆盖率,并说明关联是弱关联。 + +#### Scenario: 查看覆盖度 + +- **WHEN** 管理员打开跨域覆盖度视图 +- **THEN** 页面展示各域与词条索引词的交集数量、占比和未覆盖数量 + +### Requirement: 异常下钻 + +系统 SHALL 允许从质量异常项跳转到对应的词书、词条或近义词详情,前提是存在可直接定位的实体标识。 + +#### Scenario: 下钻到实体 + +- **WHEN** 管理员点击一个可定位的异常项 +- **THEN** 前端跳转到对应实体详情页 + +#### Scenario: 无法定位 + +- **WHEN** 异常项没有可定位的实体标识 +- **THEN** 页面仅展示明细,不提供跳转 + +### Requirement: 质量结果缓存 + +质量摘要与覆盖度等聚合结果 SHALL 缓存一段时间,并支持手动刷新强制重算。 + +#### Scenario: 缓存命中 + +- **WHEN** 缓存在有效期内重复访问质量模块 +- **THEN** 系统返回缓存结果 + +#### Scenario: 手动刷新 + +- **WHEN** 管理员触发刷新 +- **THEN** 系统忽略缓存并重新计算 diff --git a/openspec/specs/synonym-relations/spec.md b/openspec/specs/synonym-relations/spec.md new file mode 100644 index 0000000..1cacf2c --- /dev/null +++ b/openspec/specs/synonym-relations/spec.md @@ -0,0 +1,77 @@ +# synonym-relations Specification + +## Purpose + +浏览近义词头、义项,以及按考试划分的近义词组和反义词关系,并通过组规模分布发现异常过大或过小的近义组。 + +## Requirements + +### Requirement: 近义词头列表与搜索 + +系统 SHALL 提供分页的近义词头列表,支持按单词搜索,并展示义项数量和是否有近义关系。 + +#### Scenario: 默认浏览 + +- **WHEN** 管理员打开近义词头列表 +- **THEN** 系统返回第一页词头及总数 + +#### Scenario: 按单词搜索 + +- **WHEN** 管理员输入单词的一部分 +- **THEN** 列表返回单词匹配的词头 + +### Requirement: 义项详情 + +系统 SHALL 展示词头下的全部义项,包括词性、中文释义,以及每个义项在各考试下的近义组和反义词。 + +#### Scenario: 查看义项 + +- **WHEN** 管理员进入某个词头详情 +- **THEN** 页面按义项展示词性和中文释义 + +#### Scenario: 无义项 + +- **WHEN** 词头没有任何义项 +- **THEN** 页面展示空状态,并保留词头本身的信息 + +### Requirement: 分考试近义组 + +系统 SHALL 对每个义项按考试展示近义组,包含规范词、成员单词、成员数量和成员顺序。 + +#### Scenario: 查看近义组 + +- **WHEN** 管理员展开某个义项的考试分组 +- **THEN** 页面展示该考试下的规范词和全部成员 + +#### Scenario: 成员较多 + +- **WHEN** 近义组成员数量超出页面承载 +- **THEN** 页面截断或分页展示,并标明完整成员数量 + +#### Scenario: 某考试无数据 + +- **WHEN** 义项在某个考试下没有近义组 +- **THEN** 该考试不展示为空组 + +### Requirement: 反义词展示 + +系统 SHALL 展示每个义项在各考试下的反义词。 + +#### Scenario: 查看反义词 + +- **WHEN** 义项存在反义词 +- **THEN** 页面在对应考试分组下展示反义词 + +#### Scenario: 无反义词 + +- **WHEN** 义项没有反义词 +- **THEN** 反义词区域展示空状态 + +### Requirement: 组规模分布 + +系统 SHALL 提供近义组规模分布视图,展示不同成员数量的组占比,帮助识别异常过大或过小的组。 + +#### Scenario: 查看分布 + +- **WHEN** 管理员打开近义词模块的分布视图 +- **THEN** 页面展示按成员数量分桶的组数量与占比 diff --git a/openspec/specs/word-lexicon/spec.md b/openspec/specs/word-lexicon/spec.md new file mode 100644 index 0000000..46a5607 --- /dev/null +++ b/openspec/specs/word-lexicon/spec.md @@ -0,0 +1,110 @@ +# 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** 收录词书区域展示空状态 diff --git a/openspec/specs/word-morphology/spec.md b/openspec/specs/word-morphology/spec.md new file mode 100644 index 0000000..89134d9 --- /dev/null +++ b/openspec/specs/word-morphology/spec.md @@ -0,0 +1,92 @@ +# word-morphology Specification + +## Purpose + +浏览词素(前缀、词根、后缀)、单词卡片、词族及其层级关系,支持以懒加载树形结构理解词族组成与成员归属。 + +## Requirements + +### Requirement: 词素列表与筛选 + +系统 SHALL 提供分页的词素列表,支持按词素类型(前缀、词根、后缀)和词形关键词筛选,并展示词形、类型、英文释义和中文释义。 + +#### 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 以可展开的树形结构展示词族层级:顶层词族节点可展开其变体与小组,最末级展示成员单词。节点必须标明自身类型和成员数量。 + +#### Scenario: 展开节点 + +- **WHEN** 管理员展开一个顶层词族节点 +- **THEN** 系统加载并展示其子节点,节点类型和成员数量清晰可见 + +#### Scenario: 收起节点 + +- **WHEN** 管理员收起已展开的节点 +- **THEN** 其子节点从视图中移除 + +#### Scenario: 成员过多 + +- **WHEN** 某个节点的成员数量超过一页 +- **THEN** 系统分页或懒加载成员,不得一次性渲染全部成员 + +#### Scenario: 空族谱 + +- **WHEN** 顶层词族没有变体、小组或成员 +- **THEN** 页面展示空状态,节点仍可正常展开和收起