@alanwang-merit/meritdata-platform-skill-package 1.0.9 → 1.0.11

package/skills/meritdata-platform-entities/references/entity-catalog.md

@@ -0,0 +1,194 @@
+# 平台实体索引（Entity Catalog）
+
+> ⚠️ **重要提示**：本目录**不**包含平台实体 Java 源码（已迁移至 `.bak-entities/` 备份目录，仅供查阅）。
+>
+> **正确使用方式**：
+> 1. 通过 Maven 依赖 `cloud-module-base` 引入实体（`com.meritdata.cloud.base.entity.*`）
+> 2. 在二开代码中 `import com.meritdata.cloud.base.entity.XxxEntity;` 直接使用
+> 3. **禁止**复制本目录的历史 .java 源码到二开项目（违反 `.claude/rules/data-boundary-rules.md`）
+
+---
+
+## 一、基类（3 个）
+
+| 类名 | 父类 | 表 | 包路径 | 说明 |
+|------|------|------|--------|------|
+| `BaseEntity` | — | （基类，无表） | `com.meritdata.cloud.base.entity` | 平台实体根类 |
+| `CloudBaseEntity` | `BaseEntity` | （基类，无表） | `com.meritdata.cloud.base.entity` | **二开继承的实体基类**（自带 createTime/updateTime/creatorId/reviserId）|
+| `CloudEntity` | — | （基类，无表） | `com.meritdata.cloud.base.entity` | 另一基类（具体差异按需查源码）|
+
+## 二、核心实体（按业务域）
+
+### 2.1 组织/人员/角色
+
+| 类名 | 表 | 父类 | 业务域 | 关键说明 |
+|------|------|------|------|------|
+| `Organization` | `PF_ORG_DEPARTMENT` | `CloudBaseEntity` | 组织/部门 | 部门树 |
+| `Emp` | `PF_ORG_USER` | `CloudBaseEntity` | 人员 | 主人员表（含 A-Z 自定义字段）|
+| `DelEmp` | `PF_DEL_USER_INFO` | `CloudBaseEntity` | 已删人员 | 软删人员归档 |
+| `User` | `PF_USER_INFO` | `CloudBaseEntity` | 用户 | 系统登录账号 |
+| `UserPassHistory` | `PF_USER_PASS_HISTORY` | `CloudBaseEntity` | 用户密码历史 | 密码变更记录 |
+| `UserWorkGroup` | `PF_ORG_USER_WORKGROUP` | `BaseEntity` | 用户-工作组关联 | |
+| `Role` | `PF_ORG_ROLE` | `CloudBaseEntity` | 角色 | 系统角色定义 |
+| `OrgUserDept` | `PF_ORG_USER_DEPARTMENT` | — | 人员-部门关联 | |
+| `OrgUserRole` | `PF_ORG_USER_ROLE` | `BaseEntity` | 人员-角色关联 | |
+| `WorkGroup` | `PF_ORG_WORKGROUP` | `BaseEntity` | 工作组 | |
+| `Category` | `PF_ORG_CATEGORY` | `BaseEntity` | 人员分类 | |
+| `Lookup` | `PF_LOOKUP` | — | 数据字典 | 字典项（含 lookupType）|
+| `EmpData` | `PF_EMP_DATA` | — | 人员扩展数据 | |
+| `EmpResource` | `PF_EMP_RESOURCE` | — | 人员资源关联 | |
+
+### 2.2 资源/菜单
+
+| 类名 | 表 | 父类 | 业务域 | 关键说明 |
+|------|------|------|------|------|
+| `Resource` | `PF_RESOURCE` | — | 资源/菜单 | 菜单树 |
+| `ResExternal` | `PF_RESOURCE_EXTERNAL` | `CloudBaseEntity` | 外部资源 | 第三方应用资源 |
+| `ResExternalInfo` | — | — | 外部资源信息 | 非实体 |
+| `ResourceData` | `PF_RESOURCE_DATA` | — | 资源数据 | |
+| `Assign` | `PF_RESOURCE_ASSIGN` | — | 资源授权 | 角色-资源/用户-资源绑定 |
+| `SubResourceAssign` | `PF_RESOURCE_SUB_MANAGE` | — | 子资源授权 | |
+
+### 2.3 租户/产品/数据源
+
+| 类名 | 表 | 父类 | 业务域 | 关键说明 |
+|------|------|------|------|------|
+| `Tenancy` | `PF_TENANCY` | — | 租户 | 平台多租户 |
+| `CloudProduct` | — | — | 产品 | 产品授权（无表注解）|
+| `CloudProductModule` | — | — | 产品模块 | 产品-模块映射（无表注解）|
+| `DataSourceModel` | `PF_TEMPO_DATASOURCE` | — | 数据源 | Tempo 动态数据源 |
+| `SubData` | `PF_TEMPO_SUBDATA_ROLE` | `CloudBaseEntity` | 子数据源 | Tempo 子数据 |
+| `SubDataSourcePrivilege` | `PF_TEMPO_SUBSOURCE_PRIVILEGE` | — | 子数据源权限 | |
+
+### 2.4 工作台/主题/日志
+
+| 类名 | 表 | 父类 | 业务域 | 关键说明 |
+|------|------|------|------|------|
+| `WorkBench` | `PF_US_WORKBENCH` | `CloudBaseEntity` | 工作台 | 用户工作台 |
+| `WorkBenchAuth` | `PF_US_WORKBENCH_AUTH` | `CloudBaseEntity` | 工作台授权 | |
+| `WorkBenchMenu` | `PF_US_WORKBENCH_MENU` | `CloudBaseEntity` | 工作台菜单 | |
+| `Theme` | `PF_THEME` | `CloudBaseEntity` | 主题 | 平台主题 |
+| `Log` | `PF_LOG` | `CloudBaseEntity` | 日志 | 操作日志 |
+| `CloudSchemaHistory` | `PF_SCHEMA_HISTORY` | — | 模式变更历史 | |
+
+### 2.5 任务（辅助 DTO，非表实体）
+
+| 类名 | 表 | 父类 | 业务域 | 关键说明 |
+|------|------|------|------|------|
+| `TaskResult` | — | — | 异步任务结果 | |
+| `TaskVO` | — | — | 任务视图对象 | |
+
+---
+
+## 三、QueryDSL Q 类（31 个，全部继承 `EntityPathBase`）
+
+| Q 类 | 对应实体 | 触发场景 |
+|------|---------|---------|
+| `QAssign` | `Assign` | QueryDSL 资源授权查询 |
+| `QBaseEntity` | `BaseEntity` | 基类 Q |
+| `QCategory` | `Category` | QueryDSL 人员分类查询 |
+| `QCloudBaseEntity` | `CloudBaseEntity` | **二开继承的基类 Q** |
+| `QCloudEntity` | `CloudEntity` | 基类 Q |
+| `QCloudSchemaHistory` | `CloudSchemaHistory` | QueryDSL 模式历史 |
+| `QDataSourceModel` | `DataSourceModel` | QueryDSL 数据源查询 |
+| `QDelEmp` | `DelEmp` | QueryDSL 已删人员查询 |
+| `QEmp` | `Emp` | **QueryDSL 人员查询（高频）** |
+| `QEmpData` | `EmpData` | QueryDSL 人员扩展数据 |
+| `QEmpResource` | `EmpResource` | QueryDSL 人员资源 |
+| `QLog` | `Log` | QueryDSL 日志查询 |
+| `QLookup` | `Lookup` | QueryDSL 字典查询 |
+| `QOrgUserDept` | `OrgUserDept` | QueryDSL 人员部门 |
+| `QOrgUserRole` | `OrgUserRole` | QueryDSL 人员角色 |
+| `QOrganization` | `Organization` | **QueryDSL 组织查询（高频）** |
+| `QResExternal` | `ResExternal` | QueryDSL 外部资源 |
+| `QResource` | `Resource` | **QueryDSL 资源/菜单查询（高频）** |
+| `QResourceData` | `ResourceData` | QueryDSL 资源数据 |
+| `QRole` | `Role` | **QueryDSL 角色查询（高频）** |
+| `QSubData` | `SubData` | QueryDSL 子数据源 |
+| `QSubDataSourcePrivilege` | `SubDataSourcePrivilege` | QueryDSL 子数据源权限 |
+| `QSubResourceAssign` | `SubResourceAssign` | QueryDSL 子资源授权 |
+| `QTenancy` | `Tenancy` | QueryDSL 租户 |
+| `QTheme` | `Theme` | QueryDSL 主题 |
+| `QUser` | `User` | **QueryDSL 用户查询（高频）** |
+| `QUserPassHistory` | `UserPassHistory` | QueryDSL 密码历史 |
+| `QUserWorkGroup` | `UserWorkGroup` | QueryDSL 用户工作组 |
+| `QWorkBench` | `WorkBench` | QueryDSL 工作台 |
+| `QWorkBenchAuth` | `WorkBenchAuth` | QueryDSL 工作台授权 |
+| `QWorkBenchMenu` | `WorkBenchMenu` | QueryDSL 工作台菜单 |
+| `QWorkGroup` | `WorkGroup` | QueryDSL 工作组 |
+
+---
+
+## 四、二开继承基类的标准做法
+
+```java
+package com.meritdata.cloud.contract.entity;
+
+import com.meritdata.cloud.base.entity.CloudBaseEntity;
+import lombok.Data;
+import org.hibernate.annotations.GenericGenerator;
+
+import jakarta.persistence.Column;
+import jakarta.persistence.Entity;
+import jakarta.persistence.GeneratedValue;
+import jakarta.persistence.Id;
+import jakarta.persistence.Table;
+
+/**
+ * 样例：二开业务实体继承 CloudBaseEntity
+ * 继承后自动获得：createTime/updateTime/creatorId/reviserId
+ */
+@Entity
+@Table(name = "T_CONTRACT")  // ⚠️ 注意大写（sql-naming 规范）
+@GenericGenerator(name = "jpa-uuid", strategy = "uuid")
+@Data
+public class Contract extends CloudBaseEntity {
+    @Id
+    @GeneratedValue(generator = "jpa-uuid")
+    @Column(name = "ID", length = 32)
+    private String id;
+
+    @Column(name = "NAME", length = 100)
+    private String name;
+    // ... 其他业务字段
+}
+```
+
+---
+
+## 五、二开常见错误（对照 data-boundary 铁律）
+
+| 错误做法 | 后果 | 正确做法 |
+|---------|------|---------|
+| ❌ 复制本目录 .java 到二开项目源码 | 平台升级时全部 break，违反数据边界铁律 | ✅ 通过 Maven 依赖引入 `cloud-module-base` |
+| ❌ 二开项目直连平台表（`PF_*`）| 数据库权限/事务边界混乱 | ✅ 二开业务表与平台表分离 |
+| ❌ 业务表与平台表跨库 JOIN | 跨库失败 | ✅ 应用层内存 join |
+| ❌ 在事务中调用 Feign 装配平台数据 | 锁等待 + 性能问题 | ✅ 批量装配 + 应用层 join |
+
+---
+
+## 六、文件清单（备份位置）
+
+完整 Java 源码备份在同目录 `.bak-entities/` 子目录（69 文件），仅供查阅字段细节。
+
+**结构**：
+```
+references/
+├── entity-catalog.md      ← 本文件（索引）
+└── .bak-entities/         ← 备份（仅供查阅，不作为开发引用）
+    ├── CloudBaseEntity.java
+    ├── BaseEntity.java
+    ├── Emp.java
+    ├── ...
+    └── Q*系列（31 个 QueryDSL Q 类）.java
+```
+
+---
+
+## 七、相关 Skill
+
+| Skill | 用途 |
+|-------|------|
+| `meritdata-platform-cloud-dev` | 加新模块 / 生成业务代码 |
+| `meritdata-platform-integration` | 跨 JVM Feign 装配（外部接口）|
+| `.claude/rules/data-boundary-rules.md` | 数据边界铁律 |

