# 数据表设计规范

TIP

当你使用本规范设计数据表时，搭配可视化CRUD，可以非常舒畅的完成后台功能制作，推荐直接从0开始，因为拖拽设计的组件参数是最正确的。

# 字段类型

类型	备注	CRUD 搭配点
enum	枚举型	自动生成单选框
set	set 型	自动生成复选框
date	日期型	自动生成日期的选择组件
year	年份型	自动生成年份选择组件
time	时间型	自动生成时间选择组件
datetime/timestamp	时间日期	自动生成时间日期的选择组件
decimal/double/float	浮点型	自动生成 Number 输入框，步长根据默认值自动计算
int/bigint/mediumint/smallint/tinyint	整型	自动生成 Number 输入框，步长为 1
longtext/text/mediumtext/smalltext/tinytext/bigtext	文本型	自动生成 textarea 文本框

名称	备注	字段类型要求	CRUD 搭配点
weigh	权重	int	后台的排序字段，如果存在该字段将出现排序按钮，可上下拖动进行排序
create_time	创建时间(可视化生成)	bigint	记录的添加时间字段，不需要手动维护
update_time	更新时间(可视化生成)	bigint	记录的更新时间的字段，不需要手动维护

后缀	名称示例	字段类型要求	CRUD 搭配点
array	namearray	无	自动生成数组输入组件
list/select/data	namelist	无	自动生成 select，单选
lists/selects/multi	name_selects	无	自动生成 select，多选
_id	user_id	无	自动生成关联表远程 select，单选
_ids	user_ids	无	自动生成关联表远程 select，多选
city	city	无	自动生成城市选择器（需在模块市场中安装省份城市信息）
image/avatar	desc_image	无	自动生成上传图片组件，单图
images/avatars	descimages	无	自动生成上传图片组件，多图
file	attachfile	无	自动生成上传文件组件，单文件
files	attachfiles	无	自动生成上传文件组件，多文件
icon	icon	无	自动生成图标选择器
color	color	无	自动生成颜色选择器（仅可视化CRUD）
number/int/num	add_num	无	自动生成 Number 输入框，步长根据默认值自动计算
time/datetime	refreshtime	int	自动创建选择时间日期的组件
textarea/multiline/rows	rows	varchar	自动生成Textarea输入框
status/state/type	status	tinyint(1)/char(1)	自动生成单选框
switch/toggle	log_switch	tinyint(1)/int/enum/char(1)	自动生成开关组件，`真值`、`1`代表开，`假值`、`0`代表关
content/editor	content	longtext/text/mediumtext/smalltext/tinytext/bigtext	自动生成富文本编辑器

CRUD会将字段注释和表注释解析为字典。

将字段status注释设置为状态:0=禁用,1=启用，那么一键CRUD生成的页面如下所示。

# 另外的两个参考示例
菜单类型:tab=选项卡,link=链接,iframe=Iframe
扩展属性:none=无,add_rules_only=只添加为路由,add_menu_only=只添加为菜单

表注释示例：