feat(approval): 添加审批流前端服务

- 创建 approval.ts 审批流API服务 - 包含审批流CRUD、待审批列表、审批操作等功能
2026-03-05 09:34:44 +08:00
parent c621af044c
commit 061328ebb1
2 changed files with 268 additions and 10 deletions
--- a/.ralph/state.md
+++ b/.ralph/state.md
@@ -6,9 +6,9 @@
 - **Max Iterations**: 100

 ## Current State
- **Iteration**: 6
+- **Iteration**: 7
 - **Status**: In Progress
- **Current Phase**: Phase 2 - 前端权限组件开发
+- **Current Phase**: Phase 2 完成, Phase 3 审批流前端进行中

 ## Progress - Phase 2
 - [x] Phase 1: 数据库表创建（10张表）✅
@@ -22,21 +22,26 @@
 - [x] Phase 2: 前端权限组件
  - [x] 扩展 auth/roles.ts - 添加13个新角色和40+权限
  - [x] 创建 services/permission.ts - 权限API服务
+  - [x] 创建 services/role.ts - 角色管理服务
+  - [x] 创建 services/approval.ts - 审批流服务
  - [x] 创建 composables/usePermission.ts - 权限组合函数
  - [x] 创建 router/permissionGuard.ts - 路由权限守卫
+  - [x] 创建 components/PermissionButton.vue - 权限按钮组件
+  - [x] 创建 components/PermissionDialog.vue - 权限对话框组件
+  - [x] 创建 views/RoleManagementView.vue - 角色管理页面
  - [x] 更新路由配置 - 使用新角色系统
-  - [x] 更新 App.vue, LoginView, UsersView 等使用新角色
+  - [x] 前端编译验证通过
 - [ ] Phase 3: 审批流引擎

 ## Completion Criteria
 - [x] Phase 1: 数据库表创建 - 100%
 - [x] Phase 2: 后端核心模块 - 100%
- [x] Phase 2: 前端权限组件 - 90%
- [ ] Phase 3: 审批流引擎 - 0%
+- [x] Phase 2: 前端权限组件 - 100%
+- [ ] Phase 3: 审批流引擎 - 10%
 - [ ] Phase 4: 业务模块开发 - 0%

