feat: 同步UI模版定制功能到PRD、HLD、LLD文档

PRD更新:
- 新增2.6 UI模版定制模块
- 包含品牌定制、布局调整、预设模板、配置历史、可视化配置器五个子模块
- 每个子模块包含功能描述、用户故事、功能点、业务规则、验收标准

HLD更新:
- 业务范围中新增UI模版定制模块
- 新增3.5 UI模版定制流程(业务场景、业务流程、业务规则、异常处理)
- 新增4.6 UI模版定制规则(品牌元素应用、Logo格式限制、颜色格式限制等8条规则)

LLD更新:
- 新增2.6 UI模版定制模块(模块概述、数据模型设计、核心业务逻辑)
- 数据模型包含4个表:tenant_ui_config、ui_template、ui_config_history、ui_resource
- 核心业务逻辑包含4个Service:BrandConfigService、LayoutConfigService、TemplateService、ConfigHistoryService
- 新增3.5 UI模版定制模块API(10个API接口,涵盖品牌定制、布局调整、模板管理、配置历史)

所有文档已保持一致性,UI模版定制功能已完整同步到产品需求、概要设计、详细设计文档中
This commit is contained in:
张翔
2026-03-07 16:59:32 +08:00
parent 559bfe56e3
commit 971d51cb36
3 changed files with 1011 additions and 98 deletions
+133 -3
View File
@@ -275,6 +275,137 @@
---
### 2.6 UI模版定制模块
#### 2.6.1 品牌定制
**功能描述**:租户通过可视化配置器定制品牌元素,包括Logo、颜色、背景图等。
**用户故事**:作为一个租户,我希望能够上传自己的Logo和设置品牌颜色,以便在系统中展示我的品牌特色。
**功能点**
- Logo上传(支持拖拽上传、自动裁剪、多尺寸缩略图)
- 品牌主色调设置(颜色选择器、预设色板)
- 品牌辅助色设置
- 背景图上传(支持轮播背景)
- 品牌名称和Slogan设置
- 实时预览所有品牌元素
**业务规则**
- Logo支持PNG/JPG格式,限制2MB以内
- 颜色支持RGB和HEX格式
- 品牌元素应用范围包括小程序和管理后台
- 配置变更实时生效,无需重新部署
**验收标准**
- Logo上传成功率 ≥ 95%
- 实时预览响应时间 ≤ 200ms
- 品牌元素应用一致性 100%
#### 2.6.2 布局调整
**功能描述**:租户通过拖拽式界面调整页面模块的显示顺序和布局结构。
**用户故事**:作为一个租户,我希望能够调整页面的模块顺序和隐藏不需要的功能,以便优化用户体验。
**功能点**
- 模块顺序调整(拖拽排序)
- 模块隐藏/显示开关
- 首页布局类型选择(卡片式、列表式、轮播式)
- 导航菜单自定义(添加/编辑/删除菜单项)
- 模块分组管理
- 批量操作(全选、反选、批量隐藏)
- 布局调整撤销/重做
**业务规则**
- 模块顺序调整支持跨区域移动
- 隐藏的模块不显示但数据保留
- 布局调整按角色区分(店长、前台、会员)
- 布局变更自动保存到配置历史
**验收标准**
- 拖拽操作流畅度 ≥ 90%
- 布局变更响应时间 ≤ 300ms
- 模块隐藏成功率 100%
#### 2.6.3 预设模板
**功能描述**:系统提供3-5个精心设计的预设模板,租户可以直接选择并应用。
**用户故事**:作为一个租户,我希望能够从预设模板中选择适合我的模板,快速完成UI定制。
**功能点**
- 模板预览(缩略图、大图预览)
- 模板类型筛选(简约、运动、科技、高端)
- 一键应用模板
- 模板收藏功能
- 模板对比功能(并排对比、差异高亮)
- 模板应用前确认对话框
- 模板预览模式(正式应用前预览效果)
**业务规则**
- 模板应用后保留租户已有的品牌配置
- 模板支持版本控制和灰度发布
- 模板切换支持配置合并
- 禁用的模板不可选择
**验收标准**
- 模板加载成功率 ≥ 98%
- 模板应用成功率 ≥ 95%
- 模板切换响应时间 ≤ 500ms
#### 2.6.4 配置历史
**功能描述**:记录租户的配置变更历史,支持配置回滚和对比。
**用户故事**:作为一个租户,我希望能够查看配置变更历史,并在需要时回滚到之前的配置。
**功能点**
- 配置历史列表查看
- 配置版本对比(新旧配置差异)
- 配置回滚到历史版本
- 配置导出(JSON文件)
- 配置导入(从JSON文件恢复)
- 变更原因记录
**业务规则**
- 每次配置变更自动生成新版本号
- 配置历史保留90天
- 回滚操作需要确认
- 配置对比高亮显示差异
**验收标准**
- 配置保存成功率 ≥ 99%
- 配置回滚成功率 ≥ 98%
- 配置对比准确性 100%
#### 2.6.5 可视化配置器
**功能描述**:提供直观的可视化配置界面,降低租户定制UI的技术门槛。
**用户故事**:作为一个租户,我希望通过可视化的拖拽界面来定制UI,而不需要编写代码。
**功能点**
- 三区域布局(品牌配置区、布局配置区、模板选择区)
- 拖拽式模块排序
- 实时预览(支持多设备尺寸切换)
- 智能提示(颜色搭配建议、Logo尺寸建议、模板推荐)
- 快捷操作(一键重置、一键预览、一键保存、一键发布)
- 配置导出/导入
**业务规则**
- 所有配置变更实时反映在预览区
- 预览区模拟真实页面结构
- 拖拽操作提供视觉反馈
- 配置器支持键盘快捷键
**验收标准**
- 配置器加载时间 ≤ 1秒
- 实时预览延迟 ≤ 100ms
- 拖拽操作流畅度 ≥ 95%
---
## 三、非功能需求
### 3.1 性能需求
@@ -381,6 +512,5 @@
### 7.2 参考文档
- 《健身房管理系统产品设计文档》 GYM-PRD-001
- 《健身房管理系统业务概要设计文档》 GYM-HLD-001
- 《健身房管理系统详细设计文档》 GYM-LLD-000
- 《健身房管理系统基础版业务概要设计文档》 GYM-HLD-BASIC-001
- 《健身房管理系统基础版详细设计文档》 GYM-LLD-BASIC-001