worsoft-frontend-codegen-local-mcp 0.1.51 → 0.1.52

package/assets/templates/master_child_jump/api.tpl

@@ -1,5 +1,7 @@
+// 请求工具
 import request from '/@/utils/request';
 
+// 查询分页列表
 export function fetchList(query?: object) {
   return request({
     url: '/{{API_PATH}}/page',
@@ -8,6 +10,7 @@ export function fetchList(query?: object) {
   });
 }
 
+// 新增数据
 export function addObj(obj?: object) {
   return request({
     url: '/{{API_PATH}}/save',
@@ -16,6 +19,7 @@ export function addObj(obj?: object) {
   });
 }
 
+// 查询详情数据
 export function getObj(obj?: object) {
   return request({
     url: '/{{API_PATH}}/getById',
@@ -24,6 +28,7 @@ export function getObj(obj?: object) {
   });
 }
 
+// 删除数据
 export function delObjs(ids?: object) {
   return request({
     url: '/{{API_PATH}}/removeByIds',
@@ -32,6 +37,7 @@ export function delObjs(ids?: object) {
   });
 }
 
+// 更新数据
 export function putObj(obj?: object) {
   return request({
     url: '/{{API_PATH}}/updateById',

package/assets/templates/master_child_jump/form.tpl

@@ -1,4 +1,4 @@
-<template>
+<template>
   <div class="layout-padding-auto layout-padding-view">
     <el-card shadow="never" class="w100">
       <template #header>
@@ -29,25 +29,42 @@
 </template>
 
 <script setup lang="ts" name="{{CLASS_NAME}}Form">
+// 标签页关闭总线
 import mittBus from '/@/utils/mitt';
+// 本地会话存储
 import { Session } from '/@/utils/storage';
+// 通用消息提示
 import { useMessage } from '/@/hooks/message';
+// 表单数据接口
 import { getObj, addObj, putObj } from '/@/api/{{API_MODULE_PATH}}';
+// 字典数据加载
 import { useDict } from '/@/hooks/dict';
+// 表单字段元数据能力
 import { useCrudPageMeta } from '/@/hooks/useCrudPageMeta';
+// 国际化能力
 import { useI18n } from 'vue-i18n';
+// 当前页面的字段配置
 import { allDictTypes, childFieldGroups, dataMasterEntity } from './options';
 
+// 页面所需的字典引用
 const dictRefs = useDict(...allDictTypes);
+// 国际化方法
 const { t } = useI18n();
 
+// 子表表格组件
 const scFormTable = defineAsyncComponent(() => import('/@/components/FormTable/index.vue'));
+// 当前路由信息
 const route = useRoute();
+// 路由跳转能力
 const router = useRouter();
+// 当前页面的国际化命名空间
 const pageI18nKey = '{{I18N_NAMESPACE}}';
 
+// 表单引用
 const dataFormRef = ref();
+// 页面加载状态
 const loading = ref(false);
+// 是否详情模式
 const detail = ref(false);
 
 // 主表和子表字段的双语、字典和校验提示统一由公共 hook 提供
@@ -65,13 +82,13 @@ const {
 // 子表分组标题从功能级词条中读取
 const childSectionTitle = (groupName: string) => t(`${pageI18nKey}.children.${groupName}.title`);
 
-// 统一维护表单默认值，初始化和重置都复用这一份
+// 统一维护表单默认值
 const createDefaultFormState = () => ({
 {{FORM_DEFAULTS}}
 {{CHILD_FORM_LIST_DEFAULTS}}
 });
 
-// 表单数据模型，包含主表字段和多个子表列表
+// 表单响应式数据
 const form = reactive(createDefaultFormState());
 
 // 各子表新增行时使用的临时对象
@@ -128,14 +145,16 @@ const handleBack = () => {
   router.back();
 };
 
-// 保存、提交、流转共用同一套提交逻辑，仅成功提示不同
+// 保存、提交和流转共用同一套提交逻辑
 const onSubmit = async (actionType?: string) => {
   loading.value = true;
 
-  const valid = await dataFormRef.value.validate().catch(() => {});
-  if (!valid) {
-    loading.value = false;
-    return false;
+  if (actionType !== 'save') {
+    const valid = await dataFormRef.value.validate().catch(() => {});
+    if (!valid) {
+      loading.value = false;
+      return false;
+    }
   }
 
   try {
@@ -154,11 +173,12 @@ const onSubmit = async (actionType?: string) => {
   }
 };
 
-// 子表删除只处理前端行状态，统一随主表保存时提交
+// 子表删除仅处理前端行状态
 const deleteChild = (_obj: Record<string, any>, _childPkAttr: string) => {
   return true;
 };
 
+// 页面挂载后初始化数据
 onMounted(() => {
   initPage();
 });

package/assets/templates/master_child_jump/index.tpl

@@ -24,7 +24,7 @@
       >
         <template #actions="{ row }">
           <el-button text type="primary" icon="view" v-auth="'{{PERMISSION_PREFIX}}_view'" @click="handleDetail(row.{{PK_ATTR}})">{{ t('common.viewBtn') }}</el-button>
-          <el-button icon="edit-pen" text type="primary" v-auth="'{{PERMISSION_PREFIX}}_edit'" @click="handleEdit(row.{{PK_ATTR}})">{{ t('common.editBtn') }}</el-button>
+          <el-button{{BUSINESS_EDIT_IF}} icon="edit-pen" text type="primary" v-auth="'{{PERMISSION_PREFIX}}_edit'" @click="handleEdit(row.{{PK_ATTR}})">{{ t('common.editBtn') }}</el-button>
           <el-button text type="primary" icon="check" @click="handleQuickAction(row, 'submit')">{{ commonActionLabel('submit') }}</el-button>
           <el-button text type="success" icon="position" @click="handleQuickAction(row, 'flow')">{{ commonActionLabel('flow') }}</el-button>
           <el-button icon="delete" text type="primary" v-auth="'{{PERMISSION_PREFIX}}_del'" @click="handleDelete([row.{{PK_ATTR}}])">{{ t('common.delBtn') }}</el-button>
@@ -37,24 +37,42 @@
 </template>
 
 <script setup lang="ts" name="system{{CLASS_NAME}}">
+// 列表接口
 import { fetchList, delObjs } from '/@/api/{{API_MODULE_PATH}}';
+// 通用消息与确认弹窗
 import { useMessage, useMessageBox } from '/@/hooks/message';
+// 字典数据加载
 import { useDict } from '/@/hooks/dict';
+// 列表页字段元数据能力
 import { useCrudPageMeta } from '/@/hooks/useCrudPageMeta';
+// 列表页查询与分页状态
 import { useSchemaListQuery } from '/@/hooks/useSchemaListQuery';
+// 统一列表工具栏组件
 import SchemaListToolbar from '/@/components/schema-list/SchemaListToolbar.vue';
+// 统一列表表格组件
 import SchemaListTable from '/@/components/schema-list/SchemaListTable.vue';
+// 国际化能力
 import { useI18n } from 'vue-i18n';
+// 当前页面的 schema 与字段配置
 import { allDictTypes, crudSchema, dataMasterEntity } from './options';
+// 业务状态编辑控制（按需生成）
+{{BUSINESS_STATUS_IMPORTS}}
 
+// 页面所需的字典引用
 const dictRefs = useDict(...allDictTypes);
+// 国际化方法
 const { t } = useI18n();
+// 路由跳转能力
 const router = useRouter();
 
+// 导入组件引用
 const excelUploadRef = ref();
+// 列表勾选主键集合
 const selectObjs = ref<string[]>([]);
+// 批量删除按钮状态
 const multiple = ref(true);
 
+// 统一管理列表查询、分页、排序和导出
 const { state, getDataList, currentChangeHandle, sizeChangeHandle, sortChangeHandle, tableStyle, exportExcel: runExportExcel, resetQueryForm } = useSchemaListQuery({
   schema: crudSchema,
   pageList: fetchList,
@@ -62,8 +80,10 @@ const { state, getDataList, currentChangeHandle, sizeChangeHandle, sortChangeHan
   exportFileName: '{{FUNCTION_NAME}}.xlsx',
 });
 
+// 提供字段标签、字典选项和查询区描述
 const { resolveLabel, getDictOptions, commonActionLabel, visibleTableColumns, searchKeywordTooltip, queryableDictFields } = useCrudPageMeta(dataMasterEntity, dictRefs);
 
+// 自定义查询区的字典字段配置
 const queryableDictOptions = computed(() =>
   queryableDictFields.value.map((field) => ({
     ...field,
@@ -71,6 +91,7 @@ const queryableDictOptions = computed(() =>
   }))
 );
 
+// 列表表格列配置
 const tableColumns = computed(() =>
   visibleTableColumns.value.map((column) => ({
     prop: column.prop,
@@ -81,6 +102,7 @@ const tableColumns = computed(() =>
   }))
 );
 
+// 工具栏透传属性
 const toolbarProps = computed(() => ({
   keyword: state.queryForm.smartVal,
   searchPlaceholder: searchKeywordTooltip.value,
@@ -91,6 +113,7 @@ const toolbarProps = computed(() => ({
   exportPermission: '{{PERMISSION_PREFIX}}_export',
 }));
 
+// 表格透传属性
 const tableProps = computed(() => ({
   data: state.dataList,
   loading: !!state.loading,
@@ -99,20 +122,28 @@ const tableProps = computed(() => ({
   tableStyle,
 }));
 
+// 表单页路由路径
 const getFormPath = () => '/{{VIEW_MODULE_PATH}}/form';
 
+// 跳转新增页
 const handleCreate = () => {
   router.push({ path: getFormPath(), query: { tagsViewName: t('common.addBtn') } });
 };
 
+// 跳转详情页
 const handleDetail = (id: string) => {
   router.push({ path: getFormPath(), query: { id, detail: '1', tagsViewName: t('common.viewBtn') } });
 };
 
+// 跳转编辑页
 const handleEdit = (id: string) => {
   router.push({ path: getFormPath(), query: { id, tagsViewName: t('common.editBtn') } });
 };
 
+// 业务状态按钮控制（按需生成）
+{{BUSINESS_STATUS_HELPERS}}
+
+// 列表页快捷提交流转
 const handleQuickAction = async (_row: any, actionType: string) => {
   const actionName = commonActionLabel(actionType);
   try {
@@ -128,10 +159,12 @@ const handleQuickAction = async (_row: any, actionType: string) => {
   }
 };
 
+// 导出当前勾选数据
 const exportExcel = () => {
   runExportExcel(selectObjs.value);
 };
 
+// 应用自定义查询条件
 const handleQueryFilterConfirm = (values: Record<string, any>) => {
   queryableDictFields.value.forEach((field) => {
     const nextValue = values[field.prop];
@@ -144,11 +177,13 @@ const handleQueryFilterConfirm = (values: Record<string, any>) => {
   getDataList();
 };
 
+// 重置查询条件
 const resetQuery = () => {
   resetQueryForm();
   getDataList();
 };
 
+// 删除列表数据
 const handleDelete = async (ids: string[]) => {
   try {
     await useMessageBox().confirm(t('common.delConfirmText'));
@@ -165,51 +200,63 @@ const handleDelete = async (ids: string[]) => {
   }
 };
 
+// 工具栏新增事件
 const handleToolbarAdd = () => {
   handleCreate();
 };
 
+// 工具栏导入事件
 const handleToolbarImport = () => {
   excelUploadRef.value?.show();
 };
 
+// 工具栏批量删除事件
 const handleToolbarDelete = () => {
   handleDelete(selectObjs.value);
 };
 
+// 工具栏查询事件
 const handleToolbarQuery = () => {
   getDataList();
 };
 
+// 工具栏重置事件
 const handleToolbarReset = () => {
   resetQuery();
 };
 
+// 工具栏高级查询确认事件
 const handleToolbarCustomQueryConfirm = (payload: { values: Record<string, any> }) => {
   handleQueryFilterConfirm(payload.values);
 };
 
+// 工具栏导出事件
 const handleToolbarExport = () => {
   exportExcel();
 };
 
+// 工具栏刷新事件
 const handleToolbarRefresh = () => {
   getDataList();
 };
 
+// 表格勾选变化事件
 const handleTableSelectionChange = (payload: { ids: Array<string | number> }) => {
   selectObjs.value = payload.ids.map((id) => String(id));
   multiple.value = !payload.ids.length;
 };
 
+// 表格排序事件
 const handleTableSortChange = (payload: { raw: any }) => {
   sortChangeHandle(payload.raw);
 };
 
+// 分页大小变化事件
 const handleTableSizeChange = (payload: { size: number }) => {
   sizeChangeHandle(payload.size);
 };
 
+// 当前页变化事件
 const handleTableCurrentChange = (payload: { current: number }) => {
   currentChangeHandle(payload.current);
 };

package/assets/templates/master_child_jump/options.tpl

@@ -1,10 +1,13 @@
+// 字典注册表
 {{DICT_REGISTRY_IMPORT_BLOCK}}
+// schema 构建工具
 import { createCrudSchema } from '/@/utils/crudSchema';
+// schema 类型定义
 import type { CrudSchemaDefinition } from '/@/utils/crudSchema';
 
 /**
  * {{TABLE_NAME}} 页面字段声明
- * 这里只维护字段 key、双语 key、字典类型和显示元数据
+ * 这里维护字段 key、双语 key、字典类型和显示元数据
  */
 const definition: CrudSchemaDefinition = {
   master: [
@@ -15,17 +18,18 @@ const definition: CrudSchemaDefinition = {
   },
 };
 
-// 将页面声明转换成 index/form 统一消费的 schema 结果
+// 将页面字段声明转换为 index/form 共用的 schema 结果
 const schema = createCrudSchema(definition);
 
+// 完整 CRUD schema
 export const crudSchema = schema;
 // 主表字段配置，供列表页和表单页使用
 export const dataMasterEntity = schema.master;
-// 子表字段配置，供主子表区块读取
+// 子表字段配置，供主子表区域读取
 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/api.tpl

@@ -1,5 +1,7 @@
+// 请求工具
 import request from '/@/utils/request';
 
+// 查询分页列表
 export function fetchList(query?: object) {
   return request({
     url: '/{{API_PATH}}/page',
@@ -8,6 +10,7 @@ export function fetchList(query?: object) {
   });
 }
 
+// 新增数据
 export function addObj(obj?: object) {
   return request({
     url: '/{{API_PATH}}',
@@ -16,6 +19,7 @@ export function addObj(obj?: object) {
   });
 }
 
+// 查询详情数据
 export function getObj(obj?: object) {
   return request({
     url: '/{{API_PATH}}/details',
@@ -24,6 +28,7 @@ export function getObj(obj?: object) {
   });
 }
 
+// 删除数据
 export function delObjs(ids?: object) {
   return request({
     url: '/{{API_PATH}}',
@@ -32,6 +37,7 @@ export function delObjs(ids?: object) {
   });
 }
 
+// 更新数据
 export function putObj(obj?: object) {
   return request({
     url: '/{{API_PATH}}',

package/assets/templates/single_table_dialog/form.tpl

@@ -15,20 +15,33 @@
 </template>
 
 <script setup lang="ts" name="{{CLASS_NAME}}Dialog">
+// 通用消息提示
 import { useMessage } from '/@/hooks/message';
+// 本地会话存储
 import { Session } from '/@/utils/storage';
+// 表单数据接口
 import { getObj, addObj, putObj } from '/@/api/{{API_MODULE_PATH}}';
+// 字典数据加载
 import { useDict } from '/@/hooks/dict';
+// 表单字段元数据能力
 import { useCrudPageMeta } from '/@/hooks/useCrudPageMeta';
+// 国际化能力
 import { useI18n } from 'vue-i18n';
+// 当前页面的字段配置
 import { allDictTypes, dataMasterEntity } from './options';
 
+// 页面所需的字典引用
 const dictRefs = useDict(...allDictTypes);
+// 国际化方法
 const { t } = useI18n();
+// 弹窗刷新事件
 const emit = defineEmits(['refresh']);
 
+// 表单引用
 const dataFormRef = ref();
+// 弹窗显示状态
 const visible = ref(false);
+// 提交加载状态
 const loading = ref(false);
 
 // 主表字段的双语、字典和校验提示统一由公共 hook 提供
@@ -41,14 +54,15 @@ const {
   fieldRequiredMessage,
 } = useCrudPageMeta(dataMasterEntity, dictRefs);
 
-// 表单数据模型
+// 统一维护表单默认值
 const createDefaultFormState = () => ({
 {{FORM_DEFAULTS}}
 });
 
+// 表单响应式数据
 const form = reactive(createDefaultFormState());
 
-// 表单校验规则，仅保留当前需求中明确必填的字段
+// 表单校验规则
 const dataRules = ref({
 {{FORM_RULES}}
 });
@@ -66,7 +80,7 @@ const get{{CLASS_NAME}}Data = async (id: string) => {
   }
 };
 
-// 回到初始表单状态，供新增和弹窗切换时复用
+// 重置表单为初始状态
 const resetFormState = () => {
   Object.assign(form, createDefaultFormState());
   nextTick(() => {
@@ -74,7 +88,7 @@ const resetFormState = () => {
   });
 };
 
-// 打开弹窗，按需加载编辑数据
+// 打开弹窗并按需加载详情
 const openDialog = async (id?: string) => {
   visible.value = true;
   resetFormState();
@@ -85,7 +99,7 @@ const openDialog = async (id?: string) => {
   }
 };
 
-// 弹窗表单提交逻辑
+// 提交弹窗表单
 const onSubmit = async () => {
   loading.value = true;
 
@@ -107,6 +121,7 @@ const onSubmit = async () => {
   }
 };
 
+// 向父组件暴露打开弹窗方法
 defineExpose({
   openDialog,
 });

package/assets/templates/single_table_dialog/index.tpl

@@ -35,25 +35,42 @@
 </template>
 
 <script setup lang="ts" name="system{{CLASS_NAME}}">
+// 列表接口
 import { fetchList, delObjs{{DICT_API_IMPORTS}} } from '/@/api/{{API_MODULE_PATH}}';
+// 通用消息与确认弹窗
 import { useMessage, useMessageBox } from '/@/hooks/message';
+// 字典数据加载
 import { useDict } from '/@/hooks/dict';
+// 列表页字段元数据能力
 import { useCrudPageMeta } from '/@/hooks/useCrudPageMeta';
+// 列表页查询与分页状态
 import { useSchemaListQuery } from '/@/hooks/useSchemaListQuery';
+// 统一列表工具栏组件
 import SchemaListToolbar from '/@/components/schema-list/SchemaListToolbar.vue';
+// 统一列表表格组件
 import SchemaListTable from '/@/components/schema-list/SchemaListTable.vue';
+// 国际化能力
 import { useI18n } from 'vue-i18n';
+// 当前页面的 schema 与字段配置
 import { allDictTypes, crudSchema, dataMasterEntity } from './options';
 
+// 表单弹窗组件
 const FormDialog = defineAsyncComponent(() => import('./form.vue'));
+// 页面所需的字典引用
 const dictRefs = useDict(...allDictTypes);
+// 国际化方法
 const { t } = useI18n();
 
+// 表单弹窗引用
 const formDialogRef = ref();
+// 导入组件引用
 const excelUploadRef = ref();
+// 列表勾选主键集合
 const selectObjs = ref<string[]>([]);
+// 批量删除按钮状态
 const multiple = ref(true);
 
+// 统一管理列表查询、分页、排序和导出
 const { state, getDataList, currentChangeHandle, sizeChangeHandle, sortChangeHandle, tableStyle, exportExcel: runExportExcel, resetQueryForm } = useSchemaListQuery({
   schema: crudSchema,
   pageList: fetchList,
@@ -61,8 +78,10 @@ const { state, getDataList, currentChangeHandle, sizeChangeHandle, sortChangeHan
   exportFileName: '{{FUNCTION_NAME}}.xlsx',
 });
 
+// 提供字段标签、字典选项和查询区描述
 const { resolveLabel, getDictOptions, visibleTableColumns, searchKeywordTooltip, queryableDictFields } = useCrudPageMeta(dataMasterEntity, dictRefs);
 
+// 自定义查询区的字典字段配置
 const queryableDictOptions = computed(() =>
   queryableDictFields.value.map((field) => ({
     ...field,
@@ -70,6 +89,7 @@ const queryableDictOptions = computed(() =>
   }))
 );
 
+// 列表表格列配置
 const tableColumns = computed(() =>
   visibleTableColumns.value.map((column) => ({
     prop: column.prop,
@@ -80,6 +100,7 @@ const tableColumns = computed(() =>
   }))
 );
 
+// 工具栏透传属性
 const toolbarProps = computed(() => ({
   keyword: state.queryForm.smartVal,
   searchPlaceholder: searchKeywordTooltip.value,
@@ -94,6 +115,7 @@ const toolbarProps = computed(() => ({
   showRightTools: {{SHOW_RIGHT_TOOLS}},
 }));
 
+// 表格透传属性
 const tableProps = computed(() => ({
   data: state.dataList,
   loading: !!state.loading,
@@ -102,12 +124,15 @@ const tableProps = computed(() => ({
   tableStyle,
 }));
 
+// 字典页动作按钮控制（按需生成）
 {{DICT_LIST_HELPERS}}
 
+// 导出当前勾选数据
 const exportExcel = () => {
   runExportExcel(selectObjs.value);
 };
 
+// 应用自定义查询条件
 const handleQueryFilterConfirm = (values: Record<string, any>) => {
   queryableDictFields.value.forEach((field) => {
     const nextValue = values[field.prop];
@@ -120,11 +145,13 @@ const handleQueryFilterConfirm = (values: Record<string, any>) => {
   getDataList();
 };
 
+// 重置查询条件
 const resetQuery = () => {
   resetQueryForm();
   getDataList();
 };
 
+// 删除列表数据
 const handleDelete = async (ids: string[]) => {
   try {
     await useMessageBox().confirm(t('common.delConfirmText'));
@@ -141,51 +168,63 @@ const handleDelete = async (ids: string[]) => {
   }
 };
 
+// 工具栏新增事件
 const handleToolbarAdd = () => {
   formDialogRef.value?.openDialog();
 };
 
+// 工具栏导入事件
 const handleToolbarImport = () => {
   excelUploadRef.value?.show();
 };
 
+// 工具栏批量删除事件
 const handleToolbarDelete = () => {
   handleDelete(selectObjs.value);
 };
 
+// 工具栏查询事件
 const handleToolbarQuery = () => {
   getDataList();
 };
 
+// 工具栏重置事件
 const handleToolbarReset = () => {
   resetQuery();
 };
 
+// 工具栏高级查询确认事件
 const handleToolbarCustomQueryConfirm = (payload: { values: Record<string, any> }) => {
   handleQueryFilterConfirm(payload.values);
 };
 
+// 工具栏导出事件
 const handleToolbarExport = () => {
   exportExcel();
 };
 
+// 工具栏刷新事件
 const handleToolbarRefresh = () => {
   getDataList();
 };
 
+// 表格勾选变化事件
 const handleTableSelectionChange = (payload: { ids: Array<string | number> }) => {
   selectObjs.value = payload.ids.map((id) => String(id));
   multiple.value = !payload.ids.length;
 };
 
+// 表格排序事件
 const handleTableSortChange = (payload: { raw: any }) => {
   sortChangeHandle(payload.raw);
 };
 
+// 分页大小变化事件
 const handleTableSizeChange = (payload: { size: number }) => {
   sizeChangeHandle(payload.size);
 };
 
+// 当前页变化事件
 const handleTableCurrentChange = (payload: { current: number }) => {
   currentChangeHandle(payload.current);
 };