zhjwxt/niucloud/databasedoc/school_generate_column.md

school_generate_column 表文档

表概述

表名: school_generate_column
功能: 代码生成器字段配置表，用于管理代码生成器中每个字段的详细配置信息，包括表单控件类型、显示属性、验证规则、查询方式等，支持动态表单生成和自动化代码生成

字段说明

Field	Type	Collation	Null	Key	Default	Extra	Privileges	Comment
id	int	NULL	NO	PRI	NULL	auto_increment	select,insert,update,references	id
table_id	int	NULL	NO		0		select,insert,update,references	表id
column_name	varchar(100)	utf8mb4_general_ci	NO				select,insert,update,references	字段名称
column_comment	varchar(300)	utf8mb4_general_ci	NO				select,insert,update,references	字段描述
column_type	varchar(100)	utf8mb4_general_ci	NO				select,insert,update,references	字段类型
is_required	tinyint(1)	NULL	YES		0		select,insert,update,references	是否必填 0-非必填 1-必填
is_pk	tinyint(1)	NULL	YES		0		select,insert,update,references	是否为主键 0-不是 1-是
is_insert	tinyint(1)	NULL	YES		0		select,insert,update,references	是否为插入字段 0-不是 1-是
is_update	tinyint(1)	NULL	YES		0		select,insert,update,references	是否为更新字段 0-不是 1-是
is_lists	tinyint(1)	NULL	YES		1		select,insert,update,references	是否为列表字段 0-不是 1-是
is_query	tinyint(1)	NULL	YES		1		select,insert,update,references	是否为查询字段 0-不是 1-是
is_search	tinyint(1)	NULL	YES		1		select,insert,update,references	是否搜索字段
query_type	varchar(100)	utf8mb4_general_ci	YES		=		select,insert,update,references	查询类型
view_type	varchar(100)	utf8mb4_general_ci	YES		input		select,insert,update,references	显示类型
dict_type	varchar(255)	utf8mb4_general_ci	YES				select,insert,update,references	字典类型
addon	varchar(255)	utf8mb4_general_ci	YES				select,insert,update,references	远程下拉关联应用
model	varchar(255)	utf8mb4_general_ci	YES				select,insert,update,references	远程下拉关联model
label_key	varchar(255)	utf8mb4_general_ci	YES				select,insert,update,references	远程下拉标题字段
value_key	varchar(255)	utf8mb4_general_ci	YES				select,insert,update,references	远程下拉value字段
create_time	int	NULL	NO		0		select,insert,update,references	创建时间
update_time	int	NULL	NO		0		select,insert,update,references	修改时间
is_delete	tinyint	NULL	YES		0		select,insert,update,references	是否为软删除字段 0-不是 1-是
is_order	tinyint	NULL	YES		0		select,insert,update,references	是否为排序字段 0-不是 1-是
validate_type	varchar(255)	utf8mb4_general_ci	YES				select,insert,update,references	验证类型

功能用途

主要功能

• 字段配置管理: 管理代码生成器中每个字段的详细配置信息
• 表单控件配置: 定义字段在表单中的显示类型和交互方式
• 列表显示控制: 控制字段是否在列表页面中显示
• 查询条件配置: 设置字段的查询类型和搜索方式
• 数据验证规则: 定义字段的验证类型和必填规则
• 字典关联管理: 配置字段与数据字典的关联关系
• 远程数据源: 支持远程下拉选择的数据源配置
• 字段权限控制: 控制字段的增删改查权限

业务场景

• 代码自动生成: 根据配置自动生成CRUD页面和表单
• 动态表单构建: 根据配置动态生成各种业务表单
• 数据列表定制: 自定义数据列表的显示字段和格式
• 搜索条件配置: 配置高级搜索的查询条件和方式
• 数据导入导出: 配置数据导入导出的字段映射
• 报表字段配置: 定义报表中的字段显示和计算规则
• API接口生成: 根据配置自动生成RESTful API接口
• 移动端适配: 配置字段在移动端的显示方式
• 多语言支持: 支持字段标签的多语言配置

关联关系

主要关联表

• school_generate_table: 生成表配置表，关联字段所属的表配置
• school_sys_dict_type: 字典类型表，关联字段的字典配置
• school_sys_dict_data: 字典数据表，提供字段的选项数据
• school_sys_addon: 插件表，关联远程下拉的插件信息
• school_sys_model: 模型表，关联远程下拉的数据模型
• school_sys_user: 用户表，关联配置的创建和修改人员
• school_form_template: 表单模板表，关联生成的表单模板
• school_report_config: 报表配置表，关联报表字段配置

关联说明

• table_id 关联 school_generate_table.id，标识字段所属的表
• dict_type 关联 school_sys_dict_type.type，关联字典类型
• addon 关联 school_sys_addon.key，关联远程数据源插件
• model 关联 school_sys_model.name，关联数据模型
• label_key 和 value_key 定义远程下拉的显示和值字段
• 与代码生成器引擎关联，实现自动化代码生成
• 与表单渲染引擎关联，实现动态表单生成
• 与数据验证引擎关联，实现字段验证规则

索引建议

• 主键索引: PRIMARY KEY (id) - 自动创建
• 表ID索引: INDEX idx_table_id (table_id) - 支持按表查询字段配置
• 字段名索引: INDEX idx_column_name (column_name) - 支持按字段名查询
• 字段类型索引: INDEX idx_column_type (column_type) - 支持按字段类型查询
• 显示类型索引: INDEX idx_view_type (view_type) - 支持按显示类型查询
• 字典类型索引: INDEX idx_dict_type (dict_type) - 支持按字典类型查询
• 创建时间索引: INDEX idx_create_time (create_time) - 支持按创建时间查询
• 复合索引: INDEX idx_table_column (table_id, column_name) - 支持表和字段的复合查询
• 状态索引: INDEX idx_flags (is_required, is_pk, is_insert, is_update) - 支持按字段状态查询

注意事项

• 配置一致性: 确保字段配置与实际数据库表结构保持一致
• 类型匹配: 验证字段类型与显示类型的兼容性
• 权限控制: 严格控制字段配置的修改权限，防止误操作
• 缓存管理: 合理使用缓存提高配置读取性能
• 版本控制: 建立配置变更的版本控制和回滚机制
• 数据验证: 确保验证规则的正确性和有效性
• 性能优化: 避免过多的字段配置影响页面渲染性能
• 兼容性: 确保配置在不同浏览器和设备上的兼容性
• 安全性: 防止通过字段配置进行SQL注入等安全攻击
• 备份恢复: 定期备份重要的字段配置数据