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,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 并返回登录页
|
||||
@@ -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** 系统忽略现有缓存并重新计算后返回
|
||||
@@ -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** 页面展示统一的占位图
|
||||
@@ -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** 系统忽略缓存并重新计算
|
||||
@@ -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** 页面展示按成员数量分桶的组数量与占比
|
||||
@@ -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** 收录词书区域展示空状态
|
||||
@@ -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** 页面展示空状态,节点仍可正常展开和收起
|
||||
Reference in new issue
Block a user