worsoft-frontend-codegen-local-mcp 0.1.81 → 0.1.83

package/assets/templates/ledger_master_child_jump/api.tpl

@@ -1,5 +1,7 @@
+// 通用 CRUD 接口工厂
 import { createCrudApi } from '/@/api/common/crudFactory';
 {{API_REQUEST_IMPORT}}
 
+// {{FEATURE_TITLE}}主子表台账只读接口：分页查询、详情查询
 export const { fetchList, getObj } = createCrudApi('/{{API_PATH}}');
 {{EXTRA_API_FUNCTIONS}}

package/assets/templates/ledger_master_child_jump/form.tpl

@@ -1,16 +1,22 @@
 <template>
+  <!-- 页面布局：{{FEATURE_TITLE}}主子表台账详情页，只读展示主表和子表明细 -->
   <div class="layout-padding-auto layout-padding-view">
+    <!-- 详情卡片：承载标题、返回按钮、只读主表字段和只读子表明细 -->
     <el-card shadow="never" class="w100">
       <template #header>
+        <!-- 详情页头部：台账只显示查看标题和返回按钮 -->
         <div style="display: flex; justify-content: space-between; align-items: center;">
           <span style="font-size: 16px; font-weight: bold;">{{ t('common.viewBtn') }}</span>
           <el-button @click="handleBack" icon="back">{{ commonActionLabel('back') }}</el-button>
         </div>
       </template>
+      <!-- 只读主子表表单：字段由 MCP 根据 PRD 表单显隐和顺序渲染 -->
       <el-form ref="dataFormRef" :model="form" disabled v-loading="loading">
+        <!-- 主表字段区域 -->
         <el-row :gutter="24">
 {{FORM_FIELDS}}
         </el-row>
+        <!-- 子表明细区域：隐藏新增行和删除行入口 -->
         <el-row :gutter="24">
 {{LEDGER_CHILD_SECTIONS}}
         </el-row>
@@ -20,26 +26,43 @@
 </template>
 
 <script setup lang="ts" name="{{CLASS_NAME}}Form">
+// 本地会话存储：用于表单默认值生成兼容公共模板
 import { Session } from '/@/utils/storage';
+// 通用消息提示
 import { useMessage } from '/@/hooks/message';
+// 标签页关闭能力
 import { useCloseCurrentPage } from '/@/hooks/useCloseCurrentPage';
+// 台账详情接口：只消费 getObj
 import { getObj } 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();
+// 子表表格组件：仅用于只读展示，模板中 hide-add/hide-delete 固定启用
 const scFormTable = defineAsyncComponent(() => import('/@/components/FormTable/index.vue'));
+// 当前路由信息
 const route = useRoute();
 const { closeCurrentPage } = useCloseCurrentPage();
+// 当前页面的国际化命名空间
 const pageI18nKey = '{{I18N_NAMESPACE}}';
 
+// 表单引用
 const dataFormRef = ref();
+// 页面加载状态
 const loading = ref(false);
+// 台账详情固定为只读模式
 const detail = ref(true);
 