package/skills/meritdata-platform-frontend/SKILL.md

@@ -1,45 +1,80 @@
 ---
 name: meritdata-platform-frontend
-description: |
-  前端组件与工程。平台提供的 Vue/React 组件（人员弹框/部门树/字典下拉/资源选择）；前端工程结构、构建、路由、权限点接入、API 调用约定。
-  触发场景：新二开前端模块启动；引入平台 UI 组件；前端打包/部署。
-  何时不用：纯后端代码 → 用 code-spec；接口设计 → 用 rules/api-design-rules.md。
+description: 平台 Vue 2 页面、cloud-module-base 组件、BaseApi 请求和 Vue CLI/Webpack 代理。用于多页面路由与访问地址、Element UI 表单、CloudDialog/人员部门角色选择、页面工具模块、业务接口路径及网关代理配置。
 metadata:
   version: "1.0.0"
-  author: petroleum+rd
-  source: petroleum+rd
-  date_added: "2026-09-07"
-  last_modified: "2026-09-08"
+  author: 技术平台部门架构组
+  source: company
+  date_added: "2026-09-01"
+  last_updated: "2026-09-01"
   risk: low
-  layer: L2
-  sub-layer: L2-F
-  stack: frontend
-allowed-tools: Read, Grep, Glob, Bash
+  allowed-tools: Read, Grep, Glob
 ---
 
