worsoft-frontend-codegen-local-mcp 0.1.3 → 0.1.5

package/README.md

@@ -24,6 +24,7 @@ This MCP generates Worsoft frontend files from a local Markdown design document.
 - `mainField` when `style=master_child_jump`: required
 - `childField` when `style=master_child_jump`: required
 - `relationType` when `style=master_child_jump`: optional
+- `children` when `style=master_child_jump`: optional array of direct child relations; when provided it overrides the legacy single-child fields
 
 ## Recommended MCP Arguments
 
@@ -57,6 +58,33 @@ Master-child:
 }
 ```
 
+Multi direct children on one main form:
+
+```json
+{
+  "tableName": "iwm_sys_trade_level",
+  "style": "master_child_jump",
+  "children": [
+    {
+      "childTableName": "iwm_sys_trade_level_standard",
+      "mainField": "id",
+      "childField": "trade_level_id",
+      "relationType": "1:N"
+    },
+    {
+      "childTableName": "iwm_sys_trade_level_competency",
+      "mainField": "id",
+      "childField": "trade_level_id",
+      "relationType": "1:N"
+    }
+  ],
+  "designFile": "plugins/sql/SQL 璁捐璇存槑.md",
+  "frontendPath": "E:/own-worker-platform/trunk/worsoft-ui",
+  "moduleName": "admin/test",
+  "writeToDisk": false
+}
+```
+
 ## Smoke Test
 
 PowerShell:
@@ -65,6 +93,7 @@ PowerShell:
 powershell -ExecutionPolicy Bypass -File plugins/worsoft-codegen-local/smoke_test_mcp.ps1 -Scenario single
 powershell -ExecutionPolicy Bypass -File plugins/worsoft-codegen-local/smoke_test_mcp.ps1 -Scenario master
 powershell -ExecutionPolicy Bypass -File plugins/worsoft-codegen-local/smoke_test_mcp.ps1 -Scenario child
+powershell -ExecutionPolicy Bypass -File plugins/worsoft-codegen-local/smoke_test_mcp.ps1 -Scenario multi
 powershell -ExecutionPolicy Bypass -File plugins/worsoft-codegen-local/smoke_test_mcp.ps1 -Scenario missing_relation
 ```
 
@@ -74,6 +103,7 @@ Node:
 node plugins/worsoft-codegen-local/smoke_test_mcp.js --scenario single
 node plugins/worsoft-codegen-local/smoke_test_mcp.js --scenario master
 node plugins/worsoft-codegen-local/smoke_test_mcp.js --scenario child
