refactor: 整理规范文件 - 合并冗余、优化命名(32→20)
- 删除 12 个规范:空目录、重复规范、被吸收的子集规范 - 合并 4 组规范:管理台页面、开发台页面、布局体系、组件+反馈 - 重命名 8 个规范:统一平台前缀、暴露可搜索关键词、消除语义冲突 - 新增 docs/规范整理.md:规范审查流程提示词模板
This commit is contained in:
41
openspec/specs/shared-ui-components/spec.md
Normal file
41
openspec/specs/shared-ui-components/spec.md
Normal file
@@ -0,0 +1,41 @@
|
||||
# Reusable Components Specification
|
||||
|
||||
## Purpose
|
||||
|
||||
提供可复用的布局组件和通用 UI 组件库,用于在不同页面中保持一致的视觉呈现和交互体验。
|
||||
|
||||
## Requirements
|
||||
|
||||
### Requirement: 布局组件复用
|
||||
系统 SHALL 提供可复用的布局组件,包括品牌区域、用户信息区域、导航项组件,用于在不同页面中保持一致的视觉呈现。
|
||||
|
||||
#### Scenario: SidebarBrand 组件渲染
|
||||
- **WHEN** 页面使用 SidebarBrand 组件并传入 subtitle 属性
|
||||
- **THEN** 系统显示 GrandClaw 品牌 logo 和对应的副标题文本
|
||||
|
||||
#### Scenario: SidebarUser 组件显示用户信息
|
||||
- **WHEN** 页面使用 SidebarUser 组件
|
||||
- **THEN** 系统从 UserContext 获取用户信息并显示用户头像、姓名和角色
|
||||
|
||||
#### Scenario: SidebarNavItem 组件支持状态切换
|
||||
- **WHEN** 页面使用 SidebarNavItem 组件并传入 active 状态
|
||||
- **THEN** 系统根据 active 状态应用相应的激活样式
|
||||
|
||||
### Requirement: 通用 UI 组件库
|
||||
系统 SHALL 提供通用 UI 组件库,包括空状态组件、状态标签组件、标签输入组件、搜索栏组件,支持在多个页面中复用。
|
||||
|
||||
#### Scenario: EmptyState 组件显示空状态
|
||||
- **WHEN** 页面使用 EmptyState 组件并传入 icon、message、description 属性
|
||||
- **THEN** 系统显示居中的空状态提示,包含图标、标题和描述文本
|
||||
|
||||
#### Scenario: StatusBadge 组件显示不同状态
|
||||
- **WHEN** 页面使用 StatusBadge 组件并传入 status 属性(如 running、stopped、warning、error)
|
||||
- **THEN** 系统根据 status 值应用对应的颜色样式和图标
|
||||
|
||||
#### Scenario: TagInput 组件支持标签增删
|
||||
- **WHEN** 用户在 TagInput 组件中输入文本并按回车
|
||||
- **THEN** 系统将输入内容添加为标签,并显示删除按钮
|
||||
|
||||
#### Scenario: SearchBar 组件提供筛选功能
|
||||
- **WHEN** 页面使用 SearchBar 组件并传入搜索条件配置
|
||||
- **THEN** 系统渲染对应的筛选输入框,并在用户输入时触发 onChange 回调
|
||||
Reference in New Issue
Block a user