-# 前端组件与工程（frontend）
-
-## 触发
-- 新二开前端模块冷启动
-- 需要平台 UI 组件（人员弹框/部门树/字典下拉/资源树）
-- 前端权限点接入（按钮级/菜单级）
-- 前端 API 调用规范
-- **前端多服务 HTTP 客户端**（业务 + 人员 + BPM + 附件跨 service 调用）🆕 v2.6.0
-
-## 不触发
-- 纯后端代码 → 用 `meritdata-platform-code-spec`
-- REST API 设计 → 用 `rules/api-design-rules.md`
-- 前端部署/Docker → L3 部署（待建）
-- 对外 WebApi（外部系统调平台）→ 用 `meritdata-platform-data-access/references/outbound/webapi.md`
-
-## 前置约束
-- URL 必须遵守 [rules/api-design-rules.md](../../rules/api-design-rules.md)（复数/小写/连字符）
-- 响应包装 `{ code, data, message }`
-- 组件按需引入，不全量打包
-- **HTTP 客户端必须用平台 plugin**（`@cloud-module-base/httpConfig/http-plugin`），禁止自建 axios / `Axios.defaults.headers.*`（v2.6.0 新增）
-
-## 路由
-- 平台组件清单 + props → [references/components.md](references/components.md)
-- 工程结构 + 路由约定 → [references/project-structure.md](references/project-structure.md)
-- 权限点接入 + API 调用 → [references/auth-and-api.md](references/auth-and-api.md)
-- **前端多服务 HTTP 客户端**（registry / plugin / 路径 / 验收）🆕 → [references/http-client/INDEX.md](references/http-client/INDEX.md)
+## ⭐ MUST DO
+
+**默认按平台形态生成或修改：Vue CLI 多页面工程、Vue 2、Element UI、cloud-module-base，不默认创建 Vite/Vue 3 项目。**
+
+## 触发条件 / 不适用
+
+**适用**：
+- Vue 2 + Element UI + `cloud-module-base` 页面开发
+- `CloudDialog` / `UserSelect` / `DeptSelect` / `RoleSelect` 等业务组件
+- 网关代理配置
+- 页面访问地址
+
+**不适用**：
+- 后端 API → `meritdata-platform-integration`
+- Vue 3 / Vite 项目（不兼容）
+
+## 主题路由
+
+| 任务 | 优先读取 |
+| --- | --- |
+| Vue CLI 多页面工程、页面路由与访问地址 | 本文件"标准前端工程规则" |
+| BaseApi 业务请求、Vue CLI/Webpack 网关代理 | 本文件"前后端联调规则" |
+| CloudDialog、UserSelect、UserSelectMulti、DeptSelect、RoleSelect、ImportButton、MenuAuth、ResourceCodeAuth、ThreeMemberAuth、TableHeadSearch、VerifiyPassword、CommonHeader | [`references/components.md`](references/components.md) |
+| 日期、表单校验、防重复点击和访问审计工具 | [`references/utils.md`](references/utils.md) |
+
+## 工作方式（Step 1/2/3/4）
+
+### Step 1：确认目标工程形态
+
+- 美林开发平台前端优先按平台默认形态生成或修改
+- 不要默认创建 Vite/Vue 3 项目
+- 标准技术栈：Vue CLI 4、Vue 2、Vue Router 3、Vuex 3、Element UI、`cloud-module-base`
+
+### Step 2：读取 reference
+
+按主题路由读取 components.md 和 utils.md。
+
+### Step 3：标准前端工程规则
+
+- `vue.config.js` 中的 `outputDir` 是前端部署包名，记为 `{frontPackage}`
+- `vue.config.js` 中的 `pages` 定义多页面入口；每个 page 的 `filename` 决定页面 HTML 路径，记为 `{pageFilename}`
+- 页面访问地址：`/{frontPackage}/{pageFilename}#/{routePath}`
+- `{routePath}` 来自 Vue Router 配置
+
+### Step 4：前后端联调
+
+- 前端默认经网关访问业务服务
+- 路径拆成五段：`gatewayOrigin` / `gatewayPrefix` / `serviceName` / `contextPath` / `controllerPath`
+- 完整路径：`{gatewayOrigin}{gatewayPrefix}/{serviceName}{contextPath}{controllerPath}`
+- 代理的 `target` 仅为 `gatewayOrigin`，请求保留 `gatewayPrefix`
+
+## 🚨 常见错误
+
+| 错误 | 后果 | 正确做法 |
+| --- | --- | --- |
+| 默认创建 Vite/Vue 3 项目 | 与平台不一致 | 强制 Vue CLI + Vue 2 |
+| 直连服务端口 | 绕过网关 | 经 gatewayProxy |
+| 凭据写在示例 | 安全风险 | 占位符 + 配置中心 |
+| 不核对 gatewayPrefix 重复 | 请求失败 | 五段路径逐一核验 |
+
+## 边界
+
+- **不在本 skill 范围的**：
+  - 后端代码 → `meritdata-platform-cloud-dev`
+  - 开放接口 → `meritdata-platform-integration`
+  - BPM 组件 → `meritdata-platform-bpm`
+- **强制要求**：使用 Vue 2.6 + Element UI + cloud-module-base

