worsoft-frontend-codegen-local-mcp 0.1.80 → 0.1.82

package/assets/templates/ledger_master_child_jump/api.tpl

@@ -0,0 +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

@@ -0,0 +1,135 @@
+<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>
+      </el-form>
+    </el-card>
+  </div>
+</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,
+  getChildFieldLabel,
+  getDictOptions,
+  inputPlaceholder,
+  selectPlaceholder,
+  fieldRequiredMessage,
+  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;
+    const { data } = await getObj({ {{PK_ATTR}}: id });
+    Object.assign(form, Array.isArray(data) ? data[0] || {} : data || {});
+  } catch (error) {
+    useMessage().error(t('common.messages.fetchError'));
+  } finally {
+    loading.value = false;
+  }
+};
+
+// 重置表单为初始状态，并清空子表列表
+const resetFormState = () => {
+  Object.assign(form, createDefaultFormState());
+  nextTick(() => {
+    dataFormRef.value?.resetFields();
+{{CHILD_RESET_LISTS}}
+  });
+};
+
+// 根据路由参数初始化详情页
+const initPage = async () => {
+  const id = route.query.id as string;
+  detail.value = true;
+  resetFormState();
+
+  if (id) {
+    form.{{PK_ATTR}} = id;
+    await get{{CLASS_NAME}}Data(id);
+  }
+};
+
+// 返回上一页并关闭当前标签
+const handleBack = () => {
+  closeCurrentPage();
+};
+
+// 页面挂载后初始化详情数据
+onMounted(() => {
+  initPage();
+});
+</script>

package/assets/templates/ledger_master_child_jump/index.tpl

@@ -0,0 +1,172 @@
+<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"
+        @query="handleToolbarQuery"
+        @reset="handleToolbarReset"
+        @custom-query-confirm="handleToolbarCustomQueryConfirm"
+        @refresh="handleToolbarRefresh"
+      />
+
+      <!-- 台账列表表格：展示主表列表数据和行内查看按钮，不提供勾选批量操作 -->
+      <SchemaListTable
+        v-bind="tableProps"
+        row-id-key="{{PK_ATTR}}"
+        :action-column-width="100"
+        @sort-change="handleTableSortChange"
+        @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>
+      </SchemaListTable>
+    </div>
+  </div>
+</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,
+  exportUrl: '/{{API_PATH}}/export',
+  exportFileName: '{{FUNCTION_NAME}}.xlsx',
+});
+
+// 提供字段标签、字典选项和查询区描述
+const { resolveLabel, getDictOptions, visibleTableColumns, searchKeywordTooltip, queryableDictFields } = useCrudPageMeta(dataMasterEntity, dictRefs);
+
+// 高级查询字典字段配置
+const queryableDictOptions = computed(() =>
+  queryableDictFields.value.map((field) => ({
+    ...field,
+    options: getDictOptions(field.dictType),
+  }))
+);
+
+// 列表表格列配置
+const tableColumns = computed(() =>
+  visibleTableColumns.value.map((column) => ({
+    prop: column.prop,
+    label: resolveLabel(column.labelKey, column.fallbackLabel),
+    width: column.width,
+    dictType: column.dictType,
+    options: column.dictType ? getDictOptions(column.dictType) : [],
+  }))
+);
+
+// 台账工具栏透传属性：显式关闭新增、导入、删除和导出入口
+const toolbarProps = computed(() => ({
+  keyword: state.queryForm.smartVal,
+  searchPlaceholder: searchKeywordTooltip.value,
+  queryModel: state.queryForm,
+  customQueryFields: queryableDictOptions.value,
+  selectedIds: [],
+  showAdd: false,
+  showImport: false,
+  showDelete: false,
+  exportPermission: false,
+}));
+
+// 台账表格透传属性：关闭勾选列，仅保留查看操作列
+const tableProps = computed(() => ({
+  data: state.dataList,
+  loading: !!state.loading,
+  columns: tableColumns.value,
+  pagination: state.pagination,
+  tableStyle,
+  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];
+    if (Array.isArray(nextValue) && nextValue.length) {
+      state.queryForm[field.prop] = nextValue;
+      return;
+    }
+    delete state.queryForm[field.prop];
+  });
+  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);
+};
+</script>

package/assets/templates/ledger_master_child_jump/menu.sql.tpl

@@ -0,0 +1,15 @@
+-- Do not execute directly. Review parent menu id and tenant settings before import.
+-- 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

