低代码平台搭建规则规范

建立统一规则的目的

降低维护和沟通成本,内部人员形成统一
统一交互模式避免界面混乱
解决潜在的代码问题

数据字典字段维护规范

一.字典类型（主分类）维护规则

1.数据结构定义：系统所有枚举类字段统一采用数据字典类型进行配置，实现字典类型的集中维护与管理，保障字段枚举值的标准化、可扩展性与可维护性
2.类型编码命名规范：字典类型的编码需遵循大驼峰命名法，即每个单词首字母大写，其余字母小写，无下划线、无特殊字符，编码需与类型名称语义强关联，具备可读性与唯一性；示例：ProjectMode、Type

二.字典子项（明细枚举值）维护规则

编码命名规范

1.编码统一采用大写英文字母，禁止小写、数字、特殊字符

2.编码长度优先采用 2 位，为对应名称的拼音首字母缩写;

3.若2位编码存在重复冲突，则扩展为4 位，仍以名称拼音首字母缩写为基准，确保编码全局唯一

4.编码与子项名称一一对应，语义清晰、无歧义

示例：

投资建设→TZ
施工→SG
施工方式→SGFS

三、明细枚举值标签颜色规范

参考：(链接https://docs.youchaoyun.cn/cn/skills/product/color_specification/)

数据源维护规范

一、数据表标识与字段标识维护规则

1.命名规范：数据表标识和字段标识需遵循小驼峰命名法首单词全部小写，后续单词首字母大写，无下划线、无特殊字符、无空格

2.语义与唯一性要求：字段标识必须与字段名称语义强关联，符合业务含义，具备高可读性；同一数据表内的字段标识必须唯一，禁止重名

示例：

字典类型→dictTypes
全称→fullName
用户→users

二、配置字段-字段类型选型规范

核心选型原则

字段类型需严格匹配字段业务语义与数据存储需求，保障数据存储合规性、前端交互合理性与后续扩展性，全系统统一选型标准，避免类型混用；以下是常用的字段类型选型规则

配置字段-字段类型选型规范

字段类型需严格匹配字段业务语义与数据存储需求，保障数据存储合规性、前端交互合理性与后续扩展性，全系统统一选型标准，避免类型混用；以下是常用的字段类型选型规范：

字段类型分类	推荐字段类型标识	适用业务场景	选型说明
文本类	单行文本	短文本、名称、编码、枚举值、标识类	用于长度比较短的短文本字符
文本类	多行文本	原因、说明、备注、描述、大段文字输入	用于需要换行、多段落的长文本场景，支持纯文本与富文本配置
日期时间类	日期	仅需记录年月日的业务日期	用于无需时分秒的业务时间，适配工期、节点等场景
日期时间类	日期时间	需要完整记录年月日时分秒的时间	用于系统操作时间、日志时间等需要精确到秒的场景
关联关系类	一对多	主表关联多个子表数据	用于主表与子表一对多关联，支持子数据列表展示
关联关系类	多对一	从表关联单个主表数据	用于从表归属单个主表的场景，为常用关联类型
关联关系类	一对一	两个表一一对应关联	用于主表与扩展表一对一关联，适用于字段拆分、权限隔离
关联关系类	多对多	两个表互相多个关联	用于多对多交叉关联，支持双向选择与批量关联
选择类	数据字典(单选)	固定枚举值单选	用于固定选项单选场景，绑定数据字典维护
选择类	数据字典(多选)	固定枚举值多选	用于需要同时选择多个选项的场景，绑定数据字典维护
文件附件类	附件	文件、图片、文档上传	用于单文件或多文件上传，支持格式与大小校验
布尔状态类	布尔值	二选一状态、开关类	用于是 / 否、启用 / 停用等二元状态
数值类	整数	数量、次数、序号	用于整数型数值，支持范围校验
数值类	小数	金额、比例、计量值	用于带小数的数值，支持精度配置