package/skills/meritdata-platform-frontend/agents/openai.yaml

@@ -0,0 +1,31 @@
+display_name: "MeritData 平台前端"
+short_description: "Vue 2 + Element UI + cloud-module-base 平台前端工程"
+default_prompt: |
+  meritdata-platform-frontend 处理 MeritData 平台前端工程。
+
+  适用场景：
+  - Vue 2.6 + Element UI 页面开发
+  - Vue CLI 多页面工程（outputDir / pages / filename）
+  - cloud-module-base 业务组件（CloudDialog/UserSelect/DeptSelect/RoleSelect/ImportButton）
+  - BaseApi 网关代理（五段路径）
+
+  使用方式：
+  ```
+  meritdata-platform-frontend <前端需求>
+  ```
+
+  工作方式：
+  1. 确认目标项目为 Vue CLI + Vue 2 工程
+  2. 识别页面访问地址 = /{frontPackage}/{pageFilename}#/{routePath}
+  3. 按主题路由读取 references/ 中的 components.md 和 utils.md
+  4. 联调时按五段路径（gatewayOrigin/gatewayPrefix/serviceName/contextPath/controllerPath）拼接
+  5. 沿用现有 import、props、events、i18n、异常处理风格
+
+  2 个 references：
+  - components.md（CloudDialog/UserSelect 等 12 个组件）
+  - utils.md（日期/校验/防重复点击/审计）
+
+  强制约束：
+  - 不默认创建 Vite/Vue 3 项目
+  - 凭据必须通过配置中心
+  - 沿用项目现有 Vue 版本、组件注册方式、vue.config.js