+node plugins/worsoft-codegen-local/smoke_test_mcp.js --scenario multi
 node plugins/worsoft-codegen-local/smoke_test_mcp.js --scenario missing_relation
 ```
 
@@ -95,9 +125,8 @@ For `master_child_jump`, MCP does not infer relations from the design file anymo
 
 The caller must provide:
 
-- `childTableName`
-- `mainField`
-- `childField`
+- either `children[]`
+- or the legacy single-child fields: `childTableName`, `mainField`, `childField`
 
 If these fields are missing, MCP returns `relation_input_required`.
 

package/assets/templates/master_child_jump/api.tpl

@@ -40,10 +40,10 @@ export function putObj(obj?: object) {
   });
 }
 
-export function delChildObj(ids?: object) {
+export function delChildObj(ids?: object, childTableName?: string) {
   return request({
     url: '/{{API_PATH}}/child',
     method: 'delete',
-    data: ids,
+    data: childTableName ? { ids, childTableName } : ids,
   });
 }

package/assets/templates/master_child_jump/form.tpl

@@ -9,9 +9,7 @@
 {{FORM_FIELDS}}
         </el-row>
         <el-row :gutter="24">
-          <sc-form-table v-model="form.{{CHILD_LIST_NAME}}" :addTemplate="childTemp" @delete="deleteChild" placeholder="暂无数据">
-{{CHILD_TABLE_COLUMNS}}
-          </sc-form-table>
+{{CHILD_SECTIONS}}
         </el-row>
       </el-form>
       <div class="dialog-footer" style="text-align: right; margin-top: 18px;">
@@ -26,7 +24,10 @@
 import mittBus from '/@/utils/mitt';
 import { useMessage } from '/@/hooks/message';
 import { getObj, addObj, putObj, delChildObj } from '/@/api/{{API_MODULE_PATH}}';
-{{DICT_IMPORT_BLOCK}}
+import { useDict } from '/@/hooks/dict';
+import { allDictTypes, childFieldGroups, dataMasterEntity } from './options';
+
+const dictRefs = useDict(...allDictTypes);
 
 const scFormTable = defineAsyncComponent(() => import('/@/components/FormTable/index.vue'));
 const route = useRoute();
@@ -36,14 +37,24 @@ const dataFormRef = ref();
 const loading = ref(false);
 const detail = ref(false);
 
+const masterFields = dataMasterEntity;
+
+const getMasterFieldMeta = (prop: string) => masterFields[prop];
+const isMasterFieldVisible = (prop: string) => {
+  const config = getMasterFieldMeta(prop);
+  return Boolean(config) && !config.alwaysHide && config.show !== false;
+};
+const getChildFieldMeta = (groupName: string, prop: string) => childFieldGroups[groupName]?.[prop];
+const getDictOptions = (dictType?: string) => (dictType ? dictRefs[dictType]?.value || [] : []);
+const inputPlaceholder = (label: string) => `请输入${label}`;
+const selectPlaceholder = (label: string) => `请选择${label}`;
+
 const form = reactive({
 {{FORM_DEFAULTS}}
-  {{CHILD_LIST_NAME}}: [],
+{{CHILD_FORM_LIST_DEFAULTS}}
 });
 
-const childTemp = reactive({
-{{CHILD_TEMP_DEFAULTS}}
-});
+{{CHILD_TEMP_DECLARATIONS}}
 
 const dataRules = ref({
 {{FORM_RULES}}
@@ -64,11 +75,11 @@ const get{{CLASS_NAME}}Data = async (id: string) => {
 const resetFormState = () => {
   Object.assign(form, {
 {{FORM_DEFAULTS}}
-    {{CHILD_LIST_NAME}}: [],
+{{CHILD_FORM_LIST_DEFAULTS}}
   });
   nextTick(() => {
     dataFormRef.value?.resetFields();
-    form.{{CHILD_LIST_NAME}} = [];
+{{CHILD_RESET_LISTS}}
   });
 };
 
@@ -113,10 +124,10 @@ const onSubmit = async () => {
   }
 };
 
-const deleteChild = async (obj: { {{CHILD_PK_ATTR}}: string }) => {
-  if (obj.{{CHILD_PK_ATTR}}) {
+const deleteChild = async (obj: Record<string, any>, childPkAttr: string, childTableName?: string) => {
+  if (obj[childPkAttr]) {
     try {
-      await delChildObj([obj.{{CHILD_PK_ATTR}}]);
+      await delChildObj([obj[childPkAttr]], childTableName);
       useMessage().success('删除成功');
     } catch (err: any) {
       useMessage().error(err.msg || '删除失败');

package/assets/templates/master_child_jump/index.tpl

@@ -21,7 +21,19 @@
       >
         <el-table-column type="selection" width="40" align="center" />
         <el-table-column type="index" label="#" width="40" />
-{{TABLE_COLUMNS}}
+        <el-table-column
+          v-for="column in visibleTableColumns"
+          :key="column.prop"
+          :prop="column.prop"
+          :label="column.label"
+          :width="column.width"
+          show-overflow-tooltip
+        >
+          <template #default="scope">
+            <dict-tag v-if="column.dictType" :options="getDictOptions(column.dictType)" :value="scope.row[column.prop]" />
+            <span v-else>{{ scope.row[column.prop] }}</span>
+          </template>
+        </el-table-column>
         <el-table-column label="操作" width="220">
           <template #default="scope">
             <el-button text type="primary" icon="view" v-auth="'{{PERMISSION_PREFIX}}_view'" @click="handleDetail(scope.row.{{PK_ATTR}})">查看</el-button>
@@ -42,11 +54,13 @@
 import { BasicTableProps, useTable } from '/@/hooks/table';
 import { fetchList, delObjs } from '/@/api/{{API_MODULE_PATH}}';
 import { useMessage, useMessageBox } from '/@/hooks/message';
-{{DICT_IMPORT_BLOCK}}
+import { useDict } from '/@/hooks/dict';
+import { allDictTypes, dataMasterEntity } from './options';
+
+const dictRefs = useDict(...allDictTypes);
 const router = useRouter();
 
 const excelUploadRef = ref();
-const queryRef = ref();
 const showSearch = ref(true);
 const selectObjs = ref([]) as any;
 const multiple = ref(true);
@@ -56,6 +70,19 @@ const state: BasicTableProps = reactive<BasicTableProps>({
   pageList: fetchList,
 });
 
+const visibleTableColumns = computed(() =>
+  Object.entries(dataMasterEntity)
+    .filter(([, config]) => !config.alwaysHide && config.show !== false)
+    .map(([prop, config]) => ({
+      prop,
+      label: config.label,
+      width: config.width,
+      dictType: config.dictType || '',
+    }))
+);
+
+const getDictOptions = (dictType?: string) => (dictType ? dictRefs[dictType]?.value || [] : []);
+
 const { getDataList, currentChangeHandle, sizeChangeHandle, sortChangeHandle, downBlobFile, tableStyle } = useTable(state);
 
 const getFormPath = () => '/{{VIEW_MODULE_PATH}}/form';

package/assets/templates/master_child_jump/options.tpl

@@ -1,10 +1,32 @@
+{{DICT_REGISTRY_IMPORT_BLOCK}}
+import { createCrudSchema } from '/@/utils/crudSchema';
+import type { CrudSchemaDefinition } from '/@/utils/crudSchema';
+
 /**
- * Local codegen metadata for {{TABLE_NAME}}
+ * {{TABLE_NAME}} 页面字段声明。
+ * 这里只维护字段清单，不手写派生配置。
  */
-export const dataMasterEntity = {
-{{OPTIONS_FIELDS}}
+const definition: CrudSchemaDefinition = {
+  // 主表字段
+  master: [
+{{MASTER_OPTION_FIELDS}}
+  ],
+  // 子表字段，key 对应 form.vue 中的列表字段名
+  children: {
+{{CHILD_OPTION_GROUPS}}
+  },
 };
 
-export const filterTypes = {
-{{FILTER_TYPES}}
-};
+// 统一派生页面所需配置，避免在 options 文件里重复手写
+const schema = createCrudSchema(definition);
+
+// 主表字段配置：列表页、主表表单共用
+export const dataMasterEntity = schema.master;
+// 子表字段配置：主子表 form 页使用
+export const childFieldGroups = schema.children;
+// 主表字典筛选配置
+export const filterTypes = schema.filterTypes;
+// 子表字典筛选配置
+export const childFilterTypes = schema.childFilterTypes;
+// 当前功能涉及的全部字典编码
+export const allDictTypes = schema.allDictTypes;

package/assets/templates/single_table_dialog/form.tpl

@@ -17,14 +17,27 @@
 <script setup lang="ts" name="{{CLASS_NAME}}Dialog">
 import { useMessage } from '/@/hooks/message';
 import { getObj, addObj, putObj } from '/@/api/{{API_MODULE_PATH}}';
-{{FORM_DICT_IMPORT_BLOCK}}
+import { useDict } from '/@/hooks/dict';
+import { allDictTypes, dataMasterEntity } from './options';
 
+const dictRefs = useDict(...allDictTypes);
 const emit = defineEmits(['refresh']);
 
 const dataFormRef = ref();
 const visible = ref(false);
 const loading = ref(false);
 
+const masterFields = dataMasterEntity;
+
+const getMasterFieldMeta = (prop: string) => masterFields[prop];
+const isMasterFieldVisible = (prop: string) => {
+  const config = getMasterFieldMeta(prop);
+  return Boolean(config) && !config.alwaysHide && config.show !== false;
+};
+const getDictOptions = (dictType?: string) => (dictType ? dictRefs[dictType]?.value || [] : []);
+const inputPlaceholder = (label: string) => `请输入${label}`;
+const selectPlaceholder = (label: string) => `请选择${label}`;
+
 const form = reactive({
 {{FORM_DEFAULTS}}
 });
@@ -88,4 +101,4 @@ const onSubmit = async () => {
 defineExpose({
   openDialog,
 });
-</script>
+</script>

package/assets/templates/single_table_dialog/index.tpl

@@ -21,7 +21,19 @@
       >
         <el-table-column type="selection" width="40" align="center" />
         <el-table-column type="index" label="#" width="40" />
-{{TABLE_COLUMNS}}
+        <el-table-column
+          v-for="column in visibleTableColumns"
+          :key="column.prop"
+          :prop="column.prop"
+          :label="column.label"
+          :width="column.width"
+          show-overflow-tooltip
+        >
+          <template #default="scope">
+            <dict-tag v-if="column.dictType" :options="getDictOptions(column.dictType)" :value="scope.row[column.prop]" />
+            <span v-else>{{ scope.row[column.prop] }}</span>
+          </template>
+        </el-table-column>
         <el-table-column label="操作" width="180">
           <template #default="scope">
             <el-button icon="edit-pen" text type="primary" v-auth="'{{PERMISSION_PREFIX}}_edit'" @click="formDialogRef.openDialog(scope.row.{{PK_ATTR}})">编辑</el-button>
@@ -42,7 +54,10 @@
 import { BasicTableProps, useTable } from '/@/hooks/table';
 import { fetchList, delObjs } from '/@/api/{{API_MODULE_PATH}}';
 import { useMessage, useMessageBox } from '/@/hooks/message';
-{{TABLE_DICT_IMPORT_BLOCK}}
+import { useDict } from '/@/hooks/dict';
+import { allDictTypes, dataMasterEntity } from './options';
+
+const dictRefs = useDict(...allDictTypes);
 
 const FormDialog = defineAsyncComponent(() => import('./form.vue'));
 
@@ -57,6 +72,19 @@ const state: BasicTableProps = reactive<BasicTableProps>({
   pageList: fetchList,
 });
 
+const visibleTableColumns = computed(() =>
+  Object.entries(dataMasterEntity)
+    .filter(([, config]) => !config.alwaysHide && config.show !== false)
+    .map(([prop, config]) => ({
+      prop,
+      label: config.label,
+      width: config.width,
+      dictType: config.dictType || '',
+    }))
+);
+
+const getDictOptions = (dictType?: string) => (dictType ? dictRefs[dictType]?.value || [] : []);
+
 const { getDataList, currentChangeHandle, sizeChangeHandle, sortChangeHandle, downBlobFile, tableStyle } = useTable(state);
 
 const exportExcel = () => {
@@ -83,4 +111,4 @@ const handleDelete = async (ids: string[]) => {
     useMessage().error(err.msg || '删除失败');
   }
 };
-</script>
+</script>

package/assets/templates/single_table_dialog/options.tpl

@@ -1,10 +1,32 @@
+{{DICT_REGISTRY_IMPORT_BLOCK}}
+import { createCrudSchema } from '/@/utils/crudSchema';
+import type { CrudSchemaDefinition } from '/@/utils/crudSchema';
+
 /**
- * Local codegen metadata for {{TABLE_NAME}}
+ * {{TABLE_NAME}} 页面字段声明。
+ * 这里只维护字段清单，不手写派生配置。
  */
-export const dataMasterEntity = {
-{{OPTIONS_FIELDS}}
+const definition: CrudSchemaDefinition = {
+  // 主表字段
+  master: [
+{{MASTER_OPTION_FIELDS}}
+  ],
+  // 子表字段，key 对应 form.vue 中的列表字段名
+  children: {
+{{CHILD_OPTION_GROUPS}}
+  },
 };
 
-export const filterTypes = {
-{{FILTER_TYPES}}
-};
+// 统一派生页面所需配置，避免在 options 文件里重复手写
+const schema = createCrudSchema(definition);
+
+// 主表字段配置：列表页、主表表单共用
+export const dataMasterEntity = schema.master;
+// 子表字段配置：主子表 form 页使用
+export const childFieldGroups = schema.children;
+// 主表字典筛选配置
+export const filterTypes = schema.filterTypes;
+// 子表字典筛选配置
+export const childFilterTypes = schema.childFilterTypes;
+// 当前功能涉及的全部字典编码
+export const allDictTypes = schema.allDictTypes;

package/assets/templates/single_table_jump/form.tpl

@@ -21,7 +21,10 @@
 import mittBus from '/@/utils/mitt';
 import { useMessage } from '/@/hooks/message';
 import { getObj, addObj, putObj } from '/@/api/{{API_MODULE_PATH}}';
-{{DICT_IMPORT_BLOCK}}
+import { useDict } from '/@/hooks/dict';
+import { allDictTypes, dataMasterEntity } from './options';
+
+const dictRefs = useDict(...allDictTypes);
 const route = useRoute();
 const router = useRouter();
 
@@ -29,6 +32,17 @@ const dataFormRef = ref();
 const loading = ref(false);
 const detail = ref(false);
 
+const masterFields = dataMasterEntity;
+
+const getMasterFieldMeta = (prop: string) => masterFields[prop];
+const isMasterFieldVisible = (prop: string) => {
+  const config = getMasterFieldMeta(prop);
+  return Boolean(config) && !config.alwaysHide && config.show !== false;
+};
+const getDictOptions = (dictType?: string) => (dictType ? dictRefs[dictType]?.value || [] : []);
+const inputPlaceholder = (label: string) => `请输入${label}`;
+const selectPlaceholder = (label: string) => `请选择${label}`;
+
 const form = reactive({
 {{FORM_DEFAULTS}}
 });

package/assets/templates/single_table_jump/index.tpl

@@ -21,7 +21,19 @@
       >
         <el-table-column type="selection" width="40" align="center" />
         <el-table-column type="index" label="#" width="40" />
-{{TABLE_COLUMNS}}
+        <el-table-column
+          v-for="column in visibleTableColumns"
+          :key="column.prop"
+          :prop="column.prop"
+          :label="column.label"
+          :width="column.width"
+          show-overflow-tooltip
+        >
+          <template #default="scope">
+            <dict-tag v-if="column.dictType" :options="getDictOptions(column.dictType)" :value="scope.row[column.prop]" />
+            <span v-else>{{ scope.row[column.prop] }}</span>
+          </template>
+        </el-table-column>
         <el-table-column label="操作" width="220">
           <template #default="scope">
             <el-button text type="primary" icon="view" v-auth="'{{PERMISSION_PREFIX}}_view'" @click="handleDetail(scope.row.{{PK_ATTR}})">查看</el-button>
@@ -42,11 +54,13 @@
 import { BasicTableProps, useTable } from '/@/hooks/table';
 import { fetchList, delObjs } from '/@/api/{{API_MODULE_PATH}}';
 import { useMessage, useMessageBox } from '/@/hooks/message';
-{{DICT_IMPORT_BLOCK}}
+import { useDict } from '/@/hooks/dict';
+import { allDictTypes, dataMasterEntity } from './options';
+
+const dictRefs = useDict(...allDictTypes);
 const router = useRouter();
 
 const excelUploadRef = ref();
-const queryRef = ref();
 const showSearch = ref(true);
 const selectObjs = ref([]) as any;
 const multiple = ref(true);
@@ -56,6 +70,19 @@ const state: BasicTableProps = reactive<BasicTableProps>({
   pageList: fetchList,
 });
 
+const visibleTableColumns = computed(() =>
+  Object.entries(dataMasterEntity)
+    .filter(([, config]) => !config.alwaysHide && config.show !== false)
+    .map(([prop, config]) => ({
+      prop,
+      label: config.label,
+      width: config.width,
+      dictType: config.dictType || '',
+    }))
+);
+
+const getDictOptions = (dictType?: string) => (dictType ? dictRefs[dictType]?.value || [] : []);
+
 const { getDataList, currentChangeHandle, sizeChangeHandle, sortChangeHandle, downBlobFile, tableStyle } = useTable(state);
 
 const getFormPath = () => '/{{VIEW_MODULE_PATH}}/form';

package/assets/templates/single_table_jump/options.tpl

@@ -1,10 +1,32 @@
+{{DICT_REGISTRY_IMPORT_BLOCK}}
+import { createCrudSchema } from '/@/utils/crudSchema';
+import type { CrudSchemaDefinition } from '/@/utils/crudSchema';
+
 /**
- * Local codegen metadata for {{TABLE_NAME}}
+ * {{TABLE_NAME}} 页面字段声明。
+ * 这里只维护字段清单，不手写派生配置。
  */
-export const dataMasterEntity = {
-{{OPTIONS_FIELDS}}
+const definition: CrudSchemaDefinition = {
+  // 主表字段
+  master: [
+{{MASTER_OPTION_FIELDS}}
+  ],
+  // 子表字段，key 对应 form.vue 中的列表字段名
+  children: {
+{{CHILD_OPTION_GROUPS}}
+  },
 };
 
-export const filterTypes = {
-{{FILTER_TYPES}}
-};
+// 统一派生页面所需配置，避免在 options 文件里重复手写
+const schema = createCrudSchema(definition);
+
+// 主表字段配置：列表页、主表表单共用
+export const dataMasterEntity = schema.master;
+// 子表字段配置：主子表 form 页使用
+export const childFieldGroups = schema.children;
+// 主表字典筛选配置
+export const filterTypes = schema.filterTypes;
+// 子表字典筛选配置
+export const childFilterTypes = schema.childFilterTypes;
+// 当前功能涉及的全部字典编码
+export const allDictTypes = schema.allDictTypes;