@@ -0,0 +1,35 @@
+// 字典注册表
+{{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}}
+  ],
+  children: {
+{{CHILD_OPTION_GROUPS}}
+  },
+};
+
+// 将页面字段声明转换为 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

@@ -0,0 +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

@@ -0,0 +1,121 @@
+<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-form>
+    </el-card>
+  </div>
+</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,
+  getDictOptions,
+  inputPlaceholder,
+  selectPlaceholder,
+  fieldRequiredMessage,
+  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;
+    const { data } = await getObj({ {{PK_ATTR}}: id });
+    Object.assign(form, Array.isArray(data) ? data[0] || {} : data || {});
+  } catch (error) {
+    useMessage().error(t('common.messages.fetchError'));
+  } finally {
+    loading.value = false;
+  }
+};
+
+// 重置表单为初始状态
+const resetFormState = () => {
+  Object.assign(form, createDefaultFormState());
+  nextTick(() => {
+    dataFormRef.value?.resetFields();
+  });
+};
+
+// 根据路由参数初始化详情页
+const initPage = async () => {
+  const id = route.query.id as string;
+  detail.value = true;
+  resetFormState();
+
+  if (id) {
+    form.{{PK_ATTR}} = id;
+    await get{{CLASS_NAME}}Data(id);
+  }
+};
+
+// 返回上一页并关闭当前标签
+const handleBack = () => {
+  closeCurrentPage();
+};
+
+// 页面挂载后初始化详情数据
+onMounted(() => {
+  initPage();
+});
+</script>

package/assets/templates/ledger_single_table_jump/index.tpl

@@ -0,0 +1,172 @@
+<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"
+        @query="handleToolbarQuery"
+        @reset="handleToolbarReset"
+        @custom-query-confirm="handleToolbarCustomQueryConfirm"
+        @refresh="handleToolbarRefresh"
+      />
+
+      <!-- 台账列表表格：展示列表数据和行内查看按钮，不提供勾选批量操作 -->
+      <SchemaListTable
+        v-bind="tableProps"
+        row-id-key="{{PK_ATTR}}"
+        :action-column-width="100"
+        @sort-change="handleTableSortChange"
+        @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>
+      </SchemaListTable>
+    </div>
+  </div>
+</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,
+  exportUrl: '/{{API_PATH}}/export',
+  exportFileName: '{{FUNCTION_NAME}}.xlsx',
+});
+
+// 提供字段标签、字典选项和查询区描述
+const { resolveLabel, getDictOptions, visibleTableColumns, searchKeywordTooltip, queryableDictFields } = useCrudPageMeta(dataMasterEntity, dictRefs);
+
+// 高级查询字典字段配置
+const queryableDictOptions = computed(() =>
+  queryableDictFields.value.map((field) => ({
+    ...field,
+    options: getDictOptions(field.dictType),
+  }))
+);
+
+// 列表表格列配置
+const tableColumns = computed(() =>
+  visibleTableColumns.value.map((column) => ({
+    prop: column.prop,
+    label: resolveLabel(column.labelKey, column.fallbackLabel),
+    width: column.width,
+    dictType: column.dictType,
+    options: column.dictType ? getDictOptions(column.dictType) : [],
+  }))
+);
+
+// 台账工具栏透传属性：显式关闭新增、导入、删除和导出入口
+const toolbarProps = computed(() => ({
+  keyword: state.queryForm.smartVal,
+  searchPlaceholder: searchKeywordTooltip.value,
+  queryModel: state.queryForm,
+  customQueryFields: queryableDictOptions.value,
+  selectedIds: [],
+  showAdd: false,
+  showImport: false,
+  showDelete: false,
+  exportPermission: false,
+}));
+
+// 台账表格透传属性：关闭勾选列，仅保留查看操作列
+const tableProps = computed(() => ({
+  data: state.dataList,
+  loading: !!state.loading,
+  columns: tableColumns.value,
+  pagination: state.pagination,
+  tableStyle,
+  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];
+    if (Array.isArray(nextValue) && nextValue.length) {
+      state.queryForm[field.prop] = nextValue;
+      return;
+    }
+    delete state.queryForm[field.prop];
+  });
+  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);
+};
+</script>

package/assets/templates/ledger_single_table_jump/menu.sql.tpl

@@ -0,0 +1,15 @@
+-- Do not execute directly. Review parent menu id and tenant settings before import.
+-- 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

@@ -0,0 +1,35 @@
+// 字典注册表
+{{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}}
+  ],
+  children: {
+{{CHILD_OPTION_GROUPS}}
+  },
+};
+
+// 将页面字段声明转换为 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/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.82';
 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');
