hotime/.cursor/plans/规范文档创建_6d183386.plan.md
hoteas 230dfc5a2b feat(cache): 增加历史记录功能和数据库设计规范
- 在 README.md 中新增数据库设计规范、代码生成配置规范和改进规划的文档链接
- 在 CacheDb 结构体中添加历史记录开关 HistorySet
- 实现历史记录的写入逻辑,记录每次缓存的新增和修改
- 更新缓存的获取和设置方法,支持历史记录的管理
- 优化数据库表的初始化和迁移逻辑,确保历史表的创建与管理
2026-01-25 05:14:18 +08:00

3.0 KiB
Raw Blame History

name overview todos
规范文档创建 创建两个规范文档一个数据库设计规范文档一个管理后台配置规范文档包含admin.json和rule.json的配置说明并在README.md中添加链接。
id content status
create-db-doc 创建 docs/DatabaseDesign_数据库设计规范.md pending
id content status
create-admin-doc 创建 docs/AdminConfig_管理后台配置规范.md pending
id content status dependencies
update-readme 在 README.md 文档表格中添加两个新文档链接 pending
create-db-doc
create-admin-doc

创建规范文档

任务概述

D:\work\hotimev1.5\docs 目录下创建两个规范文档,并更新 README.md 添加链接。


文档一:数据库设计规范

文件: docs/DatabaseDesign_数据库设计规范.md

内容结构

| 章节 | 内容 |

|------|------|

| 表命名规则 | 不加前缀、可用简称、关联表命名主表_关联表 |

| 字段命名规则 | 主键id、外键表名_id、全局唯一性要求、层级字段parent_id/parent_ids/level |

| 注释规则 | select类型格式状态:0-正常,1-异常、时间用datetime |

| 必有字段 | state、create_time、modify_time |

| 示例 | 完整建表SQL示例 |


文档二:管理后台配置规范

文件: docs/AdminConfig_管理后台配置规范.md

内容结构

| 章节 | 内容 |

|------|------|

| admin.json 配置 | |

| - flow配置 | 数据流控制定义表间权限关系sql条件、stop标志 |

| - labelConfig | 操作按钮标签show/add/delete/edit/info/download |

| - label | 菜单/表的显示名称 |

| - menus配置 | 菜单结构嵌套menus、icon、table、name、auth |

| - auth配置 | 权限数组show/add/delete/edit/info/download |

| - icon配置 | 菜单图标如Setting |

| - table/name配置 | table指定数据表name用于分组标识 |

| - stop配置 | 不允许用户修改自身关联数据的表 |

| rule.json 配置 | |

| - 字段默认权限 | add/edit/info/list/must/strict/type 各字段含义 |

| - 内置字段规则 | id、parent_id、create_time、modify_time、password等 |

| - type类型说明 | select/time/image/file/password/textArea/auth/form等 |


更新 README.md

在文档表格中添加两个新链接:

| [数据库设计规范](docs/DatabaseDesign_数据库设计规范.md) | 表命名、字段命名、注释规则、必有字段 |
| [管理后台配置规范](docs/AdminConfig_管理后台配置规范.md) | admin.json、rule.json 配置说明 |

关键参考文件