ulthon_admin/.agents/rules/ulthon-database-design.md

表结构设计规范

特殊字段

字段名	用途	说明
status	默认开关字段	-
create_time	创建时间	尽量 NOT NULL，默认值 0（TP 会自动填充）
update_time	更新时间	尽量 NOT NULL，默认值 0（TP 会自动填充）
delete_time	删除时间	尽量 NOT NULL，默认值 0；CURD 默认开启软删除，删除标志为 0

字段后缀约定

以特殊字符结尾的字段会自动识别为对应类型：

后缀	类型
image、logo、photo、icon	单图片
images、photos、icons	多图片
file	单文件
files	多文件

注释语法

字段注释支持通过特殊格式定义表单类型和数据集：

名称 {类型} (数据集)

• 类型：用 {} 包起来，例如 {radio}
• 数据集：用 () 包起来，例如 (1:男, 2:女, 0:未知)
• 数据集索引可以用数字或英文单词，不要使用其他字符和空格

示例：性别 {radio} (1:男, 2:女, 0:未知)

类型大全

类型	说明	是否需要数据集	注释案例
text	普通文本框	否	店铺名称 {text}（一般不需要写 text）
image	单图片	否	店铺logo {image}
images	多图片	否	店铺环境 {images}，分隔符默认为竖线
file	单文件	否	演示资料 {file}
files	多文件	否	演示资料 {files}，默认分隔符为竖线
date	时间组件	是	生日 {date} (datetime)
editor	富文本	否	店铺详情 {editor}
textarea	多行文本	否	店铺简介 {textarea}
select	下拉选择	是	版本 {select} (trial:免费版,office:正式版)
switch	开关组件	是	状态 {switch} (0:关闭,1:开启)
checkbox	多选框	是	功能权限 {checkbox} (mall:商城,blog:博客)
radio	单选框	是	状态 {radio} (0:未审核,1:审核中)
relation	关联表	是（格式见下）	标签 {relation} (table:tag,relationBindSelect:title)
table	表格选择器	是（格式见下）	商品标签 {table} (table:mall_tag,type:checkbox,valueField:id,fieldName:title)
city	城市选择器	是	仓库 {city} (level:city)

关联表注释参数

参数	说明	备注
table	关联表名	必填
primaryKey	关联表主键	非必填
modelFilename	模型文件	非必填，不建议指定，可自动生成
onlyFileds	列表页显示字段	可指定，用竖线分割
relationBindSelect	表单下拉关联字段	必填

完整写法示例：

标签 {relation} (table:tag,relationBindSelect:title,primaryKey:id,onlyFileds:title|titme_image|username|phone)

其他细节

• 设计时尽量设置默认值。例如 status 默认值为 1，添加数据时表单会自动将 radio 选中"1:启用"
• 分隔符默认为竖线 |