Appearance
平台核心概念
ProCode 通过配置搭建业务应用：用菜单组织入口，用列表查询与操作数据，用表单录入与编辑，用页面与组件扩展界面，用接口与脚本扩展逻辑，用权限控制可见可操作范围。
功能说明
平台核心对象可以概括为下表。理解这些对象之后，再进入各引擎专页即可对号入座。
| 核心对象 | 作用 | 常见配置入口 |
|---|---|---|
| 菜单 | 侧栏功能入口，决定点进去打开什么 | 系统引擎 → 模块引擎 |
| 数据表 | 业务数据的字段结构 | 数据管理 → 数据仓库 |
| 表单 | 新增、编辑、查看界面 | 系统引擎 → 表单引擎 |
| 列表 | 查询、筛选、批量与行内操作 | 菜单打开为「数据列表」后，在列表中设计 |
| 页面 | 整页自定义界面（如大屏、报表页） | 菜单模版类型为「动态页面」 |
| 组件 | 可随时弹出的自定义浮层 | 系统引擎 → 组件引擎 |
| 接口 | 对外或对内可调用的服务能力 | 系统引擎 → 接口引擎 |
| 数据集 | 可复用的查询，多用于下拉等 | 数据管理 → 数据集 |
| 流程 | 业务审批与流转 | 系统引擎 → 流程引擎 |
| 权限 | 菜单、按钮、表单、接口的授权 | 组织架构 → 角色管理 |
| 脚本 | 在按钮、表单事件、接口中扩展行为 | 写在对应配置的命令 / 事件中 |
标准业务模块的推荐顺序：
建表 → 设计表单 → 设计列表 → 挂菜单 → 配置权限
需要时再增加接口、流程、动态页面、弹层组件或数据集。
原理
配置与运行
| 配置阶段 | 运行阶段 | |
|---|---|---|
| 目标 | 定义功能长什么样、怎么动 | 处理业务数据 |
| 操作者 | 实施与开发人员 | 业务用户 |
| 典型动作 | 建表、拖控件、配列、写脚本、授权 | 查询、填单、审批、导出 |
配置改变的是功能定义；列表与表单里的增删改改变的是业务数据。
菜单决定打开形态
每个菜单都有 模版类型，决定点击后打开哪种界面：
| 模版类型 | 打开结果 | 适用场景 |
|---|---|---|
| 数据列表 | 标准列表页 | 业务台账、管理类功能（最常见） |
| 动态页面 | 整页自定义界面 | 驾驶舱、报表页、定制工作台 |
| 外部链接 | 内嵌外部网址 | 集成已有系统 |
| 独立表单 | 直接打开一张表单 | 系统参数、单页配置类功能 |
| AI 对话 | AI 对话界面 | 智能助手入口 |
菜单还有 打开方式：在当前窗口或新窗口打开、是否带系统外框，或点击后只执行一段前端命令（不打开页面）。
列表与表单如何配合
- 列表负责「找数据、点操作」：列、搜索、过滤、排序、工具栏与行按钮。
- 表单负责「看一条、改一条」：字段布局、校验、保存前后逻辑。
- 常见交互：列表按钮打开表单（弹层、抽屉或页面），保存后回到列表刷新。
表单自身的打开方式（弹层 / 抽屉 / 页面）写在表单属性中，与菜单的打开方式不是同一概念。
页面与组件的区别
| 对象 | 用途 | 如何出现 |
|---|---|---|
| 动态页面 | 一整页的定制界面 | 由菜单进入 |
| 弹层组件 | 局部浮层，按需打开 | 由脚本或其它功能调用打开 |
| 表单控件 | 表单上的输入框、下拉等 | 画在表单设计器中 |
列表里的「页面设计」只是在调整当前列表的属性（如是否树形、是否多 Tab），并不是动态页面。
数据、数据集与接口
| 概念 | 说明 |
|---|---|
| 数据表 | 业务数据的存储结构，在数据仓库维护并同步到数据库 |
| 数据集 | 预定义查询，常被表单下拉等引用 |
| 接口 | 可编程的服务端能力；列表自定义数据源通常绑定接口，而不是数据集 |
脚本分层
| 位置 | 执行环境 | 适合做什么 |
|---|---|---|
| 列表按钮、菜单命令 | 浏览器 | 打开表单、跳转、调用接口、提示 |
| 表单前端事件 | 浏览器 | 联动、前端校验、打开时赋值 |
| 表单后端事件 | 服务器 | 保存规则、多表写入、服务端校验 |
| 接口脚本 | 服务器 | API 逻辑、复杂查询与处理 |
| 流程节点命令 | 服务器 | 审批节点前后的服务端逻辑 |
前端脚本与后端脚本运行环境不同，不能混用写法。后端事件中应填写脚本内容，而不是填写某个接口编号。
权限模型
角色可授予四类资源：
| 资源 | 控制内容 |
|---|---|
| 菜单 | 能否看见并进入功能 |
| 按钮 | 列表上某操作是否可用 |
| 表单 | 能否使用某张表单 |
| 接口 | 能否调用某个接口 |
功能配置完成后，必须为业务角色授权；验收时使用非管理员账号验证。
站点
平台按**站点（空间）**隔离配置与数据。配置菜单、表单、列表前，确认当前处于正确的站点上下文。
名词解释
| 名词 | 说明 |
|---|---|
| 菜单 | 侧栏入口；含标题、路由、模版类型、打开方式等 |
| 模版类型 | 菜单点击后打开列表、页面、外链、独立表单或 AI 对话 |
| 列表 | 数据查询与操作界面 |
| 表单 | 单条数据的录入与编辑界面 |
| 表单控件 | 表单上的字段组件 |
| 动态页面 | 菜单级整页自定义界面 |
| 组件 | 可复用的自定义弹层（组件引擎） |
| 接口 | 可调用的服务端能力 |
| 数据集 | 可复用查询定义 |
| 流程 | 业务审批流 |
| 前端脚本 | 在浏览器执行的扩展逻辑 |
| 后端脚本 | 在服务器执行的扩展逻辑 |
| 站点 / 空间 | 配置与数据的隔离范围 |
属性说明
菜单常用属性
| 属性 | 说明 |
|---|---|
| 标题 | 侧栏显示名称 |
| 父级 | 所属目录 |
| 图标 | 侧栏图标 |
| 路由 | 访问路径 |
| 模版类型 | 打开列表 / 页面 / 外链 / 独立表单 / AI 对话 |
| 打开方式 | 窗口、是否带外框，或执行命令 |
| 外链 | 外部链接地址（外链类型时使用） |
| 命令 | 执行命令时运行的前端脚本 |
| 是否显示 / 是否激活 | 显示与启用 |
| 匿名访问 | 未登录是否可进入 |
表单常用属性
| 属性 | 说明 |
|---|---|
| 绑定数据表 | 表单读写哪张业务表 |
| 打开方式 | 弹层 / 抽屉 / 页面 |
| 宽度 | 弹层或页面宽度 |
| 页签 | 字段分组（可选） |
| 前端 / 后端事件 | 打开、保存等时机的脚本 |
列表常见构成
| 构成 | 说明 |
|---|---|
| 列 | 展示哪些字段、如何显示 |
| 按钮 | 工具栏、操作列、右键等 |
| 搜索 | 顶部查询条件 |
| 过滤 | 固定只显示符合条件的数据 |
| 排序 | 默认排序规则 |
| 树 / 多 Tab | 可选的高级布局 |
示例
标准台账
- 在数据仓库创建业务表并同步。
- 在表单引擎设计表单与控件。
- 配置列表的列、搜索与按钮，按钮中打开表单。
- 在模块引擎新增菜单，模版类型选择「数据列表」。
- 在角色管理中授予菜单及必要的按钮、表单权限。
- 用业务账号登录验收增删改查。
按目标选择对象
| 目标 | 主要使用 |
|---|---|
| 侧栏增加功能入口 | 菜单 |
| 查询与操作一批数据 | 列表 + 表单 |
| 整页大屏或报表 | 动态页面 |
| 流程中弹出定制层 | 组件 |
| 对外提供 API | 接口 |
| 下拉选项复用复杂查询 | 数据集 |
| 单据审批 | 流程 |
| 控制谁能用 | 权限 |
常见混淆
| 容易混淆 | 如何区分 |
|---|---|
| 动态页面 vs 列表「页面设计」 | 前者是整页菜单；后者是列表自身属性 |
| 表单控件 vs 组件引擎 | 前者是表单字段；后者是可调用的弹层 |
| 菜单打开方式 vs 表单打开方式 | 前者管菜单怎么进；后者管表单怎么弹 |
| 数据集 vs 接口 | 数据集多为下拉等引用；列表自定义数据源一般用接口 |
| 业务流程 vs AI 能力 | 流程引擎做审批；AI 相关能力见 AI 文档 |