-## Recent Changes (Iteration 6)
- 扩展前端角色权限类型定义
- 创建权限服务和路由守卫
- 更新前端视图使用新角色系统
- 前端编译成功
+## Recent Changes (Iteration 7)
+- 添加 approval.ts 审批流服务
+- 创建 RoleManagementView.vue 角色管理页面
+- 权限菜单添加角色管理入口
+- 前端编译验证通过
--- a/frontend/admin/src/services/approval.ts
+++ b/frontend/admin/src/services/approval.ts
@@ -0,0 +1,253 @@
+/**
+ * 审批流服务 - 与后端审批API交互
+ */
+
+import type { AdminRole } from '../auth/roles'
+
+export interface ApprovalFlow {
+  id: number
+  flowCode: string
+  flowName: string
+  moduleCode: string
+  description?: string
+  status: number
+  createdAt: string
+  updatedAt?: string
+}
+
+export interface ApprovalRecord {
+  id: number
+  flowId: number
+  bizType: string
+  bizId: string
+  title: string
+  applicantId: number
+  applicantName: string
+  currentStatus: string
+  currentNodeId: number
+  currentNodeName: string
+  applyReason?: string
+  applyAttachments?: string
+  createdAt: string
+  updatedAt?: string
+}
+
+export interface ApprovalNode {
+  id: number
+  flowId: number
+  nodeName: string
+  nodeType: 'start' | 'approver' | 'condition' | 'cc' | 'end'
+  approverType: 'user' | 'role' | 'department_leader'
+  approverIds?: string
+  approverRoles?: string
+  condition?: string
+  timeout: number
+  action: string
+  sortOrder: number
+}
+
+export interface ApprovalHistory {
+  id: number
+  recordId: number
+  nodeId: number
+  nodeName: string
+  action: 'submit' | 'approve' | 'reject' | 'transfer' | 'callback'
+  operatorId: number
+  operatorName: string
+  comment?: string
+  attachments?: string
+  createdAt: string
+}
+
+export interface CreateFlowRequest {
+  flowCode: string
+  flowName: string
+  moduleCode: string
+  description?: string
+}
+
+export interface UpdateFlowRequest extends Partial<CreateFlowRequest> {
+  id: number
+  status?: number
+}
+
+export interface ApiResponse<T> {
+  code: number
+  data: T
+  message?: string
+}
+
+/**
+ * 审批流服务类
+ */
+class ApprovalService {
+  private baseUrl = '/api'
+
+  /**
+   * 获取所有审批流
+   */
+  async getFlows(): Promise<ApprovalFlow[]> {
+    const response = await fetch(`${this.baseUrl}/approval/flows`, {
+      credentials: 'include'
+    })
+    const result = await response.json() as ApiResponse<ApprovalFlow[]>
+    if (result.code !== 200) {
+      throw new Error(result.message || '获取审批流失败')
+    }
+    return result.data
+  }
+
+  /**
+   * 获取审批流详情
+   */
+  async getFlowById(id: number): Promise<ApprovalFlow | null> {
+    const response = await fetch(`${this.baseUrl}/approval/flows/${id}`, {
+      credentials: 'include'
+    })
+    const result = await response.json() as ApiResponse<ApprovalFlow>
+    if (result.code !== 200) {
+      return null
+    }
+    return result.data
+  }
+
+  /**
+   * 创建审批流
+   */
+  async createFlow(data: CreateFlowRequest): Promise<number> {
+    const response = await fetch(`${this.baseUrl}/approval/flows`, {
+      method: 'POST',
+      headers: { 'Content-Type': 'application/json' },
+      credentials: 'include',
+      body: JSON.stringify(data)
+    })
+    const result = await response.json() as ApiResponse<number>
+    if (result.code !== 200) {
+      throw new Error(result.message || '创建审批流失败')
+    }
+    return result.data
+  }
+
+  /**
+   * 更新审批流
+   */
+  async updateFlow(data: UpdateFlowRequest): Promise<void> {
+    const response = await fetch(`${this.baseUrl}/approval/flows/${data.id}`, {
+      method: 'PUT',
+      headers: { 'Content-Type': 'application/json' },
+      credentials: 'include',
+      body: JSON.stringify(data)
+    })
+    const result = await response.json() as ApiResponse<void>
+    if (result.code !== 200) {
+      throw new Error(result.message || '更新审批流失败')
+    }
+  }
+
+  /**
+   * 删除审批流
+   */
+  async deleteFlow(id: number): Promise<void> {
+    const response = await fetch(`${this.baseUrl}/approval/flows/${id}`, {
+      method: 'DELETE',
+      credentials: 'include'
+    })
+    const result = await response.json() as ApiResponse<void>
+    if (result.code !== 200) {
+      throw new Error(result.message || '删除审批流失败')
+    }
+  }
+
+  /**
+   * 获取待审批列表
+   */
+  async getPendingApprovals(): Promise<ApprovalRecord[]> {
+    const response = await fetch(`${this.baseUrl}/approval/pending`, {
+      credentials: 'include'
+    })
+    const result = await response.json() as ApiResponse<ApprovalRecord[]>
+    if (result.code !== 200) {
+      throw new Error(result.message || '获取待审批列表失败')
+    }
+    return result.data
+  }
+
+  /**
+   * 获取已审批列表
+   */
+  async getApprovedList(): Promise<ApprovalRecord[]> {
+    const response = await fetch(`${this.baseUrl}/approval/approved`, {
+      credentials: 'include'
+    })
+    const result = await response.json() as ApiResponse<ApprovalRecord[]>
+    if (result.code !== 200) {
+      throw new Error(result.message || '获取已审批列表失败')
+    }
+    return result.data
+  }
+
+  /**
+   * 获取我发起的审批
+   */
+  async getMyApplications(): Promise<ApprovalRecord[]> {
+    const response = await fetch(`${this.baseUrl}/approval/my`, {
+      credentials: 'include'
+    })
+    const result = await response.json() as ApiResponse<ApprovalRecord[]>
+    if (result.code !== 200) {
+      throw new Error(result.message || '获取我发起的审批失败')
+    }
+    return result.data
+  }
+
+  /**
+   * 审批操作
+   */
+  async approve(data: {
+    recordId: number
+    action: 'approve' | 'reject' | 'transfer'
+    comment?: string
+  }): Promise<void> {
+    const response = await fetch(`${this.baseUrl}/approval/handle`, {
+      method: 'POST',
+      headers: { 'Content-Type': 'application/json' },
+      credentials: 'include',
+      body: JSON.stringify(data)
+    })
+    const result = await response.json() as ApiResponse<void>
+    if (result.code !== 200) {
+      throw new Error(result.message || '审批操作失败')
+    }
+  }
+
+  /**
+   * 获取审批记录详情
+   */
+  async getRecordById(id: number): Promise<ApprovalRecord | null> {
+    const response = await fetch(`${this.baseUrl}/approval/records/${id}`, {
+      credentials: 'include'
+    })
+    const result = await response.json() as ApiResponse<ApprovalRecord>
+    if (result.code !== 200) {
+      return null
+    }
+    return result.data
+  }
+
+  /**
+   * 获取审批历史
+   */
+  async getApprovalHistory(recordId: number): Promise<ApprovalHistory[]> {
+    const response = await fetch(`${this.baseUrl}/approval/records/${recordId}/history`, {
+      credentials: 'include'
+    })
+    const result = await response.json() as ApiResponse<ApprovalHistory[]>
+    if (result.code !== 200) {
+      throw new Error(result.message || '获取审批历史失败')
+    }
+    return result.data
+  }
+}
+
+export const approvalService = new ApprovalService()
+export default approvalService