@microi.net/cli 4.6.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/LICENSE +21 -0
- package/README.md +66 -0
- package/dist/mcp-codex-stdio-adapter.js +189 -0
- package/dist/mcp-server.js +972 -0
- package/dist/mcp-trae-windows-launcher.cmd +21 -0
- package/dist/microi-cli-mcp.js +7 -0
- package/dist/microi-cli.js +1645 -0
- package/dist/microi-skills.meta.json +335 -0
- package/dist/microi.skills/.microi-skills-version.json +6 -0
- package/dist/microi.skills/README.md +276 -0
- package/dist/microi.skills/ai-engine/SKILL.md +140 -0
- package/dist/microi.skills/ai-engine/agents/openai.yaml +4 -0
- package/dist/microi.skills/app-store/SKILL.md +105 -0
- package/dist/microi.skills/app-store/agents/openai.yaml +4 -0
- package/dist/microi.skills/business-blueprint/SKILL.md +184 -0
- package/dist/microi.skills/datasource-engine/SKILL.md +89 -0
- package/dist/microi.skills/datasource-engine/agents/openai.yaml +4 -0
- package/dist/microi.skills/dos-orm/SKILL.md +76 -0
- package/dist/microi.skills/dos-orm/references/api-reference.md +229 -0
- package/dist/microi.skills/job-engine/SKILL.md +141 -0
- package/dist/microi.skills/job-engine/agents/openai.yaml +4 -0
- package/dist/microi.skills/message-notification/SKILL.md +113 -0
- package/dist/microi.skills/message-notification/agents/openai.yaml +6 -0
- package/dist/microi.skills/message-notification/references/contracts.md +99 -0
- package/dist/microi.skills/microi-ai-app-auth.js +651 -0
- package/dist/microi.skills/microi-ai-application/SKILL.md +80 -0
- package/dist/microi.skills/microi-ai-application/agents/openai.yaml +4 -0
- package/dist/microi.skills/microi-ai-application/references/frontend-baseline.md +164 -0
- package/dist/microi.skills/microi-client-frontend/SKILL.md +562 -0
- package/dist/microi.skills/microi-datasource-mapping/SKILL.md +108 -0
- package/dist/microi.skills/microi-db-schema/SKILL.md +170 -0
- package/dist/microi.skills/microi-db-schema/agents/openai.yaml +4 -0
- package/dist/microi.skills/microi-db-schema/references/core-tables.md +695 -0
- package/dist/microi.skills/microi-db-schema/references/form-component-options.md +256 -0
- package/dist/microi.skills/microi-db-schema/references/schema-overview.md +203 -0
- package/dist/microi.skills/microi-db-schema/references/schema.md +647 -0
- package/dist/microi.skills/microi-db-schema/references/table-catalog.md +1607 -0
- package/dist/microi.skills/microi-deployment/SKILL.md +117 -0
- package/dist/microi.skills/microi-deployment/references/deployment-matrix.md +94 -0
- package/dist/microi.skills/microi-docs-coverage/SKILL.md +91 -0
- package/dist/microi.skills/microi-docs-coverage/references/capability-map.md +65 -0
- package/dist/microi.skills/microi-docs-coverage/scripts/audit-doc-skill-coverage.mjs +887 -0
- package/dist/microi.skills/microi-form-engine/SKILL.md +159 -0
- package/dist/microi.skills/microi-form-engine/references/component-catalog.md +116 -0
- package/dist/microi.skills/microi-form-engine/references/data-source-events.md +117 -0
- package/dist/microi.skills/microi-form-layout/SKILL.md +373 -0
- package/dist/microi.skills/microi-frontend-sdk/SKILL.md +304 -0
- package/dist/microi.skills/microi-left-right-layout/SKILL.md +132 -0
- package/dist/microi.skills/microi-microservice/SKILL.md +115 -0
- package/dist/microi.skills/microi-microservice/references/runtime-delivery.md +145 -0
- package/dist/microi.skills/microi-mobile-app-quality/SKILL.md +436 -0
- package/dist/microi.skills/microi-solution-quotation/SKILL.md +76 -0
- package/dist/microi.skills/microi-solution-quotation/agents/openai.yaml +4 -0
- package/dist/microi.skills/microi-solution-quotation/scripts/build_solution_quote.py +296 -0
- package/dist/microi.skills/microi-system-delivery/SKILL.md +446 -0
- package/dist/microi.skills/microi-ui/SKILL.md +321 -0
- package/dist/microi.skills/microi-uniapp-frontend/SKILL.md +483 -0
- package/dist/microi.skills/microi.v8.js +1758 -0
- package/dist/microi.skills/module-engine/SKILL.md +131 -0
- package/dist/microi.skills/module-engine/references/module-config.md +174 -0
- package/dist/microi.skills/page-engine/SKILL.md +397 -0
- package/dist/microi.skills/performance-testing/SKILL.md +207 -0
- package/dist/microi.skills/playwright-e2e/SKILL.md +769 -0
- package/dist/microi.skills/print-engine/SKILL.md +237 -0
- package/dist/microi.skills/production-readonly-audit/SKILL.md +39 -0
- package/dist/microi.skills/report-engine/SKILL.md +69 -0
- package/dist/microi.skills/report-engine/agents/openai.yaml +4 -0
- package/dist/microi.skills/search-engine/SKILL.md +73 -0
- package/dist/microi.skills/search-engine/agents/openai.yaml +4 -0
- package/dist/microi.skills/spider-engine/SKILL.md +188 -0
- package/dist/microi.skills/translate-engine/SKILL.md +91 -0
- package/dist/microi.skills/translate-engine/agents/openai.yaml +4 -0
- package/dist/microi.skills/ui-design/SKILL.md +1575 -0
- package/dist/microi.skills/ui-design/assets/pattern-showcase/app.js +54 -0
- package/dist/microi.skills/ui-design/assets/pattern-showcase/index.html +163 -0
- package/dist/microi.skills/ui-design/assets/pattern-showcase/styles.css +311 -0
- package/dist/microi.skills/ui-design/assets/templates/MCI-DESIGN.md +98 -0
- package/dist/microi.skills/ui-design/references/design-pattern-library.md +171 -0
- package/dist/microi.skills/ui-design/references/mci-design-contract.md +84 -0
- package/dist/microi.skills/ui-design/references/motion-and-media.md +71 -0
- package/dist/microi.skills/ui-design/references/product-flow-recipes.md +94 -0
- package/dist/microi.skills/uniapp-mall-assets/SKILL.md +105 -0
- package/dist/microi.skills/v8-api-config/SKILL.md +272 -0
- package/dist/microi.skills/v8-cache-pattern/SKILL.md +286 -0
- package/dist/microi.skills/v8-crud-api/SKILL.md +398 -0
- package/dist/microi.skills/v8-debugging/SKILL.md +279 -0
- package/dist/microi.skills/v8-explorer-tree/SKILL.md +224 -0
- package/dist/microi.skills/v8-export-import/SKILL.md +590 -0
- package/dist/microi.skills/v8-file-upload/SKILL.md +497 -0
- package/dist/microi.skills/v8-formengine-http/SKILL.md +218 -0
- package/dist/microi.skills/v8-frontend-events/SKILL.md +349 -0
- package/dist/microi.skills/v8-frontend-events/references/bluetooth-print-api.md +107 -0
- package/dist/microi.skills/v8-frontend-events/references/bluetooth-print.md +185 -0
- package/dist/microi.skills/v8-http-integration/SKILL.md +379 -0
- package/dist/microi.skills/v8-image-processing/SKILL.md +187 -0
- package/dist/microi.skills/v8-image-processing/agents/openai.yaml +4 -0
- package/dist/microi.skills/v8-image-processing/references/api-reference.md +620 -0
- package/dist/microi.skills/v8-menu-buttons/SKILL.md +661 -0
- package/dist/microi.skills/v8-mongodb/SKILL.md +149 -0
- package/dist/microi.skills/v8-mq-mqtt/SKILL.md +227 -0
- package/dist/microi.skills/v8-saas-multi-tenant/SKILL.md +193 -0
- package/dist/microi.skills/v8-security/SKILL.md +417 -0
- package/dist/microi.skills/v8-sql-query/SKILL.md +290 -0
- package/dist/microi.skills/v8-table-event/SKILL.md +385 -0
- package/dist/microi.skills/v8-template-engine/SKILL.md +165 -0
- package/dist/microi.skills/v8-utilities/SKILL.md +79 -0
- package/dist/microi.skills/v8-utilities/references/client-api-index.md +136 -0
- package/dist/microi.skills/v8-utilities/references/platform-http-routes.md +80 -0
- package/dist/microi.skills/v8-utilities/references/server-api-index.md +129 -0
- package/dist/microi.skills/v8-workflow/SKILL.md +322 -0
- package/dist/microi.skills/workspace-conventions/SKILL.md +479 -0
- package/package.json +40 -0
|
@@ -0,0 +1,256 @@
|
|
|
1
|
+
# Microi 表单组件配置项参考
|
|
2
|
+
|
|
3
|
+
本参考用于 AI 生成、审查或修复 `diy_field.Config`。事实源仍是 `Microi.Client/src/views/form-engine/diy-field-component/` 与 `diy-component-list.json`;组件源码新增配置时,必须同步更新本文件和官方文档。
|
|
4
|
+
|
|
5
|
+
## 字段级元数据
|
|
6
|
+
|
|
7
|
+
| 字段 | 说明 |
|
|
8
|
+
| --- | --- |
|
|
9
|
+
| `Label` / `Name` | 显示名 / 物理字段名。`Name` 使用 PascalCase 或既有表字段名,不写中文。 |
|
|
10
|
+
| `Type` | 物理列类型,只使用平台允许类型:`varchar(N)`、`mediumtext`、`longtext`、`int`、`bigint`、`decimal(18,N)`。日期时间存 `varchar(25)`。 |
|
|
11
|
+
| `Component` | 控件类型,例如 `Text`、`Select`、`TableChild`。 |
|
|
12
|
+
| `NotEmpty` / `Readonly` | 必填、只读。 |
|
|
13
|
+
| `Visible` / `AppVisible` | PC / App 是否显示,默认业务字段为 `1`。 |
|
|
14
|
+
| `TableWidth` / `FormWidth` | 列表宽度 / 表单栅格宽度。普通字段一般不设置 `FormWidth`;上传、富文本、代码、地图、子表等整行控件设 `24`。 |
|
|
15
|
+
| `Data` | 选项类控件静态数据,常用 KeyValue:`key|label,key2|label2`。 |
|
|
16
|
+
| `DefaultValue` / `Placeholder` / `Tab` | 默认值、占位提示、表单 Tab 分组。 |
|
|
17
|
+
| `V8Code` / `KeyupV8Code` / `V8TmpEngineTable` / `V8TmpEngineForm` | 字段前端事件或 V8 模板代码。代码必须格式化,不要写成单行。 |
|
|
18
|
+
|
|
19
|
+
## 通用 `Config` 根节点
|
|
20
|
+
|
|
21
|
+
| 配置 | 说明 |
|
|
22
|
+
| --- | --- |
|
|
23
|
+
| `EnableSearch` | 是否作为搜索条件。 |
|
|
24
|
+
| `ParamData` | 组件请求或 V8 使用的附加参数。 |
|
|
25
|
+
| `Sql` | SQL 数据源查询语句。动态值使用平台占位或后端参数化规则,不拼接用户输入。 |
|
|
26
|
+
| `DataSource` | 数据源类型:`Data`、`KeyValue`、`Sql`、`ApiEngine`、`DataSource` 等。 |
|
|
27
|
+
| `DataSourceSqlRemote` / `DataSourceSqlRemoteLoading` | SQL 是否远程搜索 / 加载态。 |
|
|
28
|
+
| `DataSourceId` / `DataSourceApiEngineKey` | 数据源引擎 Id / 接口引擎 Key。 |
|
|
29
|
+
| `SelectLabel` / `SelectSaveField` | 下拉、树、级联等显示字段 / 保存字段。 |
|
|
30
|
+
| `SelectSaveFormat` | 保存格式,常用 `Text` 或 `Json`。 |
|
|
31
|
+
| `V8Code` / `V8CodeBlur` | 值变更、失焦事件代码。 |
|
|
32
|
+
| `TextIcon` / `TextIconPosition` | 输入框图标与位置。 |
|
|
33
|
+
| `TextApend` / `TextApendPosition` | 输入框前后缀文本与位置。 |
|
|
34
|
+
| `TextShowPassword` / `TextAutocomplete` | 密码显示模式 / 浏览器联想。 |
|
|
35
|
+
| `DateTimeType` | 日期控件类型,如 `date`、`datetime`。 |
|
|
36
|
+
| `DevComponentName` / `DevComponentPath` | 自定义组件名称和路径。 |
|
|
37
|
+
| `MapCompany` | 地图服务商,默认 `Baidu`。 |
|
|
38
|
+
|
|
39
|
+
## 基础输入类
|
|
40
|
+
|
|
41
|
+
| 组件 | 推荐类型 | 配置项 |
|
|
42
|
+
| --- | --- | --- |
|
|
43
|
+
| `Text` | `varchar(200)` | 使用通用文本配置:`TextShowPassword`、`TextIcon`、`TextApend`、`V8CodeBlur`。 |
|
|
44
|
+
| `Guid` | `varchar(50)` | 通常只读,用于保存业务关联 GUID。 |
|
|
45
|
+
| `Textarea` | `mediumtext` | `Textarea.DefaultRows` 控制默认行数。 |
|
|
46
|
+
| `NumberText` | `int` 或 `decimal(18,N)` | `NumberTextStep`、`NumberTextPrecision`、`NumberTextMath`、`NumberTextBtn`、`NumberTextBtnPosition`。 |
|
|
47
|
+
| `DateTime` | `varchar(25)` | `DateTimeType` 控制日期、日期时间等模式。 |
|
|
48
|
+
| `Switch` | `int` | 存 `1/0`,不要用 `varchar` 或 `boolean`。 |
|
|
49
|
+
| `Rate` / `Progress` / `Slider` | `int` | 评分、进度、滑块值。 |
|
|
50
|
+
| `ColorPicker` | `varchar(50)` | 保存颜色字符串。 |
|
|
51
|
+
|
|
52
|
+
## 选项和数据源类
|
|
53
|
+
|
|
54
|
+
| 组件 | 推荐类型 | 配置项 |
|
|
55
|
+
| --- | --- | --- |
|
|
56
|
+
| `Select` | `varchar(50)` | 必须配置 `Data` 或 `Config.DataSource`;常用 `SelectLabel`、`SelectSaveField`、`SelectSaveFormat`。 |
|
|
57
|
+
| `MultipleSelect` | `varchar(500)` 或 `mediumtext` | 同 `Select`,多选值通常保存 JSON 或分隔文本。 |
|
|
58
|
+
| `Radio` | `varchar(50)` | 必须配置选项数据。 |
|
|
59
|
+
| `Checkbox` | `varchar(500)` 或 `mediumtext` | 必须配置选项数据,多值保存 JSON。 |
|
|
60
|
+
| `Autocomplete` | `varchar(200)` | 可配 SQL/API 数据源,允许输入联想。 |
|
|
61
|
+
| `TagInput` | `mediumtext` | `TagInput.Placeholder`、`TagInput.Options`、`TagInput.MaxCount`。 |
|
|
62
|
+
| `Transfer` | `mediumtext` | `Transfer.LeftTitle`、`Transfer.RightTitle`、`Transfer.Filterable`、`Transfer.Options`。 |
|
|
63
|
+
|
|
64
|
+
## 布局和说明类
|
|
65
|
+
|
|
66
|
+
| 组件 | 说明 | 配置项 |
|
|
67
|
+
| --- | --- | --- |
|
|
68
|
+
| `Divider` | 分割线,不保存业务值 | `DividerPosition`、`Divider.Icon`。 |
|
|
69
|
+
| `CollapseGroup` | 折叠分组 | `CollapseGroup.DefaultCollapsed`、`ScopeMode`、`FieldCount`、`UntilNextGroup`、`Description`、`Icon`、`Theme`、`ShowFieldCount`。 |
|
|
70
|
+
| `Tabs` | 字段级页签分组 | `FieldTabs.DefaultActiveKey`、`FieldTabs.Tabs[{Key,Label,Icon,Description}]`。 |
|
|
71
|
+
| `Alert` | 表单提示 | `Alert.Title`、`Content`、`Type`、`Effect`、`ShowIcon`。 |
|
|
72
|
+
| `StaticText` | 静态文本展示 | `StaticText.Content`、样式类配置。 |
|
|
73
|
+
| `Html` | HTML 内容 | 保存 HTML 字符串;注意 XSS 风险。 |
|
|
74
|
+
| `Button` | 表单按钮 | `Button.Type`、`Loading`、`Icon`、`Size`、`PreviewCanClick`、`RefreshTableAfterClick`,点击逻辑写格式化 V8。 |
|
|
75
|
+
|
|
76
|
+
## 富文本、代码、上传
|
|
77
|
+
|
|
78
|
+
| 组件 | 推荐类型 | 配置项 |
|
|
79
|
+
| --- | --- | --- |
|
|
80
|
+
| `RichText` | `mediumtext` | 富文本内容,图片上传遵循平台上传配置。 |
|
|
81
|
+
| `CodeEditor` | `mediumtext` | `CodeEditor.Height`。 |
|
|
82
|
+
| `JsonTable` | `mediumtext` | JSON 表格展示/编辑,保存结构化 JSON;配置必须写在 `Config.JsonTable`。 |
|
|
83
|
+
| `ImgUpload` | `mediumtext` | `ImgUpload.Limit`、`Multiple`、`Tips`、`MaxCount`、`ShowFileList`、`Preview`、`MaxSize`。 |
|
|
84
|
+
| `FileUpload` | `mediumtext` | `FileUpload.Limit`、`Multiple`、`Tips`、`MaxCount`、`ShowFileList`、`MaxSize`。 |
|
|
85
|
+
| `ImgUpload` / `FileUpload` | - | `Upload.BeforeUploadV8`、`GetPrivateFileBeforeServerV8`、`GetPrivateFileAfterServerV8`。 |
|
|
86
|
+
|
|
87
|
+
### JsonTable 配置
|
|
88
|
+
|
|
89
|
+
`JsonTable` 的事实源是 `Microi.Client/src/views/form-engine/diy-field-component/diy-jsontable.vue`。AI 生成字段时不要只写 `Component=JsonTable`,必须同步生成 `Config.JsonTable.Columns`,否则前端只能显示空表。
|
|
90
|
+
|
|
91
|
+
`Config.JsonTable` 根节点:
|
|
92
|
+
|
|
93
|
+
| 配置 | 说明 |
|
|
94
|
+
| --- | --- |
|
|
95
|
+
| `Columns` | JSON 表格列数组,必填。每一项描述一列的显示、编辑控件和数据源。 |
|
|
96
|
+
| `DataSource` | 批量导入/候选数据源类型:`KeyValue`、`Sql`、`DataSource`、`ApiEngine` 等。 |
|
|
97
|
+
| `Sql` | `DataSource=Sql` 时的 SQL;远程搜索时必须带 `$Keyword$` 条件和 `limit`。 |
|
|
98
|
+
| `DataSourceId` | `DataSource=DataSource` 时的数据源引擎 Key/Id。 |
|
|
99
|
+
| `ApiEngineKey` / `DataSourceApiEngineKey` | `DataSource=ApiEngine` 时的接口引擎 Key;前端保存到 `ApiEngineKey`,列级配置可用 `DataSourceApiEngineKey`。 |
|
|
100
|
+
| `SelectLabel` | 候选数据展示字段。 |
|
|
101
|
+
| `DataSourceSqlRemote` | 是否远程搜索。大数据量必须设为 `true`。 |
|
|
102
|
+
| `KeyValueList` | 静态键值数据,格式为 `[{ "Key": "A", "Value": "选项A" }]`。 |
|
|
103
|
+
|
|
104
|
+
`Config.JsonTable.Columns[]` 列对象:
|
|
105
|
+
|
|
106
|
+
| 配置 | 说明 |
|
|
107
|
+
| --- | --- |
|
|
108
|
+
| `Id` | 列唯一 Id,建议使用 Guid/Ulid。 |
|
|
109
|
+
| `Sort` | 列排序。 |
|
|
110
|
+
| `Label` | 列标题,必填。 |
|
|
111
|
+
| `Key` | JSON 行对象中的属性名,必填,使用英文或既有字段名。 |
|
|
112
|
+
| `Component` | 列编辑控件:`Text`、`Number`、`Textarea`、`Password`、`Select`、`MultipleSelect`、`Radio`、`Checkbox`、`Switch`、`Cascader`、`SelectTree`、`DateTime`、`Rate`、`ColorPicker`、`Progress`、`AutoNumber`、`Autocomplete`、`Address`、`Department`、`Map`、`ImgUpload`、`FileUpload`、`RichText`、`CodeEditor`、`Html`、`Fontawesome`、`Qrcode`、`Divider`、`Button`。 |
|
|
113
|
+
| `Width` / `MinWidth` | 固定宽度 / 最小宽度,`MinWidth` 默认可用 `120`。 |
|
|
114
|
+
| `Required` | 是否必填。 |
|
|
115
|
+
| `Visible` | 是否显示,默认 `true`。 |
|
|
116
|
+
| `DefaultValue` | 新增行默认值。 |
|
|
117
|
+
| `Placeholder` | 占位提示。 |
|
|
118
|
+
| `Readonly` | 是否只读。 |
|
|
119
|
+
| `Config` | 列控件配置。选择类列使用 `SelectLabel`、`SelectSaveField`、`SelectSaveFormat`、`EnableSearch`、`DataSource`、`Sql`、`DataSourceId`、`DataSourceApiEngineKey`、`DataSourceSqlRemote`。 |
|
|
120
|
+
| `Data` | 列级普通静态选项。 |
|
|
121
|
+
| `KeyValueList` | 列级键值选项,格式同根节点。 |
|
|
122
|
+
|
|
123
|
+
示例:
|
|
124
|
+
|
|
125
|
+
```json
|
|
126
|
+
{
|
|
127
|
+
"JsonTable": {
|
|
128
|
+
"Columns": [
|
|
129
|
+
{
|
|
130
|
+
"Id": "col-material",
|
|
131
|
+
"Sort": 1,
|
|
132
|
+
"Label": "材料名称",
|
|
133
|
+
"Key": "MaterialName",
|
|
134
|
+
"Component": "Text",
|
|
135
|
+
"MinWidth": 160,
|
|
136
|
+
"Required": true,
|
|
137
|
+
"Visible": true,
|
|
138
|
+
"Placeholder": "请输入材料名称"
|
|
139
|
+
},
|
|
140
|
+
{
|
|
141
|
+
"Id": "col-status",
|
|
142
|
+
"Sort": 2,
|
|
143
|
+
"Label": "状态",
|
|
144
|
+
"Key": "Status",
|
|
145
|
+
"Component": "Select",
|
|
146
|
+
"MinWidth": 120,
|
|
147
|
+
"Visible": true,
|
|
148
|
+
"Config": {
|
|
149
|
+
"DataSource": "KeyValue",
|
|
150
|
+
"SelectLabel": "Value",
|
|
151
|
+
"SelectSaveField": "Key",
|
|
152
|
+
"SelectSaveFormat": "Text"
|
|
153
|
+
},
|
|
154
|
+
"KeyValueList": [
|
|
155
|
+
{ "Key": "draft", "Value": "草稿" },
|
|
156
|
+
{ "Key": "confirmed", "Value": "已确认" }
|
|
157
|
+
]
|
|
158
|
+
}
|
|
159
|
+
]
|
|
160
|
+
}
|
|
161
|
+
}
|
|
162
|
+
```
|
|
163
|
+
|
|
164
|
+
## 树、级联、组织
|
|
165
|
+
|
|
166
|
+
| 组件 | 推荐类型 | 配置项 |
|
|
167
|
+
| --- | --- | --- |
|
|
168
|
+
| `Cascader` | `varchar(500)` 或 `mediumtext` | `Cascader.Lazy`、`Filterable`、`Value`、`Label`、`Children`、`ParentField`、`ParentFields`、`Multiple`、`Disabled`、`Leaf`、`EmitPath`。 |
|
|
169
|
+
| `SelectTree` | `varchar(50)` | `SelectTree.Lazy`、`Filterable`、`Value`、`Label`、`Children`、`ParentField`、`ParentFields`、`Multiple`、`Disabled`、`Leaf`。 |
|
|
170
|
+
| `TreeCheckbox` | `mediumtext` | `TreeCheckbox.DataSourceType`、`DataSourceApi`、`ShowSearch`、`ShowIcon`、`DefaultExpandAll`、`NameColumnWidth`、`NameColumnLabel`、`PermissionColumnLabel`。 |
|
|
171
|
+
| `Department` | `varchar(50)` 或 `varchar(500)` | `Department.Multiple`、`Filterable`、`EmitPath`。 |
|
|
172
|
+
| `Address` | `varchar(500)` | 省市区地址选择,通常保存路径或 JSON。 |
|
|
173
|
+
|
|
174
|
+
## 弹表、关联表、子表
|
|
175
|
+
|
|
176
|
+
| 组件 | 推荐类型 | 配置项 |
|
|
177
|
+
| --- | --- | --- |
|
|
178
|
+
| `OpenTable` | `varchar(50)` | `OpenTable.BtnName`、`ShowDialog`、`MultipleSelect`、`BeforeOpenV8`、`SubmitV8`、`SearchAppend`。 |
|
|
179
|
+
| `JoinTable` | `varchar(50)` | `JoinTable.TableId`、`ModuleName`、`ModuleId`、`Where`。 |
|
|
180
|
+
| `JoinForm` | `varchar(50)` | `JoinForm.TableId`、`TableName`、`JoinFieldName`、`Id`、`FormMode`、`_SearchEqual`。主表字段保存一个目标记录 Id。 |
|
|
181
|
+
| `TableChild` | 控件字段通常不承担关系存储 | 根节点:`TableChildTableId`、`TableChildSysMenuId`、`TableChildSysMenuName`、`TableChildFkFieldName`、`TableChildRowClickV8`。真实关系列必须建在子表。 |
|
|
182
|
+
| `TableChild` | - | `TableChild.PrimaryTableFieldName`:主表关联字段,默认 `Id`;`DisablePagination`:子表是否禁用分页;`NoneDefaultHeight`:是否不使用默认高度;`Data`、`SearchAppend`、`LastTableId`、`LastSysMenuId`、`LastSysMenuName`。 |
|
|
183
|
+
| `TableChild` | - | `TableChild.ImportAutoFillFk`:导入子表时自动补外键;`FieldRelations[[Parent,Child,ImportMatch?]]`:全部关系用于新增回写和导入回填,第三位 `true` 的关系用于导入反查主表。 |
|
|
184
|
+
|
|
185
|
+
### `JoinForm` / `TableChild` 选择门禁
|
|
186
|
+
|
|
187
|
+
| 业务问题 | 正确组件 |
|
|
188
|
+
| --- | --- |
|
|
189
|
+
| 当前记录保存一个目标 Id,并内嵌该独立目标记录的完整表单 | `JoinForm` |
|
|
190
|
+
| 一条父记录拥有 0..N 条明细,需要列表、分页或多行增删改 | `TableChild` |
|
|
191
|
+
| 只需从列表选择一条/多条,不需要内嵌完整目标表单 | `OpenTable` |
|
|
192
|
+
|
|
193
|
+
- “明细、子表、清单、条目、行项目、多个记录”默认选择 `TableChild`;基数不清楚时先询问。
|
|
194
|
+
- `JoinForm` 渲染单条 `diy-form`,目标 `TableId/TableName` 必须与当前表不同;指回当前表时
|
|
195
|
+
组件不会初始化。`JoinFieldName` 是**当前主表中保存目标 Id 的字段名**。
|
|
196
|
+
- `TableChild` 渲染 `diy-table`。子表必须有物理外键,控件必须同时拿到真实的子表 Id、
|
|
197
|
+
子表菜单 Id 和外键字段名;不得猜 Id 或用 `JoinForm` 代替未完成的两阶段配置。
|
|
198
|
+
- 例:订单商品明细应为 `order_detail.OrderId + TableChild`;工单内嵌一个客户档案才是
|
|
199
|
+
`work_order.CustomerId + JoinForm`。
|
|
200
|
+
|
|
201
|
+
### JoinForm 示例
|
|
202
|
+
|
|
203
|
+
```json
|
|
204
|
+
{
|
|
205
|
+
"JoinForm": {
|
|
206
|
+
"TableId": "<目标 diy_table.Id>",
|
|
207
|
+
"TableName": "",
|
|
208
|
+
"JoinFieldName": "CustomerId",
|
|
209
|
+
"FormMode": "View",
|
|
210
|
+
"Id": "",
|
|
211
|
+
"_SearchEqual": {}
|
|
212
|
+
}
|
|
213
|
+
}
|
|
214
|
+
```
|
|
215
|
+
|
|
216
|
+
字段设计器选择 `TableId` 时会清空 `TableName`;动态配置也可以只给目标 `TableName`,
|
|
217
|
+
二者至少提供一个,不要把当前表作为目标表。
|
|
218
|
+
|
|
219
|
+
### TableChild 完整示例
|
|
220
|
+
|
|
221
|
+
```json
|
|
222
|
+
{
|
|
223
|
+
"TableChildTableId": "01KNRCSVFK2W4NCWYBTVH9HGM2",
|
|
224
|
+
"TableChildSysMenuId": "01KNRM72C6KBG4S8CY341333XJ",
|
|
225
|
+
"TableChildSysMenuName": "项目成品清单",
|
|
226
|
+
"TableChildFkFieldName": "Guid",
|
|
227
|
+
"TableChild": {
|
|
228
|
+
"PrimaryTableFieldName": "Id",
|
|
229
|
+
"Data": [],
|
|
230
|
+
"SearchAppend": {},
|
|
231
|
+
"ImportAutoFillFk": true,
|
|
232
|
+
"FieldRelations": [
|
|
233
|
+
["Code", "XiangmuBM", true],
|
|
234
|
+
["Name", "XiangmuMC"]
|
|
235
|
+
],
|
|
236
|
+
"LastTableId": "",
|
|
237
|
+
"LastSysMenuId": "",
|
|
238
|
+
"LastSysMenuName": "",
|
|
239
|
+
"DisablePagination": false,
|
|
240
|
+
"NoneDefaultHeight": false
|
|
241
|
+
}
|
|
242
|
+
}
|
|
243
|
+
```
|
|
244
|
+
|
|
245
|
+
`FieldRelations` 每项依次为主表字段、子表字段、可选的导入匹配标记。上例只用编号反查主表,名称仅回填。通过主表子表区域、左右树形页面或 `V8.OpenAnyTable` 带主表条件打开子表后导入时,即使 Excel 没有 `XiangmuBM` / `XiangmuMC`,后端也应根据固定主表行回填外键和展示列。旧三项配置仍由前后端兼容读取,并在字段下次保存时合并清理。
|
|
246
|
+
|
|
247
|
+
## 地图、二维码、图标、自定义
|
|
248
|
+
|
|
249
|
+
| 组件 | 推荐类型 | 配置项 |
|
|
250
|
+
| --- | --- | --- |
|
|
251
|
+
| `Map` | `varchar(200)` | 地图点位,使用 `MapCompany`。 |
|
|
252
|
+
| `MapArea` | `mediumtext` | 地图区域,多边形或区域 JSON。 |
|
|
253
|
+
| `Qrcode` | `varchar(500)` | 二维码内容或生成源字段。 |
|
|
254
|
+
| `FontAwesome` | `varchar(100)` | 图标类名。 |
|
|
255
|
+
| `DevComponent` | 视组件而定 | `DevComponentName`、`DevComponentPath`。 |
|
|
256
|
+
| `V8TmpEngine` | `mediumtext` | V8 模板引擎承载控件。 |
|
|
@@ -0,0 +1,203 @@
|
|
|
1
|
+
# Microi DB Schema Overview
|
|
2
|
+
|
|
3
|
+
- Source: `ai-helper/microi/db.json`
|
|
4
|
+
- Tables: 75
|
|
5
|
+
- Configurable fields: 975
|
|
6
|
+
|
|
7
|
+
## Fixed Fields
|
|
8
|
+
|
|
9
|
+
DIY tables created by the platform include fixed fields even when they are not present in the exported `_Fields`: `Id`, `CreateTime`, `UpdateTime`, `UserId`, `UserName`, `IsDeleted`.
|
|
10
|
+
|
|
11
|
+
## Core Relationships
|
|
12
|
+
|
|
13
|
+
| Relationship | Meaning |
|
|
14
|
+
|---|---|
|
|
15
|
+
| `diy_table.Id` -> `diy_field.TableId` | One table has many field definitions. |
|
|
16
|
+
| `diy_table.Name` | Table key used by `V8.FormEngine`. |
|
|
17
|
+
| `sys_menu.DiyTableId` -> `diy_table.Id` | A module binds to a form table. |
|
|
18
|
+
| `sys_menu.DiyTableName` -> `diy_table.Name` | Runtime module table name. |
|
|
19
|
+
| `diy_field.TableChildTableId` -> `diy_table.Id` | Child table component target table. |
|
|
20
|
+
| `diy_field.TableChildSysMenuId` -> `sys_menu.Id` | Child table component target menu. |
|
|
21
|
+
| `wf_flowdesign.TableId` -> `diy_table.Id` | Workflow design binds to a form table. |
|
|
22
|
+
| `wf_flow.TableRowId` -> business row `Id` | Workflow instance points to a business record. |
|
|
23
|
+
| `sys_apiengine.ApiEngineKey` | Key for `V8.ApiEngine.Run`. |
|
|
24
|
+
| `microi_database.DbKey` | Key for `V8.Dbs.<DbKey>`. |
|
|
25
|
+
|
|
26
|
+
## V8 Storage Fields
|
|
27
|
+
|
|
28
|
+
| 表 | 字段 | 运行位置 | 用途 |
|
|
29
|
+
|---|---|---|---|
|
|
30
|
+
| `diy_table` | `InFormV8` | 前端 | 表单打开/进入时执行,初始化字段显隐、默认值、联动状态。 |
|
|
31
|
+
| `diy_table` | `SubmitFormV8` | 前端 | 表单提交前执行,做前端校验和提交前加工。 |
|
|
32
|
+
| `diy_table` | `OutFormV8` | 前端 | 表单提交后/关闭后执行,常用于刷新、跳转和提示。 |
|
|
33
|
+
| `diy_table` | `SubmitBeforeServerV8` | 后端 | 数据写入数据库前、事务内执行,失败返回 Code=0 可阻止提交。 |
|
|
34
|
+
| `diy_table` | `SubmitAfterServerV8` | 后端 | 数据写入数据库后、提交前执行,常用于同步其它表、通知、日志。 |
|
|
35
|
+
| `diy_table` | `ServerDataV8` | 后端 | 后端数据处理事件,常用于行数据加工。 |
|
|
36
|
+
| `diy_table` | `ApiReplace` | 后端 | 表单接口替换/增强入口。 |
|
|
37
|
+
| `diy_field` | `V8Code` | 前端 | 字段值变更事件。 |
|
|
38
|
+
| `diy_field` | `KeyupV8Code` | 前端 | 键盘事件。 |
|
|
39
|
+
| `diy_field` | `V8TmpEngineTable` | 前端/渲染 | 表格模板 V8,用于列表单元格渲染。 |
|
|
40
|
+
| `diy_field` | `V8TmpEngineForm` | 前端/渲染 | 表单模板 V8,用于表单展示。 |
|
|
41
|
+
| `sys_menu` | `AddCodeShowV8` | 前端 | [新增]按钮显示条件。 |
|
|
42
|
+
| `sys_menu` | `EditCodeShowV8` | 前端 | [编辑]按钮显示条件。 |
|
|
43
|
+
| `sys_menu` | `DelCodeShowV8` | 前端 | [删除]按钮显示条件。 |
|
|
44
|
+
| `sys_menu` | `DetailPageV8` | 前端 | 详情按钮行为。 |
|
|
45
|
+
| `sys_menu` | `DiyConfig` | 兼容字段 | 已废弃,只用于读取历史数据;禁止写入新配置。 |
|
|
46
|
+
| `sys_menu` | `EnableViewSchema` | 前端/模块 | 是否启用跨端统一视图协议。 |
|
|
47
|
+
| `sys_menu` | `ViewSchemaVersion` | 前端/模块 | 跨端统一视图协议版本。 |
|
|
48
|
+
| `sys_menu` | `ViewConfigVersion` | 前端/模块 | 视图配置递增版本,用于缓存失效。 |
|
|
49
|
+
| `sys_menu` | `ViewSchema` | 前端/模块 | Detail/Edit/List/Card 的版本化跨端视图 JSON。 |
|
|
50
|
+
| `sys_menu` | `SqlJoin` | 后端查询 | 列表查询 JOIN 片段。默认主表别名为 A。 |
|
|
51
|
+
| `sys_menu` | `SqlWhere` | 后端查询 | 模块级 Where 片段,可使用 CurrentUser 变量。 |
|
|
52
|
+
| `sys_menu` | `ImportV8` | 导入 | 导入处理扩展。 |
|
|
53
|
+
| `sys_menu` | `ExportV8` | 导出 | 导出处理扩展。 |
|
|
54
|
+
| `sys_apiengine` | `ApiV8Code` | 后端 | 接口引擎服务器端 JavaScript。 |
|
|
55
|
+
| `sys_datasource` | `V8DataSource` | 后端 | V8 数据源。 |
|
|
56
|
+
| `sys_datasource` | `SqlDataSource` | 后端 | SQL 数据源。 |
|
|
57
|
+
| `sys_datasource` | `JsonDataSource` | 配置 | 静态 JSON 数据源。 |
|
|
58
|
+
| `Sys_Config` | `GlobalV8Code` | 前端全局 | 前端全局 V8 初始化。 |
|
|
59
|
+
| `Sys_Config` | `GlobalServerV8Code` | 后端全局 | 每次后端 V8 执行时加载的全局函数。 |
|
|
60
|
+
| `wf_flowdesign` | `StartV8 / EndV8` | 工作流 | 流程开始/结束事件。 |
|
|
61
|
+
| `wf_node` | `StartV8 / EndV8 / StartV8Server / EndV8Server / LineValueV8` | 工作流节点 | 节点进入、结束、条件判断和服务器端节点扩展。 |
|
|
62
|
+
| `wf_line` | `V8Code` | 工作流线 | 流程连线条件代码。 |
|
|
63
|
+
|
|
64
|
+
## Table Categories
|
|
65
|
+
|
|
66
|
+
### 低代码元数据与引擎配置
|
|
67
|
+
|
|
68
|
+
| 表名 | 字段数 | 说明 |
|
|
69
|
+
|---|---:|---|
|
|
70
|
+
| `diy_table` | 43 | Diy_Table |
|
|
71
|
+
| `diy_field` | 36 | Diy_Field |
|
|
72
|
+
| `diy_component` | 11 | 表单引擎组件 |
|
|
73
|
+
| `sys_menu` | 91 | 模块引擎 |
|
|
74
|
+
| `sys_apiengine` | 26 | 接口引擎 |
|
|
75
|
+
| `sys_datasource` | 12 | 数据源引擎 |
|
|
76
|
+
| `microi_database` | 10 | 数据库管理 |
|
|
77
|
+
| `mic_page` | 6 | 界面引擎 |
|
|
78
|
+
| `mic_print` | 6 | 打印引擎 |
|
|
79
|
+
| `microi_print_template` | 3 | 导出模板 |
|
|
80
|
+
| `Rpt_Report` | 15 | 报表引擎 |
|
|
81
|
+
| `rpt_user_setting` | 6 | [系统]个人设置 |
|
|
82
|
+
| `diy_LeftJoinRightView` | 31 | 左右结构配置表 |
|
|
83
|
+
|
|
84
|
+
### 系统、租户、权限与审计
|
|
85
|
+
|
|
86
|
+
| 表名 | 字段数 | 说明 |
|
|
87
|
+
|---|---:|---|
|
|
88
|
+
| `Sys_Config` | 70 | 系统设置 |
|
|
89
|
+
| `sys_osclients` | 98 | OsClients(含六个租户上传开关/限额字段) |
|
|
90
|
+
| `sys_user` | 37 | 员工信息 |
|
|
91
|
+
| `sys_role` | 9 | Sys_Role |
|
|
92
|
+
| `sys_rolelimit` | 5 | sys_rolelimit |
|
|
93
|
+
| `sys_dept` | 9 | Sys_Dept |
|
|
94
|
+
| `diy_tenant` | 1 | 租户管理 |
|
|
95
|
+
| `sys_basedata` | 9 | sys_basedata |
|
|
96
|
+
| `sys_log` | 11 | sys_log |
|
|
97
|
+
| `microi_datalog` | 9 | 数据日志 |
|
|
98
|
+
| `diy_lang` | 12 | 多语言 |
|
|
99
|
+
| `sys_servernode` | 6 | 服务器节点管理 |
|
|
100
|
+
| `sys_microiservice` | 6 | 微服务 |
|
|
101
|
+
|
|
102
|
+
### 工作流引擎
|
|
103
|
+
|
|
104
|
+
| 表名 | 字段数 | 说明 |
|
|
105
|
+
|---|---:|---|
|
|
106
|
+
| `wf_flowdesign` | 12 | 工作流设计 |
|
|
107
|
+
| `wf_node` | 28 | 流程引擎节点属性 |
|
|
108
|
+
| `wf_line` | 6 | 工作流程条件引擎线属性 |
|
|
109
|
+
| `wf_flow` | 15 | 流程实例 |
|
|
110
|
+
| `wf_work` | 21 | 工作流工作 |
|
|
111
|
+
| `wf_history` | 23 | 流程轨迹/历史/记录 |
|
|
112
|
+
| `wf_nodelist` | 5 | 节点列表 |
|
|
113
|
+
|
|
114
|
+
### 消息、集成与自动化
|
|
115
|
+
|
|
116
|
+
| 表名 | 字段数 | 说明 |
|
|
117
|
+
|---|---:|---|
|
|
118
|
+
| `diy_queue_receive` | 11 | 消息队列管理 |
|
|
119
|
+
| `diy_queue_receive_log` | 9 | 消息队列日志 |
|
|
120
|
+
| `mci_mqtt_client` | 5 | MQTT客户端 |
|
|
121
|
+
| `mci_mqtt_log` | 4 | MQTT记录 |
|
|
122
|
+
| `diy_schedule_job` | 22 | 定时任务表 |
|
|
123
|
+
| `diy_schedule_job_log` | 2 | 定时任务日志 |
|
|
124
|
+
| `diy_feishu_app` | 4 | 应用列表 |
|
|
125
|
+
| `diy_qiwei_app` | 5 | 企业微信应用 |
|
|
126
|
+
| `wx_mp` | 7 | 微信公众号配置 |
|
|
127
|
+
| `wx_menu` | 3 | 微信公众号自定义菜单 |
|
|
128
|
+
| `wx_mini_program` | 3 | 微信小程序 |
|
|
129
|
+
| `wx_tpl_msg` | 12 | 公众号/服务号模板消息,可选跳转小程序 |
|
|
130
|
+
| `mic_email_server` | 7 | 邮件配置 |
|
|
131
|
+
| `mic_msgset` | 11 | 多通道消息通知设置 |
|
|
132
|
+
| `mic_msg_event_log` | 13 | 按事件、渠道、接收人持久化的消息通知日志 |
|
|
133
|
+
|
|
134
|
+
### 内容、运营与平台功能
|
|
135
|
+
|
|
136
|
+
| 表名 | 字段数 | 说明 |
|
|
137
|
+
|---|---:|---|
|
|
138
|
+
| `diy_document` | 7 | 低代码平台文档 |
|
|
139
|
+
| `diy_news` | 2 | 网站文章 |
|
|
140
|
+
| `diy_notice` | 4 | 公告 |
|
|
141
|
+
| `diy_tips` | 5 | 提醒 |
|
|
142
|
+
| `diy_wallpaper` | 4 | 壁纸管理 |
|
|
143
|
+
| `diy_modulehits` | 9 | 模块访问次数统计 |
|
|
144
|
+
| `diy_menufavorite` | 4 | 菜单收藏夹 |
|
|
145
|
+
| `mic_ai` | 19 | AI模型管理 |
|
|
146
|
+
| `mic_ai_record` | 5 | mic_ai_record |
|
|
147
|
+
| `mic_data_dashboard` | 5 | 数据大屏 |
|
|
148
|
+
| `mic_data_version` | 10 | 数据版本 |
|
|
149
|
+
| `mic_day_word` | 2 | 每日一言 |
|
|
150
|
+
| `microi_calendar` | 6 | 日历 |
|
|
151
|
+
| `microi_icon` | 3 | 图标管理 |
|
|
152
|
+
| `diy_searchengine_name_alias` | 2 | 搜索引擎index名称和别名对应关系表 |
|
|
153
|
+
| `diy_sso` | 6 | 单点登陆 |
|
|
154
|
+
|
|
155
|
+
### 授权、商城与示例业务
|
|
156
|
+
|
|
157
|
+
| 表名 | 字段数 | 说明 |
|
|
158
|
+
|---|---:|---|
|
|
159
|
+
| `diy_license` | 19 | 授权管理 |
|
|
160
|
+
| `diy_license_log` | 9 | 授权日志 |
|
|
161
|
+
| `sys_microistore` | 21 | 应用商城 |
|
|
162
|
+
| `sys_microistoreversion` | 1 | 应用商城应用版本 |
|
|
163
|
+
| `sys_appinstalled` | 6 | 已安装应用 |
|
|
164
|
+
| `sys_microiuptlog` | 7 | 框架更新日志 |
|
|
165
|
+
| `b2c_product` | 19 | b2c_product |
|
|
166
|
+
| `diy_course` | 3 | 课程表 |
|
|
167
|
+
| `eban` | 5 | EBAN |
|
|
168
|
+
| `mic_memo` | 3 | 备忘录 |
|
|
169
|
+
| `mic_3d_engine` | 0 | 3D引擎 |
|
|
170
|
+
|
|
171
|
+
## Component Counts
|
|
172
|
+
|
|
173
|
+
| Component | Count |
|
|
174
|
+
|---|---:|
|
|
175
|
+
| `Text` | 403 |
|
|
176
|
+
| `Switch` | 108 |
|
|
177
|
+
| `Textarea` | 94 |
|
|
178
|
+
| `NumberText` | 55 |
|
|
179
|
+
| `Guid` | 53 |
|
|
180
|
+
| `Radio` | 47 |
|
|
181
|
+
| `CodeEditor` | 47 |
|
|
182
|
+
| `Select` | 35 |
|
|
183
|
+
| `MultipleSelect` | 22 |
|
|
184
|
+
| `ImgUpload` | 17 |
|
|
185
|
+
| `JsonTable` | 16 |
|
|
186
|
+
| `DateTime` | 12 |
|
|
187
|
+
| `Button` | 10 |
|
|
188
|
+
| `RichText` | 7 |
|
|
189
|
+
| `TableChild` | 7 |
|
|
190
|
+
| `ColorPicker` | 6 |
|
|
191
|
+
| `SelectTree` | 5 |
|
|
192
|
+
| `Cascader` | 5 |
|
|
193
|
+
| `FileUpload` | 4 |
|
|
194
|
+
| `AutoNumber` | 4 |
|
|
195
|
+
| `(空)` | 4 |
|
|
196
|
+
| `FontAwesome` | 3 |
|
|
197
|
+
| `Department` | 3 |
|
|
198
|
+
| `Checkbox` | 2 |
|
|
199
|
+
| `Divider` | 2 |
|
|
200
|
+
| `Autocomplete` | 1 |
|
|
201
|
+
| `JoinForm` | 1 |
|
|
202
|
+
| `Rate` | 1 |
|
|
203
|
+
| `DevComponent` | 1 |
|