pit-docs-mcp 1.0.2

package/docs/codegen/pit-simplify-web.md

@@ -0,0 +1,686 @@
+# 后台管理页面生成规范
+
+> **文档性质**：AI Agent 开发规范  
+> **适用场景**：在本项目中生成任意后台管理 CRUD 页面  
+
+---
+
+## 一、项目技术约定
+
+| 维度 | 约定 |
+|------|------|
+| 框架 | Vue 2 + PitElementUI（基于 ElementUI 二次封装） |
+| 核心页面组件 | `el-form-base`（统一承载查询/列表/增改删/详情） |
+| HTTP 封装 | `pit-business-utils` 的 `request` |
+| 路由 | 动态路由，无需手动注册；`this.$route.meta.modelId` 为当前菜单 ID |
+| 字典 | `pit-dic` 组件，传 `code` 属性即可，无需手动拉取 |
+| 项目 ID | 固定取 `localStorage.getItem("projectId")` |
+
+### 目录结构约定
+
+```
+src/
+ views/
+    projectLevel/
+        {moduleName}/          # 文件夹名 = 组件 name = 小驼峰
+            {moduleName}.vue   # 页面入口
+            {moduleName}Flow.vue    # 流程表单页面
+ api/
+     projectLevel/
+         {moduleName}.js        # 接口文件
+```
+
+---
+
+## 二、页面骨架模式
+
+所有标准管理页使用以下固定骨架，**不得自行发明结构**：
+
+```vue
+<template>
+  <div class="pit-common-layout">
+    <div class="pit-common-layout-center pit-flex-main">
+      <el-form-base
+        ref="peFormBase"
+        primary-key="id"
+        row-key="id"
+        query-interface="/api/{service}/{module}/page"
+        query-one-interface="/api/{service}/{module}/info"
+        save-interface="/api/{service}/{module}"
+        update-interface="/api/{service}/{module}"
+        delete-interface="/api/{service}/{module}/delete"
+        draft-interface="/api/{service}/{module}"
+        process-interface="/api/{service}/{module}/runWorkFlow"
+        :draftInterfaceMethod="operatingTypeProps === 'add' ? 'POST' : 'PUT'"
+        :hasFlow="this.$route.meta.hasFlow"
+        :flowCode="this.$route.meta.flowCode"
+        :form-inline="formInline"
+        :columns="columns"
+        :add-form="addForm"
+        :rules="rules"
+        :row-single="false"
+        :noBatchBtn="false"
+        :isDefaultQuery="false"
+        :no-add-btn="pit.hasBtnP(pit.hasCode.btn_add)"
+        :isDialogVisible.sync="isDialogVisible"
+        :operatingTypeProps.sync="operatingTypeProps"
+        >
+
+        <template slot="searchForm" slot-scope="data">
+          <!-- 查询区字段 -->
+        </template>
+
+        <template slot="add" slot-scope="data">
+          <!-- 新增/编辑字段 -->
+        </template>
+      </el-form-base>
+    </div>
+  </div>
+</template>
+
+<script>
+export default {
+  name: "{moduleName}",   // 与文件夹名保持一致
+  data() {
+    return {
+      operatingTypeProps: "add",
+      isDialogVisible: false,
+      columns: [],
+      formInline: {},
+      addForm: {},
+      rules: {},
+    };
+  },
+  methods: {},
+};
+</script>
+```
+
+---
+
+## 二（扩展）、左树右表页面骨架
+
+> 当用户描述中出现"左树"、"左侧树"、"左边树"等关键词时，**必须**使用本骨架
+
+### 结构约定
+
+```vue
+<template>
+  <div class="pit-common-layout">
+    <el-layout-column title="{左侧栏标题}">
+      <!-- 左侧树 -->
+      <div slot="left" class="h-full">
+        <el-layout-tree
+          ref="peLayoutTree"
+          query-tree-interface="/api/{service}/{treeModule}/list"
+          :queryTreeParams="queryTreeParams"
+          label="{显示字段名}"
+          nodeKey="{唯一键字段名}"
+          no-search-input
+          noFilterInput
+          :default-expand-all="true"
+          @node-click="handleNodeClick"
+          @resultBack="resultBack" />
+      </div>
+      <!-- 右侧主内容 -->
+      <div slot="right" class="h-full">
+        <el-form-base
+          ref="peFormBase"
+          primary-key="id"
+          query-interface="/api/{service}/{module}/page"
+          query-one-interface="/api/{service}/{module}/info"
+          save-interface="/api/{service}/{module}"
+          update-interface="/api/{service}/{module}"
+          delete-interface="/api/{service}/{module}/delete"
+          draft-interface="/api/{service}/{module}"
+          process-interface="/api/{service}/{module}/runWorkFlow"
+          :draftInterfaceMethod="operatingTypeProps === 'add' ? 'POST' : 'PUT'"
+          :hasFlow="this.$route.meta.hasFlow"
+          :flowCode="this.$route.meta.flowCode"
+          :form-inline="formInline"
+          :columns="columns"
+          :add-form="addForm"
+          :rules="rules"
+          :row-single="false"
+          :noBatchBtn="false"
+          :isDefaultQuery="false"
+          :no-add-btn="pit.hasBtnP(pit.hasCode.btn_add)"
+          :isDialogVisible.sync="isDialogVisible"
+          :operatingTypeProps.sync="operatingTypeProps"
+          :addBeforeCallback="addBeforeCallback">
+          <template slot="searchForm" slot-scope="data">
+            <!-- 查询区字段 -->
+          </template>
+          <template slot="add" slot-scope="data">
+            <!-- 新增/编辑字段 -->
+          </template>
+        </el-form-base>
+      </div>
+    </el-layout-column>
+  </div>
+</template>
+
+<script>
+export default {
+  name: "{moduleName}",
+  data() {
+    return {
+      operatingTypeProps: "add",
+      isDialogVisible: false,
+      // 树接口的额外参数，projectId 必传
+      queryTreeParams: {
+        projectId: localStorage.getItem("projectId"),
+      },
+      formInline: {
+        projectId: localStorage.getItem("projectId"),
+        menuId: this.$route.meta.modelId,
+        {treeNodeIdField}: "",   // 当前选中的树节点 ID
+      },
+      addForm: {
+        id: "",
+        projectId: localStorage.getItem("projectId"),
+        menuId: this.$route.meta.modelId,
+        {treeNodeIdField}: "",   // 新增时关联选中的树节点
+      },
+      columns: [],
+      rules: {},
+    };
+  },
+  methods: {
+    // 点击树节点：更新查询条件 + 触发列表查询
+    handleNodeClick(treeObj) {
+      this.formInline.{treeNodeIdField} = treeObj.{nodeKeyField};
+      this.addForm.{treeNodeIdField} = treeObj.{nodeKeyField};
+      this.$refs.peFormBase && this.$refs.peFormBase.search();
+    },
+    // 树数据加载完成：默认选中第一个节点并查询
+    resultBack(data) {
+      if (data && data.length > 0) {
+        this.formInline.{treeNodeIdField} = data[0].{nodeKeyField};
+        this.addForm.{treeNodeIdField} = data[0].{nodeKeyField};
+        this.$refs.peLayoutTree.setCurrentKey(data[0].{nodeKeyField});
+        this.$refs.peFormBase && this.$refs.peFormBase.search();
+      }
+    },
+    // 新增前校验：必须已选中树节点
+    addBeforeCallback() {
+      if (!this.formInline.{treeNodeIdField}) {
+        this.$message.warning("请先选择左侧{左侧栏标题}");
+        return false;
+      }
+    },
+  },
+};
+</script>
+```
+
+### 左树右表专项规则
+
+| # | 规则 | 说明 |
+|---|------|------|
+| 1 | `queryTreeParams` 必须包含 `projectId` | 树接口基本参数 |
+| 2 | `formInline` 和 `addForm` 必须包含树节点 ID 字段 | 关联树节点与列表/表单 |
+| 3 | `resultBack` 中调用 `setCurrentKey` + `search()` | 首次加载默认选中第一节点并查询 |
+| 4 | `handleNodeClick` 同时更新 `formInline` 和 `addForm` | 保证新增时自动带入当前节点 |
+| 5 | 注册 `addBeforeCallback` 防止未选树节点时新增 | 前置校验 |
+| 6 | 外层容器为 `pit-common-layout`，不使用 `pit-common-layout-center` | 左树布局与普通布局的区别 |
+
+---
+
+## 二（扩展2）、流程表单页面骨架（{moduleName}Flow.vue）
+
+> 当页面带有审批流程时，除主页面外还需生成对应的流程表单页面 `{moduleName}Flow.vue`
+
+### 结构约定
+
+```vue
+<template>
+  <!-- 根节点固定 style="height: 100%" -->
+  <div style="height: 100%">
+    <el-form label-width="100px" :rules="rules">
+      <!-- 多列时使用 el-row + el-col(:span="12") 布局 -->
+      <el-row>
+        <el-col :span="12" v-if="getDisplay('{fieldName}')">
+          <el-form-item label="{标签}" prop="{fieldName}">
+            <pit-input
+              v-model="formData.{fieldName}"
+              :disabled="getWrite('{fieldName}')" />
+          </el-form-item>
+        </el-col>
+        <!-- 字典下拉 -->
+        <el-col :span="12" v-if="getDisplay('{fieldName}')">
+          <el-form-item label="{标签}" prop="{fieldName}">
+            <pit-dic
+              v-model="formData.{fieldName}"
+              code="{DICT_CODE}"
+              :disabled="getWrite('{fieldName}')" />
+          </el-form-item>
+        </el-col>
+      </el-row>
+      <!-- 单独占一行的字段直接写 el-form-item，v-if 加在 el-form-item 上 -->
+      <el-form-item label="{标签}" prop="{fieldName}" v-if="getDisplay('{fieldName}')">
+        <pit-textarea
+          v-model="formData.{fieldName}"
+          :disabled="getWrite('{fieldName}')" />
+      </el-form-item>
+      <!-- 附件上传 -->
+      <div v-if="getDisplay('fileId')">
+        <pit-upload-table
+          noTitle
+          hasSlice
+          v-model="formData.fileId"
+          :disabled="getWrite('fileId')" />
+      </div>
+    </el-form>
+  </div>
+</template>
+
+<script>
+import mixinFlowCommon from "@/views/projectLevel/workFlow/workFlowForm/mixinFlowCommon";
+import { FLOW_OPERATION } from "pit-flow-ui";
+import {
+  req{Service}{Module}Info,         // 查询详情（用 businessKey 查）
+  req{Service}{Module}RunWorkFlow,   // 发起流程
+  req{Service}{Module}AdoptTask,     // 流程通过
+  req{Service}{Module}RejectTask,    // 流程驳回
+  req{Service}{Module}ManualUpdate,  // 签章
+  req{Service}{Module}WithdrawOrTermination, // 撤回
+  req{Service}{Module}Draft,         // 暂存（修改）
+} from "@/api/projectLevel/{moduleName}";
+
+export default {
+  name: "{moduleName}Flow",   // 固定命名：主模块名 + Flow
+  mixins: [mixinFlowCommon],  // 必须混入，提供 getDisplay/getWrite/setting 等
+  data() {
+    return {
+      formData: {},   // 表单数据，通过接口回填，不使用 addForm
+      rules: {
+        // 同主页面 rules，必填字段均需声明
+        {fieldName}: [{ required: true, message: "请输入{标签}", trigger: "input" }],
+      },
+    };
+  },
+  mounted() {
+    // 页面挂载后立即拉取业务数据
+    this.fetchFormData();
+  },
+  methods: {
+    // 1. 拉取业务数据（固定用 this.setting.businessKey 作为主键查询）
+    fetchFormData() {
+      req{Service}{Module}Info(this.setting.businessKey).then((res) => {
+        this.formData = res.data;
+      });
+    },
+
+    // 2. 审批操作：通过 / 驳回（固定结构，仅替换 API 函数名）
+    adoptAndRefuse(eventType, addForm) {
+      let formMethod = null;
+      if (eventType === FLOW_OPERATION.ADOPT_TASK) {
+        formMethod = req{Service}{Module}AdoptTask;
+      }
+      if (eventType === FLOW_OPERATION.REJECT_TASK) {
+        formMethod = req{Service}{Module}RejectTask;
+      }
+      return formMethod({
+        businessKey: this.setting.businessKey,
+        procInstId: this.setting.procInstId,
+        taskId: this.setting.taskId,
+        ...addForm,
+        handleId: this.setting.handleId,
+        formData: { ...this.formData },
+      });
+    },
+
+    // 3. 提交 / 重新发起（固定结构）
+    dataFormSubmit(eventType, addForm) {
+      let formMethod = null;
+      if (eventType === FLOW_OPERATION.SUBMIT) {
+        formMethod = req{Service}{Module}RunWorkFlow;
+      }
+      this.formData.bpmnKey = this.setting.bpmnKey;
+      return formMethod({ ...this.formData, ...addForm });
+    },
+
+    // 4. 手动签章回调（固定结构）
+    async manualSignCallback(fileList) {
+      return await req{Service}{Module}ManualUpdate(fileList);
+    },
+
+    // 5. 撤回（固定结构）
+    taskWithdraw(value, operationType = "withdraw") {
+      return req{Service}{Module}WithdrawOrTermination({
+        id: this.setting.businessKey,
+        procInstId: this.setting.procInstId,
+        currentNode:
+          localStorage.getItem("taskStatus") == "1"
+            ? "Start"
+            : this.upperTaskNode,
+        reason: value,
+        operationType,
+      });
+    },
+
+    // 6. 暂存（固定结构）
+    dataFormTempSave(eventType, addForm) {
+      return req{Service}{Module}Draft({ ...this.formData, ...addForm });
+    },
+  },
+};
+</script>
+```
+
+### 流程表单核心规则
+
+| # | 规则 | 说明 |
+|---|------|------|
+| 1 | 必须 `mixins: [mixinFlowCommon]` | 提供 `getDisplay`、`getWrite`、`setting`、`upperTaskNode` 等 |
+| 2 | 每个字段的显隐用 `v-if="getDisplay('字段名')"` | 流程节点权限控制，不可省略 |
+| 3 | 每个控件的只读用 `:disabled="getWrite('字段名')"` | 流程节点权限控制，不可省略 |
+| 4 | 数据存放在 `formData`，不使用 `addForm` | Flow 页独立表单数据对象 |
+| 5 | `mounted` 中调用详情接口，用 `this.setting.businessKey` 查询 | 流程引擎注入的业务主键 |
+| 6 | 6 个方法全部实现（即使部分业务不用也要保留空实现） | `mixinFlowCommon` 约定的接口契约 |
+| 7 | 组件 `name` = `{moduleName}Flow`（主模块名 + Flow） | 与文件名和路由保持一致 |
+| 8 | 多字段用 `el-row + el-col(:span="12")` 布局 | 与主页面 add 表单风格一致 |
+
+### getDisplay / getWrite 说明
+
+| 方法 | 返回 `true` 含义 | 返回 `false` 含义 |
+|------|----------------|-----------------|
+| `getDisplay(key)` | 该字段在当前节点**显示** | 该字段**隐藏** |
+| `getWrite(key)` | 该字段在当前节点**只读（disabled）** | 该字段**可编辑** |
+
+> 两者均由流程节点权限配置（`formRole`）动态控制，前端只需调用，不需手写条件判断。
+
+---
+
+## 三、组件使用规范（核心约束）
+
+### 3.1 插槽与组件的对应关系
+
+| 插槽 | 用途 | 允许使用的组件 | 禁止使用的组件 |
+|------|------|--------------|--------------|
+| `searchForm` | 查询条件区 | `el-input`、`pit-dic`、`el-date-picker` | `pit-input`、`pit-textarea`、`pit-input-number` |
+| `add` | 新增/编辑表单区 | `pit-input`、`pit-textarea`、`pit-input-number`、`pit-dic` | `el-input`（不推荐） |
+
+> **规则来源**：`pit-input` 等业务组件已内置处理 `placeholder`、`maxlength`、`filterable`、`clearable`，规范规定这类属性**不在 addForm 中显式声明**，同时这类组件不用于搜索区。
+
+### 3.2 组件速查表
+
+| 场景 | 插槽 | 组件 | 示例 |
+|------|------|------|------|
+| 文本输入（查询） | searchForm | `el-input` | `<el-input v-model="data.formInline.xxx" />` |
+| 文本输入（表单） | add | `pit-input` | `<pit-input v-model="data.addForm.xxx" />` |
+| 多行文本 | add | `pit-textarea` | `<pit-textarea v-model="data.addForm.xxx" />` |
+| 数字输入 | add | `pit-input-number` | `<pit-input-number v-model="data.addForm.xxx" />` |
+| 字典下拉（查询） | searchForm | `pit-dic` | `<pit-dic v-model="data.formInline.xxx" code="DICT_CODE" />` |
+| 字典下拉（表单） | add | `pit-dic` | `<pit-dic v-model="data.addForm.xxx" code="DICT_CODE" />` |
+
+### 3.3 详情交互（内置行为，禁止手写）
+
+`el-form-base` 已内置以下行为，**禁止覆盖或重复实现**：
+
+| 内置行为 | 触发方式 | 禁止的手写做法 |
+|---------|---------|--------------|
+| 双击行查看详情 | 双击任意行 | 手写 `@table-row-dblclick` + `tableRowDblclick` 方法 |
+| 单元格点击进详情 | 列配置 `isDetails: true` | 手写 `render` 中的 `onClick + details()` |
+
+```js
+// ✅ 正确：isDetails: true 自动渲染可点击详情链接
+{ prop: "name", label: "名称", align: "left", showOverflow: true, isDetails: true }
+
+// ❌ 错误：手写 render 实现相同效果
+{
+  prop: "name",
+  label: "名称",
+  render: (params) => (
+    <span class="pit-table-link" onClick={() => this.$refs.peFormBase.details(params["id"])}>
+      {params.name}
+    </span>
+  ),
+}
+```
+
+### 3.4 操作列（固定写法）
+
+```js
+{
+  prop: "column_operation",
+  label: "操作",
+  align: this.TABLE_SIZE.OPERATION_TWO_ALIGN,   // 2个按钮用 TWO，3个用 THREE
+  width: this.TABLE_SIZE.OPERATION_TWO_WIDTH,
+  render: (params) => (
+    <pit-table-operation
+      hasEdit={this.pit.hasFlow(
+        params,
+        this.$route.meta.hasFlow,
+        this.pit.hasCode.btn_edit,
+      )}
+      hasDel={this.pit.hasFlow(
+        params,
+        this.$route.meta.hasFlow,
+        this.pit.hasCode.btn_remove,
+      )}
+      onedit={() => this.$refs.peFormBase.info(params["id"])}
+      ondel={() => this.$refs.peFormBase.delete(params["id"])}
+    />
+  ),
+},
+```
+
+### 3.5 特殊回调使用边界
+
+以下回调**仅在有明确业务需要时才注册**，常规页面不需要：
+
+| 回调 prop | 触发时机 | 适用场景示例 |
+|-----------|---------|------------|
+| `addParamControllerCallback` | 表单提交前 | 动态重组提交字段（如合并多个字段为一个） |
+| `infoControllerCallback` | 详情数据回填后 | 需要二次处理回填数据（如日期格式转换） |
+| `addBeforeCallback` | 点击新增按钮前 | 前置条件校验（如必须先选左侧树节点） |
+
+> **常规处理方式**：`projectId` 在 `formInline`/`addForm` 初始值中直接赋值，无需通过回调注入。
+
+---
+
+## 四、数据准备规范
+
+### 4.1 字段命名（SQL  前端）
+
+SQL 字段（snake_case）统一转换为前端字段（camelCase）：
+
+| SQL 字段 | 前端字段 |
+|---------|---------|
+| `plan_name` | `planName` |
+| `project_id` | `projectId` |
+| `created_date` | `createdDate` |
+
+### 4.2 formInline 固定字段
+
+```js
+formInline: {
+  projectId: localStorage.getItem("projectId"),  // 必须
+  menuId: this.$route.meta.modelId,              // 必须
+  // 其他查询字段...
+}
+```
+
+### 4.3 addForm 固定字段
+
+```js
+addForm: {
+  id: "",                                        // 必须，用于编辑回填
+  projectId: localStorage.getItem("projectId"), // 必须
+  menuId: this.$route.meta.modelId,              // 必须
+  // 其他业务字段，初始值 string 用 ""，number 用 null...
+}
+```
+
+### 4.4 rules 校验规则约定
+
+| 字段类型 | trigger | 示例 |
+|---------|---------|------|
+| 文本输入（必填） | `"input"` | `{ required: true, message: "请输入xxx", trigger: "input" }` |
+| 下拉/字典（必选） | `"change"` | `{ required: true, message: "请选择xxx", trigger: "change" }` |
+
+---
+
+## 五、API 文件规范
+
+### 5.1 文件位置
+
+`src/api/projectLevel/{moduleName}.js`
+
+### 5.2 函数命名规则
+
+```
+req{服务名PascalCase}{模块名PascalCase}{操作}
+```
+
+| 操作 | 方法 | URL 模式 |
+|------|------|---------|
+| 分页查询 | GET | `/api/{service}/{module}/page` |
+| 单条查询 | GET | `/api/{service}/{module}/info` |
+| 新增 | POST | `/api/{service}/{module}` |
+| 更新 | POST | `/api/{service}/{module}` |
+| 删除 | POST | `/api/{service}/{module}/delete` |
+| 发起流程 | POST | `/api/{service}/{module}/runWorkFlow` |
+| 流程通过 | POST | `/api/{service}/{module}/adoptTask` |
+| 流程驳回 | POST | `/api/{service}/{module}/rejectTask` |
+| 签章 | POST | `/api/{service}/{module}/manualUpdate` |
+| 流程撤回 | POST | `/api/{service}/{module}/withdrawOrTermination` |
+| 暂存（修改） | PUT | `/api/{service}/{module}` |
+
+### 5.3 API 文件内容文件
+
+api不需要参考本地项目，可直接使用以下的内容模版进行生成
+
+```js
+import { request } from "pit-business-utils";
+
+// 分页查询
+export function req{Service}{Module}Page(params) {
+  return request({ url: "/api/{service}/{module}/page", method: "GET", params });
+}
+
+// 单条查询
+export function req{Service}{Module}Info(params) {
+  return request({ url: "/api/{service}/{module}/info", method: "GET", params });
+}
+
+// 新增
+export function req{Service}{Module}Save(data) {
+  return request({ url: "/api/{service}/{module}", method: "POST", data });
+}
+
+// 更新
+export function req{Service}{Module}Update(data) {
+  return request({ url: "/api/{service}/{module}", method: "POST", data });
+}
+
+// 删除
+export function req{Service}{Module}Delete(data) {
+  return request({ url: "/api/{service}/{module}/delete", method: "POST", data });
+}
+
+// 发起流程
+export function req{Service}{Module}RunWorkFlow(data) {
+  return request({ url: "/api/{service}/{module}/runWorkFlow", method: "POST", data });
+}
+
+// 流程通过
+export function req{Service}{Module}AdoptTask(data) {
+  return request({ url: "/api/{service}/{module}/adoptTask", method: "POST", data });
+}
+
+// 流程驳回
+export function req{Service}{Module}RejectTask(data) {
+  return request({ url: "/api/{service}/{module}/rejectTask", method: "POST", data });
+}
+
+// 签章
+export function req{Service}{Module}ManualUpdate(data) {
+  return request({ url: "/api/{service}/{module}/manualUpdate", method: "POST", data });
+}
+
+// 流程撤回
+export function req{Service}{Module}WithdrawOrTermination(data) {
+  return request({ url: "/api/{service}/{module}/withdrawOrTermination", method: "POST", data });
+}
+
+// 暂存 修改接口
+export function req{Service}{Module}Draft(data) {
+  return request({ url: "/api/{service}/{module}", method: "PUT", data });
+}
+```
+
+> **注意**：`el-form-base` 在 `save-interface`/`update-interface` 属性中直接配置接口 URL，API 文件主要供页面外部（如父组件、其他模块）复用调用。
+
+---
+
+## 六、完整生成流程（Agent SOP）
+
+```
+输入：表结构 SQL + 服务名 + 模块名 + 字典字段信息
+          
+1. 解析 SQL  整理字段列表（名称、类型、是否必填、是否字典）
+          
+2. 生成 API 文件
+   src/api/projectLevel/{moduleName}.js
+          
+3. 生成页面文件
+   src/views/projectLevel/{moduleName}/{moduleName}.vue
+    formInline：查询字段 + projectId + menuId
+    addForm：业务字段 + id + projectId
+    rules：必填/长度/类型校验
+    columns：列表列（主字段加 isDetails:true，末尾加操作列）
+    searchForm slot：el-input / pit-dic
+    add slot：pit-input / pit-textarea / pit-input-number / pit-dic
+          
+4. 执行自检（get_errors 工具）确认无语法错误
+          
+输出：可运行的完整页面 + API 文件
+```
+
+---
+
+## 七、反模式速查（禁止事项）
+
+| # | 禁止行为 | 正确做法 |
+|---|---------|---------|
+| 1 | 手写 `@table-row-dblclick` 双击事件 | 内置，无需处理 |
+| 2 | 详情列手写 `render` 链接 | 列配置 `isDetails: true` |
+| 3 | `searchForm` 中使用 `pit-input` | 改用 `el-input` |
+| 4 | `addForm` 中手动写 `placeholder`/`maxlength`/`clearable` | 业务组件已内置，不写 |
+| 5 | 手动拉取字典数据再渲染 `el-select` | 直接用 `pit-dic` + `code` 属性 |
+| 6 | 无需要时注册 `addParamControllerCallback` | 仅特殊场景使用 |
+| 7 | 在 `el-form-base` 外自建弹窗/表单 | 使用内置 `add` 插槽 |
+| 8 | 在`rules`中添加必填校验 | `input`类型不需要进行长度校验，`pit-input` |
+| 9 | 如果有说明是树形表格，则row-key需要配置为主键id，否则不需要添加该属性 | - |
+| 10 | 如果表单控件多，弹窗类型为`dialog-header`，否则不需要添加该属性 | - |
+| 11 | 表单控件多，大于等于8个，则使用el-row/el-col进行布局 | - |
+| 12 | 在 `searchForm`/`add` 插槽、`formInline`、`addForm`、`columns` 中为 `approvalStatus`（流程状态）生成对应组件或字段 | 流程状态已内置到框架，完全不需要在页面中声明，包括查询区、表单区、列表列、`formInline`、`addForm` 均不添加该字段 |
+
+---
+
+## 八、验收基准
+
+生成页面后必须通过以下检查：
+
+**静态检查**
+- [ ] `get_errors` 工具无报错
+- [ ] 组件 `name` 与文件夹名一致
+- [ ] `formInline` 包含 `projectId` 和 `menuId`
+- [ ] `addForm` 包含 `id` 和 `projectId`
+- [ ] 操作列使用 `pit-table-operation`
+
+**运行时检查**
+- [ ] 页面加载后自动触发查询
+- [ ] 查询条件生效
+- [ ] 字典下拉正常加载
+- [ ] 主名称列可点击进入详情
+- [ ] 双击行可进入详情
+- [ ] 新增/编辑表单校验生效
+- [ ] 保存成功后列表刷新
+- [ ] 删除确认后数据移除并刷新
+
+---
+