@@ -267,10 +267,10 @@ const TOOL_SCHEMA = {
     tableName: { type: 'string', description: 'Canonical main table name from PRD-aligned structured metadata.' },
     tableComment: { type: 'string', description: 'Canonical main table comment or feature label from PRD-aligned structured metadata.' },
     apiPath: { type: 'string', description: 'Backend API base path from pre-parsed structured metadata, for example iwmEmpOutsourcePerson.' },
-    pageType: {
-      type: 'string',
-      enum: ['business', 'dict', 'non_standard'],
-      description: 'Structured page type from parseResult. MCP consumes this value but does not derive it. Dict pages are restricted to dialog-based templates.',
+    pageType: {
+      type: 'string',
+      enum: ['business', 'dict', 'ledger', 'non_standard'],
+      description: 'Structured page type from parseResult. MCP consumes this value but does not derive it. Dict pages are restricted to dialog-based templates. Ledger pages are read-only jump-based templates.',
     },
     style: { type: 'string', enum: Object.keys(STYLE_CATALOG), description: 'Final style id from parseResult or translated mcpPayload. MCP validates it but does not infer it.' },
     fields: {
@@ -1641,12 +1641,12 @@ function getStylePreset(styleId) {
   return preset;
 }
 
-function normalizePageTypeInput(pageType) {
-  if (pageType === undefined || pageType === null || pageType === '') return '';
-  const normalized = String(pageType).trim();
-  if (['business', 'dict', 'non_standard'].includes(normalized)) return normalized;
-  throw new Error(`Unsupported pageType: ${normalized}. Allowed values are dict, business, non_standard.`);
-}
+function normalizePageTypeInput(pageType) {
+  if (pageType === undefined || pageType === null || pageType === '') return '';
+  const normalized = String(pageType).trim();
+  if (['business', 'dict', 'ledger', 'non_standard'].includes(normalized)) return normalized;
+  throw new Error(`Unsupported pageType: ${normalized}. Allowed values are dict, business, ledger, non_standard.`);
+}
 
 function rejectSemanticStageInputs(input) {
   const forbiddenKeys = [
@@ -1669,17 +1669,23 @@ function validatePageTypeAndStyle(pageType, style) {
   if (pageType === 'non_standard') {
     throw new Error('non_standard pages are not supported by worsoft_codegen_local_generate_frontend');
   }
-  if (pageType === 'business') {
-    if (style === 'single_table_dialog') {
-      throw new Error('Business pages must use jump-based styles. pageType=business does not support style=single_table_dialog; use single_table_jump for single-table business pages or master_child_jump for master-child business pages.');
-    }
-    return;
-  }
-  if (pageType !== 'dict') return;
-  if (style === 'single_table_jump' || style === 'master_child_jump') {
-    throw new Error(`Dict pages must use dialog-based styles. pageType=dict does not support style=${style}`);
-  }
-}
+  if (pageType === 'business') {
+    if (style === 'single_table_dialog') {
+      throw new Error('Business pages must use jump-based styles. pageType=business does not support style=single_table_dialog; use single_table_jump for single-table business pages or master_child_jump for master-child business pages.');
+    }
+    return;
+  }
+  if (pageType === 'ledger') {
+    if (style !== 'single_table_jump' && style !== 'master_child_jump') {
+      throw new Error('Ledger pages must use jump-based styles. pageType=ledger supports single_table_jump or master_child_jump only.');
+    }
+    return;
+  }
+  if (pageType !== 'dict') return;
+  if (style === 'single_table_jump' || style === 'master_child_jump') {
+    throw new Error(`Dict pages must use dialog-based styles. pageType=dict does not support style=${style}`);
+  }
+}
 
 function hasRuntimeSupport(stylePreset) {
   return Boolean(stylePreset.runtime && stylePreset.runtime.supported && stylePreset.runtime.templateDir);
@@ -2181,8 +2187,8 @@ function renderChildTempDeclaration(childModel) {
   ].join('\n');
 }
 
-function renderChildSection(childModel, childCount) {
-  const deleteExpression = `deleteChild(obj, '${childModel.pk.attrName}')`;
+function renderChildSection(childModel, childCount) {
+  const deleteExpression = `deleteChild(obj, '${childModel.pk.attrName}')`;
 
   return [
     '          <el-col :span="24" class="mb20">',
@@ -3413,6 +3419,21 @@ function renderBusinessDeleteGuard(model) {
   ].join('\n');
 }
 
+function asReadonlyField(field) {
+  return { ...field, readonly: true };
+}
+
+function renderLedgerChildSection(childModel) {
+  return [
+    '          <el-col :span="24" class="mb20">',
+    `            <div class="mb10" style="font-weight: 600;">{{ childSectionTitle('${childModel.listName}') }}</div>`,
+    `            <sc-form-table v-model="form.${childModel.listName}" hide-add hide-delete :placeholder="t('common.noData')">`,
+    childModel.visibleFields.map((field) => renderChildTableColumn(asReadonlyField(field), childModel.listName)).join('\n'),
+    '            </sc-form-table>',
+    '          </el-col>',
+  ].join('\n');
+}
+
 function renderBusinessSubmitStatusAssignment(model) {
   if (!hasBusinessBillStateEditControl(model)) return '';
   const statusAttr = toCamelCase(model.statusField);
@@ -3541,7 +3562,7 @@ function buildReplacements(model, sharedSupport) {
       MENU_BASE_ID_PLUS_5: menuBaseId + 5,
       MENU_BASE_ID_PLUS_6: menuBaseId + 6,
       GENERATED_AT: new Date().toISOString(),
-      FORM_FIELDS: model.visibleFields.map(renderFormFieldV2).join('\n'),
+      FORM_FIELDS: (model.pageType === 'ledger' ? model.visibleFields.map(asReadonlyField) : model.visibleFields).map(renderFormFieldV2).join('\n'),
       TABLE_COLUMNS: model.gridFields.map((field) => renderTableColumn(field, dictRegistryRefs)).join('\n'),
       FORM_DEFAULTS: renderFormDefaults(model),
       DICT_REGISTRY_IMPORT_BLOCK: model.dictTypes.length ? "import { DictRegistry } from '/@/enums/dict-registry';" : '',
@@ -3549,21 +3570,25 @@ function buildReplacements(model, sharedSupport) {
       CHILD_OPTION_GROUPS: model.children.map((childModel) => renderChildOptionGroupV2(model, childModel, dictRegistryRefs)).join('\n'),
       FORM_RULES: renderFormRulesV2(model.visibleFields),
       CHILD_FORM_LIST_DEFAULTS: renderChildFormListDefaults(model.children),
-      CHILD_TEMP_DECLARATIONS: renderChildTempDeclarations(model.children),
-      CHILD_RESET_LISTS: renderChildResetListLines(model.children),
-      CHILD_SECTIONS: model.children.map((childModel) => renderChildSection(childModel, model.children.length)).join('\n'),
-    };
-  }
-
-function renderFiles(model, stylePreset, sharedSupport, localeZhSupport) {
-  if (!hasRuntimeSupport(stylePreset)) throw new Error('Runtime templates are not implemented for style: ' + model.style);
-  if (model.style === 'multi_level_dict') {
-    return renderMultiLevelFiles(model, sharedSupport, localeZhSupport);
-  }
+      CHILD_TEMP_DECLARATIONS: renderChildTempDeclarations(model.children),
+      CHILD_RESET_LISTS: renderChildResetListLines(model.children),
+      CHILD_SECTIONS: model.children.map((childModel) => renderChildSection(childModel, model.children.length)).join('\n'),
+      LEDGER_CHILD_SECTIONS: model.children.map((childModel) => renderLedgerChildSection(childModel)).join('\n'),
+    };
+  }
 
-  const runtime = stylePreset.runtime;
-  const templateDir = path.resolve(__dirname, runtime.templateDir);
-  const replacements = buildReplacements(model, sharedSupport);
+function renderFiles(model, stylePreset, sharedSupport, localeZhSupport) {
+  if (!hasRuntimeSupport(stylePreset)) throw new Error('Runtime templates are not implemented for style: ' + model.style);
+  if (model.style === 'multi_level_dict') {
+    return renderMultiLevelFiles(model, sharedSupport, localeZhSupport);
+  }
+
+  const runtime = stylePreset.runtime;
+  const templateDir =
+    model.pageType === 'ledger'
+      ? path.resolve(__dirname, 'assets/templates/ledger_' + model.style)
+      : path.resolve(__dirname, runtime.templateDir);
+  const replacements = buildReplacements(model, sharedSupport);
   const formTemplate = fs.readFileSync(path.join(templateDir, runtime.files.form), 'utf8');
   const listTemplate = fs.readFileSync(path.join(templateDir, runtime.files.list), 'utf8');
   const optionsTemplate = fs.readFileSync(path.join(templateDir, runtime.files.options), 'utf8');

package/package.json

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