package/skills/meritdata-platform-frontend/examples/user-list-page/README.md

@@ -0,0 +1,331 @@
+# Frontend 示例：用户列表页面
+
+## 场景
+
+基于 Vue 2 + Element UI + cloud-module-base 实现用户列表页面。
+
+## 用户输入
+
+```text
+$meritdata-platform-frontend 做一个人事管理页面，包含列表、新增、编辑、删除、人员选择器
+```
+
+## 完整页面结构
+
+```
+src/pages/user-list/
+├── main.js               ← 入口
+├── App.vue               ← 根组件
+├── router.js             ← 路由
+├── store/                ← Vuex
+│   ├── index.js
+│   └── modules/user.js
+├── views/
+│   ├── UserList.vue      ← 列表页
+│   └── UserEditDialog.vue ← 编辑对话框
+├── api/
+│   └── user.js           ← BaseApi 封装
+├── components/
+│   └── UserSearchForm.vue
+└── i18n.js               ← 国际化
+```
+
+## 完整代码示例
+
+### 1. main.js（页面入口）
+
+```javascript
+import Vue from 'vue'
+import App from './App.vue'
+import router from './router'
+import store from './store'
+import i18n from './i18n'
+
+Vue.config.productionTip = false
+
+new Vue({
+  router,
+  store,
+  i18n,
+  render: h => h(App)
+}).$mount('#app')
+```
+
+### 2. router.js（页面路由）
+
+```javascript
+import Vue from 'vue'
+import VueRouter from 'vue-router'
+import UserList from './views/UserList.vue'
+
+Vue.use(VueRouter)
+
+const routes = [
+  { path: '/index', component: UserList }
+]
+
+export default new VueRouter({
+  mode: 'hash',
+  routes
+})
+```
+
+### 3. api/user.js（BaseApi 封装）
+
+```javascript
+import BaseApi from '@/http-config/http'
+
+export function listUsers(params) {
+  return BaseApi.get('/meritdata-platform-user{contextPath}/api/users', params)
+}
+
+export function createUser(data) {
+  return BaseApi.post('/meritdata-platform-user{contextPath}/api/users', data)
+}
+
+export function updateUser(id, data) {
+  return BaseApi.put(`/meritdata-platform-user{contextPath}/api/users/${id}`, data)
+}
+
+export function deleteUser(id) {
+  return BaseApi.delete(`/meritdata-platform-user{contextPath}/api/users/${id}`)
+}
+```
+
+### 4. views/UserList.vue（列表页）
+
+```vue
+<template>
+  <div class="user-list">
+    <UserSearchForm v-model="searchParams" @search="handleSearch" />
+
+    <el-button type="primary" @click="handleCreate">
+      <i class="el-icon-plus"></i> 新增用户
+    </el-button>
+
+    <el-table :data="users" v-loading="loading" border>
+      <el-table-column prop="name" label="姓名" />
+      <el-table-column prop="deptName" label="部门">
+        <template slot-scope="scope">
+          <DeptSelect :value="scope.row.deptId" readonly />
+        </template>
+      </el-table-column>
+      <el-table-column prop="roleNames" label="角色">
+        <template slot-scope="scope">
+          <RoleSelect :value="scope.row.roleIds" :multiple="true" readonly />
+        </template>
+      </el-table-column>
+      <el-table-column label="操作">
+        <template slot-scope="scope">
+          <el-button @click="handleEdit(scope.row)">编辑</el-button>
+          <el-button type="danger" @click="handleDelete(scope.row)">删除</el-button>
+        </template>
+      </el-table-column>
+    </el-table>
+
+    <el-pagination
+      :current-page.sync="pagination.page"
+      :page-size.sync="pagination.size"
+      :total="pagination.total"
+      @current-change="loadUsers" />
+
+    <UserEditDialog
+      v-if="dialogVisible"
+      :user="editingUser"
+      :visible.sync="dialogVisible"
+      @saved="handleSaved" />
+  </div>
+</template>
+
+<script>
+import { listUsers, createUser, updateUser, deleteUser } from '../api/user'
+import UserSearchForm from '../components/UserSearchForm.vue'
+import UserEditDialog from './UserEditDialog.vue'
+
+export default {
+  components: { UserSearchForm, UserEditDialog },
+
+  data() {
+    return {
+      searchParams: {},
+      users: [],
+      loading: false,
+      pagination: { page: 1, size: 20, total: 0 },
+      dialogVisible: false,
+      editingUser: null
+    }
+  },
+
+  mounted() {
+    this.loadUsers()
+  },
+
+  methods: {
+    async loadUsers() {
+      this.loading = true
+      try {
+        const result = await listUsers({
+          ...this.searchParams,
+          page: this.pagination.page,
+          size: this.pagination.size
+        })
+        if (result.code === 200) {
+          this.users = result.data.records
+          this.pagination.total = result.data.total
+        }
+      } finally {
+        this.loading = false
+      }
+    },
+
+    handleSearch() {
+      this.pagination.page = 1
+      this.loadUsers()
+    },
+
+    handleCreate() {
+      this.editingUser = null
+      this.dialogVisible = true
+    },
+
+    handleEdit(user) {
+      this.editingUser = user
+      this.dialogVisible = true
+    },
+
+    async handleDelete(user) {
+      await this.$confirm('确定删除吗？', '提示')
+      const result = await deleteUser(user.id)
+      if (result.code === 200) {
+        this.$message.success('删除成功')
+        this.loadUsers()
+      }
+    },
+
+    handleSaved() {
+      this.dialogVisible = false
+      this.loadUsers()
+    }
+  }
+}
+</script>
+```
+
+### 5. views/UserEditDialog.vue（编辑对话框）
+
+```vue
+<template>
+  <CloudDialog
+    :title="user ? '编辑用户' : '新增用户'"
+    :visible.sync="visible"
+    @confirm="handleSubmit">
+
+    <el-form :model="form" :rules="rules" ref="form" label-width="100px">
+      <el-form-item label="姓名" prop="name">
+        <el-input v-model="form.name" />
+      </el-form-item>
+
+      <el-form-item label="部门" prop="deptId">
+        <DeptSelect v-model="form.deptId" />
+      </el-form-item>
+
+      <el-form-item label="角色" prop="roleIds">
+        <RoleSelect v-model="form.roleIds" :multiple="true" />
+      </el-form-item>
+
+      <el-form-item label="负责人" prop="managerId">
+        <UserSelect v-model="form.managerId" />
+      </el-form-item>
+
+      <el-form-item label="备注">
+        <el-input v-model="form.remark" type="textarea" :rows="3" />
+      </el-form-item>
+    </el-form>
+  </CloudDialog>
+</template>
+
+<script>
+import { createUser, updateUser } from '../api/user'
+
+export default {
+  props: ['user', 'visible'],
+
+  data() {
+    return {
+      form: {
+        name: '',
+        deptId: null,
+        roleIds: [],
+        managerId: null,
+        remark: ''
+      },
+      rules: {
+        name: [{ required: true, message: '请输入姓名' }],
+        deptId: [{ required: true, message: '请选择部门' }],
+        roleIds: [{ required: true, type: 'array', min: 1, message: '请选择角色' }]
+      }
+    }
+  },
+
+  watch: {
+    user(val) {
+      if (val) {
+        this.form = { ...val }
+      } else {
+        this.form = {
+          name: '',
+          deptId: null,
+          roleIds: [],
+          managerId: null,
+          remark: ''
+        }
+      }
+    },
+
+    visible(val) {
+      this.$emit('update:visible', val)
+    }
+  },
+
+  methods: {
+    async handleSubmit() {
+      await this.$refs.form.validate()
+
+      const action = this.user ? updateUser : createUser
+      const args = this.user ? [this.user.id, this.form] : [this.form]
+
+      const result = await action(...args)
+      if (result.code === 200) {
+        this.$message.success(this.user ? '更新成功' : '创建成功')
+        this.$emit('saved')
+      } else {
+        this.$message.error(result.message)
+      }
+    }
+  }
+}
+</script>
+```
+
+## 关键决策
+
+1. **使用 cloud-module-base 组件**：UserSelect / DeptSelect / RoleSelect
+2. **使用 BaseApi 封装请求**：遵循五段路径规则
+3. **使用 CloudDialog 替代自定义 Dialog**：语义化组件
+4. **不使用 Vite**：Vue CLI 多页面架构
+
+## 页面访问地址
+
+```
+http://gateway/{frontPackage}/user-list/#/index
+```
+
+- `frontPackage`：vue.config.js 中的 outputDir
+- `user-list`：pages.user-list.filename
+- `index`：Vue Router path
+
+## 相关 References
+
+- [`components.md`](../../references/components.md)（12 个 cloud-module-base 组件）
+- [`utils.md`](../../references/utils.md)（日期/校验/防重复点击工具）
+- Excel 导入导出 → 参考公司其他 `meritdata-platform-*` skill