# school_diy_theme 表文档

## 表概述
**表名**: school_diy_theme  
**功能**: 自定义主题配色管理表，负责管理教务系统中的界面主题和配色方案，包括主题创建、配色设置、模式切换等界面个性化定制功能

## 字段说明

```
Field	Type	Collation	Null	Key	Default	Extra	Privileges	Comment
id	int	NULL	NO	PRI	NULL	auto_increment	select,insert,update,references	
title	varchar(255)	utf8mb4_general_ci	NO				select,insert,update,references	标题
type	varchar(255)	utf8mb4_general_ci	NO				select,insert,update,references	插件类型app，addon
addon	varchar(255)	utf8mb4_general_ci	NO				select,insert,update,references	所属应用，app：系统，shop：商城、o2o：上门服务
color_mark	varchar(255)	utf8mb4_general_ci	NO				select,insert,update,references	颜色标识
color_name	varchar(255)	utf8mb4_general_ci	NO				select,insert,update,references	颜色名称
mode	varchar(255)	utf8mb4_general_ci	NO				select,insert,update,references	模式，default：默认【跟随系统】，diy：自定义配色
value	text	utf8mb4_general_ci	YES		NULL		select,insert,update,references	配色
diy_value	text	utf8mb4_general_ci	YES		NULL		select,insert,update,references	自定义配色
create_time	int	NULL	NO		0		select,insert,update,references	创建时间
update_time	int	NULL	NO		0		select,insert,update,references	更新时间
```

## 功能用途

### 主要功能
- **主题管理**: 创建和管理不同的界面主题方案
- **配色设置**: 设置和调整系统的配色方案
- **模式切换**: 支持默认模式和自定义模式的切换
- **颜色标识**: 为不同主题设置颜色标识和名称
- **应用适配**: 支持不同应用模块的主题适配
- **配色预览**: 提供主题配色的预览功能
- **主题导入导出**: 支持主题配置的导入和导出
- **版本管理**: 管理主题的版本和更新
- **用户个性化**: 支持用户个性化主题设置
- **主题分享**: 支持主题配置的分享和复用

### 业务场景
- **品牌定制**: 根据机构品牌色彩定制系统主题
- **节日主题**: 在特殊节日使用特定的主题配色
- **用户体验**: 提供多样化的界面风格选择
- **视觉识别**: 通过主题强化品牌视觉识别
- **季节变换**: 根据季节变化调整系统配色
- **活动推广**: 配合营销活动使用特定主题
- **个性化服务**: 为不同用户群体提供个性化界面
- **无障碍设计**: 提供高对比度等无障碍主题
- **夜间模式**: 提供护眼的夜间模式主题

## 关联关系

### 主要关联表
- `school_diy_page`: 自定义页面表 (主题应用)
- `school_sys_config`: 系统配置表 (默认主题设置)
- `school_sys_user`: 系统用户表 (用户主题偏好)
- `school_campus`: 校区表 (校区主题定制)
- `school_addon`: 插件表 (插件主题适配)
- `school_web_adv`: 网站广告表 (主题适配)
- `school_template_message`: 模板消息表 (主题色彩)
- `sys_log`: 系统日志表 (主题操作日志)

### 关联说明
- **页面关联**: 自定义页面应用特定的主题配色
- **配置关联**: 系统配置中设置默认主题
- **用户关联**: 用户可以设置个人主题偏好
- **校区关联**: 不同校区可以使用不同的主题
- **插件关联**: 插件模块适配相应的主题风格
- **广告关联**: 广告内容与主题色彩协调
- **消息关联**: 消息模板使用主题配色
- **日志关联**: 记录主题的操作和变更历史
- **业务关联**: 各业务模块应用统一的主题风格

## 索引建议
- **主键索引**: id (已存在)
- **业务索引**: 
  - type (插件类型查询)
  - addon (应用类型查询)
  - mode (模式查询)
  - create_time (创建时间查询)
  - update_time (更新时间查询)
- **复合索引**: 
  - (type, addon) (类型应用查询)
  - (addon, mode) (应用模式查询)
- **全文索引**: 
  - title (主题标题搜索)
  - color_name (颜色名称搜索)

## 注意事项
- **主题兼容性**: 确保主题在不同设备和浏览器上的兼容性
- **配色规范**: 遵循UI设计规范和无障碍设计标准
- **性能影响**: 主题切换不应影响系统性能
- **数据格式**: value和diy_value字段存储JSON格式数据
- **默认主题**: 系统必须有一个默认主题作为备选
- **颜色对比度**: 确保文字和背景有足够的对比度
- **主题缓存**: 主题配置应该合理缓存提升加载速度
- **版本控制**: 主题更新时需要考虑向后兼容性
- **用户体验**: 主题切换应该平滑无闪烁
- **移动适配**: 主题在移动端的显示效果
- **品牌一致性**: 主题设计应符合机构品牌形象
- **配色数量**: 避免过多的配色选项影响用户选择
- **主题测试**: 新主题上线前需要充分测试
- **回滚机制**: 主题出现问题时的快速回滚机制
- **用户反馈**: 收集用户对主题的反馈和建议
- **定期更新**: 定期更新主题以保持界面的现代感
- **数据备份**: 重要主题配置需要备份