+// 主表和子表字段的双语、字典和提示文案由公共 hook 提供
 const {
   getFieldMeta: getMasterFieldMeta,
   getFieldLabel: getMasterFieldLabel,
@@ -51,17 +74,22 @@ const {
   commonActionLabel,
 } = useCrudPageMeta(dataMasterEntity, dictRefs, childFieldGroups);
 
+// 台账详情只读，不显示输入占位提示
 const formInputPlaceholder = () => '';
 const formSelectPlaceholder = () => '';
+// 子表分组标题从功能级词条中读取
 const childSectionTitle = (groupName: string) => t(`${pageI18nKey}.children.${groupName}.title`);
 
+// 统一维护表单默认值和子表列表默认值
 const createDefaultFormState = () => ({
 {{FORM_DEFAULTS}}
 {{CHILD_FORM_LIST_DEFAULTS}}
 });
 
+// 表单响应式数据
 const form = reactive(createDefaultFormState());
 
+// 根据主键加载台账详情数据
 const get{{CLASS_NAME}}Data = async (id: string) => {
   try {
     loading.value = true;
@@ -74,6 +102,7 @@ const get{{CLASS_NAME}}Data = async (id: string) => {
   }
 };
 
+// 重置表单为初始状态，并清空子表列表
 const resetFormState = () => {
   Object.assign(form, createDefaultFormState());
   nextTick(() => {
@@ -82,6 +111,7 @@ const resetFormState = () => {
   });
 };
 
+// 根据路由参数初始化详情页
 const initPage = async () => {
   const id = route.query.id as string;
   detail.value = true;
@@ -93,10 +123,12 @@ const initPage = async () => {
   }
 };
 
+// 返回上一页并关闭当前标签
 const handleBack = () => {
   closeCurrentPage();
 };
 
+// 页面挂载后初始化详情数据
 onMounted(() => {
   initPage();
 });

package/assets/templates/ledger_master_child_jump/index.tpl

@@ -1,6 +1,8 @@
 <template>
+  <!-- 页面布局：{{FEATURE_TITLE}}主子表台账列表页，只提供查询和查看能力 -->
   <div class="layout-padding">
     <div class="layout-padding-auto layout-padding-view flex h-full flex-col">
+      <!-- 台账工具栏：保留关键字查询、重置、高级查询和刷新，隐藏新增、导入、删除、导出 -->
       <SchemaListToolbar
         v-bind="toolbarProps"
         @update:keyword="state.queryForm.smartVal = $event"
@@ -10,6 +12,7 @@
         @refresh="handleToolbarRefresh"
       />
 
+      <!-- 台账列表表格：展示主表列表数据和行内查看按钮，不提供勾选批量操作 -->
       <SchemaListTable
         v-bind="tableProps"
         row-id-key="{{PK_ATTR}}"
@@ -18,6 +21,7 @@
         @size-change="handleTableSizeChange"
         @current-change="handleTableCurrentChange"
       >
+        <!-- 行操作按钮：主子表台账只允许查看详情 -->
         <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>
         </template>
@@ -27,19 +31,31 @@
 </template>
 
 <script setup lang="ts" name="system{{CLASS_NAME}}">
+// 台账列表接口：只消费分页查询能力
 import { fetchList } from '/@/api/{{API_MODULE_PATH}}';
+// 字典数据加载
 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 dictRefs = useDict(...allDictTypes);
+// 国际化方法
 const { t } = useI18n();
+// 路由跳转能力
 const router = useRouter();
 
+// 统一管理台账列表查询、分页和排序
 const { state, getDataList, currentChangeHandle, sizeChangeHandle, sortChangeHandle, tableStyle, resetQueryForm } = useSchemaListQuery({
   schema: crudSchema,
   pageList: fetchList,
@@ -47,8 +63,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,
@@ -56,6 +74,7 @@ const queryableDictOptions = computed(() =>
   }))
 );
 
+// 列表表格列配置
 const tableColumns = computed(() =>
   visibleTableColumns.value.map((column) => ({
     prop: column.prop,
@@ -66,6 +85,7 @@ const tableColumns = computed(() =>
   }))
 );
 
+// 台账工具栏透传属性：显式关闭新增、导入、删除和导出入口
 const toolbarProps = computed(() => ({
   keyword: state.queryForm.smartVal,
   searchPlaceholder: searchKeywordTooltip.value,
@@ -78,6 +98,7 @@ const toolbarProps = computed(() => ({
   exportPermission: false,
 }));
 
+// 台账表格透传属性：关闭勾选列，仅保留查看操作列
 const tableProps = computed(() => ({
   data: state.dataList,
   loading: !!state.loading,
@@ -87,12 +108,15 @@ const tableProps = computed(() => ({
   showSelection: false,
 }));
 
+// 详情页路由路径
 const getFormPath = () => '/{{VIEW_MODULE_PATH}}/form';
 
+// 跳转台账详情页，固定 detail=1
 const handleDetail = (id: string) => {
   router.push({ path: getFormPath(), query: { id, detail: '1', tagsViewName: t('common.viewBtn') } });
 };
 
+// 应用高级查询条件
 const handleQueryFilterConfirm = (values: Record<string, any>) => {
   queryableDictFields.value.forEach((field) => {
     const nextValue = values[field.prop];
@@ -105,35 +129,43 @@ const handleQueryFilterConfirm = (values: Record<string, any>) => {
   getDataList();
 };
 
+// 重置查询条件并刷新列表
 const resetQuery = () => {
   resetQueryForm();
   getDataList();
 };
 
+// 工具栏查询事件
 const handleToolbarQuery = () => {
   getDataList();
 };
 
+// 工具栏重置事件
 const handleToolbarReset = () => {
   resetQuery();
 };
 
+// 工具栏高级查询确认事件
 const handleToolbarCustomQueryConfirm = (payload: { values: Record<string, any> }) => {
   handleQueryFilterConfirm(payload.values);
 };
 
+// 工具栏刷新事件
 const handleToolbarRefresh = () => {
   getDataList();
 };
 
+// 表格排序事件
 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/ledger_master_child_jump/menu.sql.tpl

@@ -2,11 +2,14 @@
 -- Suggested default parent_id: -1
 -- Generated by worsoft-codegen-local on {{GENERATED_AT}}
 
+-- 主子表台账列表菜单：只读台账入口
 insert into sys_menu (menu_id, parent_id, path, permission, menu_type, icon, del_flag, create_time, sort_order, update_time, name, tenant_id)
 values ({{MENU_BASE_ID}}, '-1', '/{{MENU_ROUTE_PATH}}/index', '', '0', 'icon-bangzhushouji', '0', null, '8', null, '{{TABLE_COMMENT}}管理', 1);
 
+-- 主子表台账详情路由：隐藏菜单，用于列表页查看跳转
 insert into sys_menu (menu_id, parent_id, path, permission, menu_type, icon, visible, del_flag, create_time, sort_order, update_time, name, tenant_id)
 values ({{MENU_BASE_ID_PLUS_6}}, '-1', '/{{MENU_ROUTE_PATH}}/form', '', '0', 'icon-biaodan', '0', '0', null, '9', null, '{{TABLE_COMMENT}}详情', 1);
 
+-- 台账查看权限：不生成新增、编辑、删除等操作权限
 insert into sys_menu (menu_id, parent_id, permission, menu_type, path, icon, del_flag, create_time, sort_order, update_time, name, tenant_id)
 values ({{MENU_BASE_ID_PLUS_1}}, {{MENU_BASE_ID}}, '{{PERMISSION_PREFIX}}_view', '1', null, '1', '0', null, '0', null, '{{TABLE_COMMENT}}查看', 1);

package/assets/templates/ledger_master_child_jump/options.tpl

@@ -1,7 +1,14 @@
+// 字典注册表
 {{DICT_REGISTRY_IMPORT_BLOCK}}
+// schema 构建工具
 import { createCrudSchema } from '/@/utils/crudSchema';
+// schema 类型定义
 import type { CrudSchemaDefinition } from '/@/utils/crudSchema';
 
+/**
+ * {{TABLE_NAME}} 主子表台账页面字段声明
+ * 这里维护主表和子表字段 key、双语 key、字典类型和显示元数据。
+ */
 const definition: CrudSchemaDefinition = {
   master: [
 {{MASTER_OPTION_FIELDS}}
@@ -11,11 +18,18 @@ const definition: CrudSchemaDefinition = {
   },
 };
 
+// 将页面字段声明转换为 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/ledger_single_table_jump/api.tpl

@@ -1,5 +1,7 @@
+// 通用 CRUD 接口工厂
 import { createCrudApi } from '/@/api/common/crudFactory';
 {{API_REQUEST_IMPORT}}
 
+// {{FEATURE_TITLE}}台账只读接口：分页查询、详情查询
 export const { fetchList, getObj } = createCrudApi('/{{API_PATH}}');
 {{EXTRA_API_FUNCTIONS}}

package/assets/templates/ledger_single_table_jump/form.tpl

@@ -1,12 +1,16 @@
 <template>
+  <!-- 页面布局：{{FEATURE_TITLE}}台账详情页，只读展示主表字段 -->
   <div class="layout-padding-auto layout-padding-view">
+    <!-- 详情卡片：承载标题、返回按钮和只读表单 -->
     <el-card shadow="never" class="w100">
       <template #header>
+        <!-- 详情页头部：台账只显示查看标题和返回按钮 -->
         <div style="display: flex; justify-content: space-between; align-items: center;">
           <span style="font-size: 16px; font-weight: bold;">{{ t('common.viewBtn') }}</span>
           <el-button @click="handleBack" icon="back">{{ commonActionLabel('back') }}</el-button>
         </div>
       </template>
+      <!-- 只读主表表单：字段由 MCP 根据 PRD 表单显隐和顺序渲染 -->
       <el-form ref="dataFormRef" :model="form" disabled v-loading="loading">
         <el-row :gutter="24">
 {{FORM_FIELDS}}
@@ -17,24 +21,39 @@
 </template>
 
 <script setup lang="ts" name="{{CLASS_NAME}}Form">
+// 本地会话存储：用于表单默认值生成兼容公共模板
 import { Session } from '/@/utils/storage';
+// 通用消息提示
 import { useMessage } from '/@/hooks/message';
+// 标签页关闭能力
 import { useCloseCurrentPage } from '/@/hooks/useCloseCurrentPage';
+// 台账详情接口：只消费 getObj
 import { getObj } 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 route = useRoute();
 const { closeCurrentPage } = useCloseCurrentPage();
 
+// 表单引用
 const dataFormRef = ref();
+// 页面加载状态
 const loading = ref(false);
+// 台账详情固定为只读模式
 const detail = ref(true);
 
+// 主表字段的双语、字典和提示文案由公共 hook 提供
 const {
   getFieldMeta: getMasterFieldMeta,
   getFieldLabel: getMasterFieldLabel,
@@ -45,15 +64,19 @@ const {
   commonActionLabel,
 } = useCrudPageMeta(dataMasterEntity, dictRefs);
 
+// 台账详情只读，不显示输入占位提示
 const formInputPlaceholder = () => '';
 const formSelectPlaceholder = () => '';
 
+// 统一维护表单默认值
 const createDefaultFormState = () => ({
 {{FORM_DEFAULTS}}
 });
 
+// 表单响应式数据
 const form = reactive(createDefaultFormState());
 
+// 根据主键加载台账详情数据
 const get{{CLASS_NAME}}Data = async (id: string) => {
   try {
     loading.value = true;
@@ -66,6 +89,7 @@ const get{{CLASS_NAME}}Data = async (id: string) => {
   }
 };
 
+// 重置表单为初始状态
 const resetFormState = () => {
   Object.assign(form, createDefaultFormState());
   nextTick(() => {
@@ -73,6 +97,7 @@ const resetFormState = () => {
   });
 };
 
+// 根据路由参数初始化详情页
 const initPage = async () => {
   const id = route.query.id as string;
   detail.value = true;
@@ -84,10 +109,12 @@ const initPage = async () => {
   }
 };
 
+// 返回上一页并关闭当前标签
 const handleBack = () => {
   closeCurrentPage();
 };
 
+// 页面挂载后初始化详情数据
 onMounted(() => {
   initPage();
 });

package/assets/templates/ledger_single_table_jump/index.tpl

@@ -1,6 +1,8 @@
 <template>
+  <!-- 页面布局：{{FEATURE_TITLE}}台账列表页，只提供查询和查看能力 -->
   <div class="layout-padding">
     <div class="layout-padding-auto layout-padding-view flex h-full flex-col">
+      <!-- 台账工具栏：保留关键字查询、重置、高级查询和刷新，隐藏新增、导入、删除、导出 -->
       <SchemaListToolbar
         v-bind="toolbarProps"
         @update:keyword="state.queryForm.smartVal = $event"
@@ -10,6 +12,7 @@
         @refresh="handleToolbarRefresh"
       />
 
+      <!-- 台账列表表格：展示列表数据和行内查看按钮，不提供勾选批量操作 -->
       <SchemaListTable
         v-bind="tableProps"
         row-id-key="{{PK_ATTR}}"
@@ -18,6 +21,7 @@
         @size-change="handleTableSizeChange"
         @current-change="handleTableCurrentChange"
       >
+        <!-- 行操作按钮：台账只允许查看详情 -->
         <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>
         </template>
@@ -27,19 +31,31 @@
 </template>
 
 <script setup lang="ts" name="system{{CLASS_NAME}}">
+// 台账列表接口：只消费分页查询能力
 import { fetchList } from '/@/api/{{API_MODULE_PATH}}';
+// 字典数据加载
 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 dictRefs = useDict(...allDictTypes);
+// 国际化方法
 const { t } = useI18n();
+// 路由跳转能力
 const router = useRouter();
 
+// 统一管理台账列表查询、分页和排序
 const { state, getDataList, currentChangeHandle, sizeChangeHandle, sortChangeHandle, tableStyle, resetQueryForm } = useSchemaListQuery({
   schema: crudSchema,
   pageList: fetchList,
@@ -47,8 +63,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,
@@ -56,6 +74,7 @@ const queryableDictOptions = computed(() =>
   }))
 );
 
+// 列表表格列配置
 const tableColumns = computed(() =>
   visibleTableColumns.value.map((column) => ({
     prop: column.prop,
@@ -66,6 +85,7 @@ const tableColumns = computed(() =>
   }))
 );
 
+// 台账工具栏透传属性：显式关闭新增、导入、删除和导出入口
 const toolbarProps = computed(() => ({
   keyword: state.queryForm.smartVal,
   searchPlaceholder: searchKeywordTooltip.value,
@@ -78,6 +98,7 @@ const toolbarProps = computed(() => ({
   exportPermission: false,
 }));
 
+// 台账表格透传属性：关闭勾选列，仅保留查看操作列
 const tableProps = computed(() => ({
   data: state.dataList,
   loading: !!state.loading,
@@ -87,12 +108,15 @@ const tableProps = computed(() => ({
   showSelection: false,
 }));
 
+// 详情页路由路径
 const getFormPath = () => '/{{VIEW_MODULE_PATH}}/form';
 
+// 跳转台账详情页，固定 detail=1
 const handleDetail = (id: string) => {
   router.push({ path: getFormPath(), query: { id, detail: '1', tagsViewName: t('common.viewBtn') } });
 };
 
+// 应用高级查询条件
 const handleQueryFilterConfirm = (values: Record<string, any>) => {
   queryableDictFields.value.forEach((field) => {
     const nextValue = values[field.prop];
@@ -105,35 +129,43 @@ const handleQueryFilterConfirm = (values: Record<string, any>) => {
   getDataList();
 };
 
+// 重置查询条件并刷新列表
 const resetQuery = () => {
   resetQueryForm();
   getDataList();
 };
 
+// 工具栏查询事件
 const handleToolbarQuery = () => {
   getDataList();
 };
 
+// 工具栏重置事件
 const handleToolbarReset = () => {
   resetQuery();
 };
 
+// 工具栏高级查询确认事件
 const handleToolbarCustomQueryConfirm = (payload: { values: Record<string, any> }) => {
   handleQueryFilterConfirm(payload.values);
 };
 
+// 工具栏刷新事件
 const handleToolbarRefresh = () => {
   getDataList();
 };
 
+// 表格排序事件
 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/ledger_single_table_jump/menu.sql.tpl

@@ -2,11 +2,14 @@
 -- Suggested default parent_id: -1
 -- Generated by worsoft-codegen-local on {{GENERATED_AT}}
 
+-- 台账列表菜单：只读台账入口
 insert into sys_menu (menu_id, parent_id, path, permission, menu_type, icon, del_flag, create_time, sort_order, update_time, name, tenant_id)
 values ({{MENU_BASE_ID}}, '-1', '/{{MENU_ROUTE_PATH}}/index', '', '0', 'icon-bangzhushouji', '0', null, '8', null, '{{TABLE_COMMENT}}管理', 1);
 
+-- 台账详情路由：隐藏菜单，用于列表页查看跳转
 insert into sys_menu (menu_id, parent_id, path, permission, menu_type, icon, visible, del_flag, create_time, sort_order, update_time, name, tenant_id)
 values ({{MENU_BASE_ID_PLUS_6}}, '-1', '/{{MENU_ROUTE_PATH}}/form', '', '0', 'icon-biaodan', '0', '0', null, '9', null, '{{TABLE_COMMENT}}详情', 1);
 
+-- 台账查看权限：不生成新增、编辑、删除等操作权限
 insert into sys_menu (menu_id, parent_id, permission, menu_type, path, icon, del_flag, create_time, sort_order, update_time, name, tenant_id)
 values ({{MENU_BASE_ID_PLUS_1}}, {{MENU_BASE_ID}}, '{{PERMISSION_PREFIX}}_view', '1', null, '1', '0', null, '0', null, '{{TABLE_COMMENT}}查看', 1);

package/assets/templates/ledger_single_table_jump/options.tpl

@@ -1,7 +1,14 @@
+// 字典注册表
 {{DICT_REGISTRY_IMPORT_BLOCK}}
+// schema 构建工具
 import { createCrudSchema } from '/@/utils/crudSchema';
+// schema 类型定义
 import type { CrudSchemaDefinition } from '/@/utils/crudSchema';
 
+/**
+ * {{TABLE_NAME}} 台账页面字段声明
+ * 这里维护字段 key、双语 key、字典类型和显示元数据。
+ */
 const definition: CrudSchemaDefinition = {
   master: [
 {{MASTER_OPTION_FIELDS}}
@@ -11,11 +18,18 @@ const definition: CrudSchemaDefinition = {
   },
 };
 
+// 将页面字段声明转换为 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_jump/index.tpl

@@ -21,18 +21,22 @@
       <SchemaListTable
         v-bind="tableProps"
         row-id-key="{{PK_ATTR}}"
-        :action-column-width="200"
+        :action-column-width="320"
         @selection-change="handleTableSelectionChange"
         @sort-change="handleTableSortChange"
         @size-change="handleTableSizeChange"
         @current-change="handleTableCurrentChange"
       >
-        <!-- 行操作按钮：查看、编辑、删除 -->
+        <!-- 行操作按钮：查看、编辑、提交、流转、删除 -->
         <template #actions="{ row }">
           <!-- 查看{{FEATURE_TITLE}}详情 -->
           <el-button text type="primary" icon="view" v-auth="'{{PERMISSION_PREFIX}}_view'" @click="handleDetail(row.{{PK_ATTR}})">{{ t('common.viewBtn') }}</el-button>
           <!-- 编辑{{FEATURE_TITLE}}：业务单据编辑态控制按需生效 -->
           <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>
+          <!-- 提交{{FEATURE_TITLE}} -->
+          <el-button text type="primary" icon="check" @click="handleQuickAction(row, 'submit')">{{ commonActionLabel('submit') }}</el-button>
+          <!-- 流转{{FEATURE_TITLE}} -->
+          <el-button text type="success" icon="position" @click="handleQuickAction(row, 'flow')">{{ commonActionLabel('flow') }}</el-button>
           <!-- 删除{{FEATURE_TITLE}} -->
           <el-button{{BUSINESS_DELETE_IF}} icon="delete" text type="primary" v-auth="'{{PERMISSION_PREFIX}}_del'" @click="handleDelete([row.{{PK_ATTR}}]{{BUSINESS_DELETE_ROW_ARG}})">{{ t('common.delBtn') }}</el-button>
         </template>
@@ -90,7 +94,7 @@ const { state, getDataList, currentChangeHandle, sizeChangeHandle, sortChangeHan
 });
 
 // 提供字段标签、字典选项和查询区描述
-const { resolveLabel, getDictOptions, visibleTableColumns, searchKeywordTooltip, queryableDictFields } = useCrudPageMeta(dataMasterEntity, dictRefs);
+const { resolveLabel, getDictOptions, commonActionLabel, visibleTableColumns, searchKeywordTooltip, queryableDictFields } = useCrudPageMeta(dataMasterEntity, dictRefs);
 
 // 自定义查询区的字典字段配置
 const queryableDictOptions = computed(() =>
@@ -152,6 +156,22 @@ const handleEdit = (id: string) => {
   router.push({ path: getFormPath(), query: { id, tagsViewName: t('common.editBtn') } });
 };
 
+// 列表页快捷提交流转占位
+const handleQuickAction = async (_row: any, actionType: string) => {
+  const actionName = commonActionLabel(actionType);
+  try {
+    await useMessageBox().confirm(t('common.messages.quickActionConfirm', { action: actionName }));
+    useMessage().success(
+      actionType === 'submit'
+        ? t('common.messages.quickSubmitSuccess')
+        : t('common.messages.quickFlowSuccess')
+    );
+    getDataList();
+  } catch {
+    return;
+  }
+};
+
 // 业务状态按钮控制（按需生成）
 {{BUSINESS_STATUS_HELPERS}}
 

package/mcp_server.js

@@ -5,7 +5,7 @@ const fs = require('fs');
 const path = require('path');
 
 const SERVER_NAME = 'worsoft-codegen-local';
-const SERVER_VERSION = '0.1.80';
+const SERVER_VERSION = '0.1.83';
 const PROTOCOL_VERSION = '2024-11-05';
 const TOOL_NAME = 'worsoft_codegen_local_generate_frontend';
 const STYLE_CATALOG_PATH = path.join(__dirname, 'assets', 'style-catalog.json');

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "worsoft-frontend-codegen-local-mcp",
-  "version": "0.1.81",
+  "version": "0.1.83",
   "description": "Worsoft frontend local-template code generation MCP server.",
   "license": "UNLICENSED",
   "author": "worsoft <sw@worsoft.vip>",