@appthen/cli 1.2.10 → 1.2.12

package/tests/test-app/src/modules/work_order_module/cloud_function/ticket|list.node.ts

@@ -0,0 +1,85 @@
+/**
+ * 获取工单列表
+ * 支持分页、筛选、排序等功能
+ *
+ * @methods GET, POST
+ */
+import cloud from '@lafjs/cloud';
+import { DataSource, Like } from 'typeorm';
+import { Response } from '@/utils/func';
+import { Ticket } from '@/types/entity/Ticket';
+import { TicketListParams } from '@/types/models/TicketListParams';
+
+export default async function (ctx: FunctionContext) {
+  const { query, body } = ctx;
+  const params: TicketListParams = { ...query, ...body };
+
+  try {
+    const dataSource: DataSource = cloud.datasource.default;
+    const ticketRepository = dataSource.getRepository(Ticket);
+
+    // 构建查询条件
+    const whereConditions: any = {};
+    
+    if (params.statusId) {
+      whereConditions.statusId = params.statusId;
+    }
+    
+    if (params.priorityId) {
+      whereConditions.priorityId = params.priorityId;
+    }
+    
+    if (params.categoryId) {
+      whereConditions.categoryId = params.categoryId;
+    }
+    
+    if (params.creatorId) {
+      whereConditions.creatorId = params.creatorId;
+    }
+    
+    if (params.assigneeId) {
+      whereConditions.assigneeId = params.assigneeId;
+    }
+    
+    if (params.keyword) {
+      whereConditions.title = Like(`%${params.keyword}%`);
+    }
+    
+    if (params.startDate && params.endDate) {
+      whereConditions.createdAt = {
+        $gte: new Date(params.startDate),
+        $lte: new Date(params.endDate)
+      };
+    }
+
+    // 分页参数
+    const page = Math.max(1, params.page || 1);
+    const pageSize = Math.max(1, Math.min(100, params.pageSize || 10));
+    const skip = (page - 1) * pageSize;
+
+    // 排序
+    const order = {
+      [params.sortBy || 'createdAt']: params.sortOrder || 'DESC'
+    };
+
+    // 查询数据
+    const [tickets, total] = await ticketRepository.findAndCount({
+      where: whereConditions,
+      order,
+      skip,
+      take: pageSize,
+      relations: ['category', 'status', 'priority', 'comments', 'attachments']
+    });
+
+    return Response.ok({
+      list: tickets,
+      total,
+      page,
+      pageSize,
+      totalPages: Math.ceil(total / pageSize)
+    });
+  } catch (error) {
+    console.error('查询工单列表失败:', error);
+    return Response.failed('查询失败，请稍后重试');
+  }
+}

package/tests/test-app/src/modules/work_order_module/cloud_function/ticket|update.node.ts

@@ -0,0 +1,73 @@
+/**
+ * 更新工单
+ * 支持部分字段更新和状态变更
+ *
+ * @methods PUT
+ */
+import cloud from '@lafjs/cloud';
+import { DataSource } from 'typeorm';
+import { Response } from '@/utils/func';
+import { Ticket } from '@/types/entity/Ticket';
+import { UpdateTicketParams } from '@/types/models/UpdateTicketParams';
+import { TicketHistory } from '@/types/entity/TicketHistory';
+
+export default async function (ctx: FunctionContext) {
+  const { id } = ctx.query;
+  const params: UpdateTicketParams = ctx.body;
+
+  if (!id) {
+    return Response.failed('工单ID不能为空');
+  }
+
+  try {
+    const dataSource: DataSource = cloud.datasource.default;
+    const ticketRepository = dataSource.getRepository(Ticket);
+    const historyRepository = dataSource.getRepository(TicketHistory);
+
+    // 查询原工单
+    const ticket = await ticketRepository.findOne({
+      where: { id: parseInt(id) }
+    });
+
+    if (!ticket) {
+      return Response.failed('工单不存在');
+    }
+
+    // 记录变更历史
+    const changes: any = {};
+    Object.keys(params).forEach(key => {
+      if (params[key as keyof UpdateTicketParams] !== undefined) {
+        changes[key] = {
+          old: ticket[key as keyof Ticket],
+          new: params[key as keyof UpdateTicketParams]
+        };
+      }
+    });
+
+    // 更新工单
+    const updatedTicket = await ticketRepository.save({
+      ...ticket,
+      ...params,
+      updatedAt: new Date()
+    });
+
+    // 记录历史
+    if (Object.keys(changes).length > 0) {
+      const history = historyRepository.create({
+        ticketId: parseInt(id),
+        userId: ctx.user?._id || 'system',
+        action: 'UPDATE',
+        description: '更新工单信息',
+        oldValue: changes,
+        newValue: params,
+        createdAt: new Date()
+      });
+      await historyRepository.save(history);
+    }
+
+    return Response.ok(updatedTicket);
+  } catch (error) {
+    console.error('更新工单失败:', error);
+    return Response.failed('更新失败，请稍后重试');
+  }
+}

package/tests/test-app/src/modules/work_order_module/data_model/Ticket.m.ts

@@ -0,0 +1,85 @@
+import { Entity, Column } from 'typeorm';
+/**
+ * 工单实体
+ * 用于存储工单的基本信息和状态
+ */
+@Entity({
+  name: "tickets"
+})
+export class Ticket {
+  id?: number;
+  /* 工单标题 */
+  @Column({
+    type: "varchar",
+    length: 200,
+    nullable: false
+  })
+  title?: string = "";
+  /* 工单描述 */
+  @Column({
+    type: "text",
+    nullable: true
+  })
+  description: string = "";
+  /* 工单编号 */
+  @Column({
+    type: "varchar",
+    length: 50,
+    nullable: false
+  })
+  ticketNumber?: string = "";
+  /* 创建人ID */
+  @Column({
+    type: "varchar",
+    length: 50,
+    nullable: false
+  })
+  creatorId?: string = "";
+  /* 处理人ID */
+  @Column({
+    type: "varchar",
+    length: 50,
+    nullable: true
+  })
+  assigneeId: string = "";
+  /* 分类ID */
+  @Column({
+    type: "int",
+    nullable: false
+  })
+  categoryId?: number;
+  /* 优先级ID */
+  @Column({
+    type: "int",
+    nullable: false
+  })
+  priorityId?: number;
+  /* 状态ID */
+  @Column({
+    type: "int",
+    nullable: false
+  })
+  statusId?: number;
+  /* 截止日期 */
+  @Column({
+    type: "timestamp",
+    nullable: true
+  })
+  dueDate: Date = new Date();
+  /* 标签 */
+  @Column({
+    type: "simple-array",
+    nullable: true
+  })
+  tags: string[] = [];
+  /* 创建时间 */
+  createdAt?: Date = new Date();
+  /* 更新时间 */
+  updatedAt?: Date = new Date();
+  /* 删除时间 */
+  @Column({
+    type: "timestamp",
+    nullable: true
+  })
+  deletedAt: Date = new Date();
+}

package/tests/test-app/src/modules/work_order_module/data_model/TicketCategory.m.ts

@@ -0,0 +1,53 @@
+import { Entity, Column } from 'typeorm';
+/**
+ * 工单分类实体
+ * 用于管理工单的分类信息
+ */
+@Entity({
+  name: "ticket_categories"
+})
+export class TicketCategory {
+  id?: number;
+  /* 分类名称 */
+  @Column({
+    type: "varchar",
+    length: 100,
+    nullable: false
+  })
+  name?: string = "";
+  /* 分类描述 */
+  @Column({
+    type: "text",
+    nullable: true
+  })
+  description: string = "";
+  /* 父分类ID */
+  @Column({
+    type: "int",
+    nullable: true
+  })
+  parentId: number = 0;
+  /* 排序 */
+  @Column({
+    type: "int",
+    default: 0
+  })
+  sortOrder?: number;
+  /* 是否启用 */
+  @Column({
+    type: "boolean",
+    default: true
+  })
+  isActive?: boolean = true;
+  /* 图标 */
+  @Column({
+    type: "varchar",
+    length: 100,
+    nullable: true
+  })
+  icon: string = "";
+  /* 创建时间 */
+  createdAt?: Date = new Date();
+  /* 更新时间 */
+  updatedAt?: Date = new Date();
+}

package/tests/test-app/src/modules/work_order_module/data_model/TicketStatus.m.ts

@@ -0,0 +1,60 @@
+import { Entity, Column } from 'typeorm';
+/**
+ * 工单状态实体
+ * 用于管理工单的各种状态
+ */
+@Entity({
+  name: "ticket_statuses"
+})
+export class TicketStatus {
+  id?: number;
+  /* 状态名称 */
+  @Column({
+    type: "varchar",
+    length: 50,
+    nullable: false
+  })
+  name?: string = "";
+  /* 状态描述 */
+  @Column({
+    type: "text",
+    nullable: true
+  })
+  description: string = "";
+  /* 状态颜色 */
+  @Column({
+    type: "varchar",
+    length: 20,
+    nullable: false
+  })
+  color?: string = "";
+  /* 状态类型 */
+  @Column({
+    type: "varchar",
+    length: 20,
+    nullable: false
+  })
+  type?: string = "";
+  /* 排序 */
+  @Column({
+    type: "int",
+    default: 0
+  })
+  sortOrder?: number;
+  /* 是否启用 */
+  @Column({
+    type: "boolean",
+    default: true
+  })
+  isActive?: boolean = true;
+  /* 是否为默认状态 */
+  @Column({
+    type: "boolean",
+    default: false
+  })
+  isDefault?: boolean;
+  /* 创建时间 */
+  createdAt?: Date = new Date();
+  /* 更新时间 */
+  updatedAt?: Date = new Date();
+}

package/tests/test-app/src/modules/work_order_module//345/267/245/345/215/225/347/263/273/347/273/237/344/272/247/345/223/201/350/256/276/350/256/241/346/226/207/346/241/243.md

@@ -0,0 +1,301 @@
+# 工单系统产品设计文档
+
+## 1. 产品概述
+
+### 1.1 产品定位
+工单系统是一个面向企业内部和客户服务场景的综合问题跟踪与解决平台，旨在帮助企业高效管理客户问题、内部任务和项目需求。
+
+### 1.2 核心价值
+- **提升效率**：标准化问题处理流程，减少沟通成本
+- **透明管理**：全程可追溯的问题处理记录
+- **数据驱动**：基于数据分析优化服务质量和流程
+- **协作优化**：多角色协同工作，提升团队效率
+
+## 2. 用户角色与权限
+
+### 2.1 角色定义
+| 角色 | 描述 | 核心权限 |
+|---|---|---|
+| 普通用户 | 创建工单、查看进度 | 创建、查看、评论 |
+| 客服人员 | 处理工单、分配任务 | 处理、分配、回复 |
+| 技术工程师 | 解决技术问题 | 处理、技术回复、状态更新 |
+| 管理员 | 系统管理、数据分析 | 全权限、配置管理 |
+| 超级管理员 | 系统配置、用户管理 | 系统级权限 |
+
+### 2.2 权限矩阵
+- **创建工单**：所有用户
+- **查看工单**：创建人、处理人、管理员
+- **编辑工单**：创建人（限定期内）、处理人、管理员
+- **删除工单**：管理员
+- **分配工单**：客服、管理员
+- **状态变更**：处理人、管理员
+
+## 3. 功能模块设计
+
+### 3.1 工单管理
+#### 3.1.1 工单创建
+- **快速创建**：标题、描述、分类、优先级
+- **高级创建**：支持附件上传、标签设置、截止日期
+- **模板创建**：预设模板快速创建相似工单
+
+#### 3.1.2 工单处理
+- **状态流转**：新建 → 处理中 → 已解决 → 已关闭
+- **优先级调整**：根据紧急程度动态调整
+- **分配机制**：自动分配、手动分配、抢单模式
+
+#### 3.1.3 工单查询
+- **多维度筛选**：状态、优先级、分类、时间、处理人
+- **全文搜索**：标题、描述、评论内容
+- **高级搜索**：组合条件、自定义视图
+
+### 3.2 分类管理
+#### 3.2.1 多级分类
+```
+技术问题
+├── 前端问题
+│   ├── 页面显示异常
+│   └── 交互问题
+├── 后端问题
+│   ├── 接口异常
+│   └── 性能问题
+└── 数据问题
+```
+
+#### 3.2.2 分类属性
+- **基本信息**：名称、描述、图标
+- **处理规则**：默认处理人、SLA时间
+- **权限设置**：可见范围、创建权限
+
+### 3.3 优先级管理
+| 优先级 | 响应时间 | 解决时间 | 颜色标识 |
+|---|---|---|---|
+| 紧急 | 15分钟 | 2小时 | 红色 |
+| 高 | 1小时 | 8小时 | 橙色 |
+| 中 | 4小时 | 24小时 | 黄色 |
+| 低 | 24小时 | 72小时 | 蓝色 |
+
+### 3.4 通知机制
+#### 3.4.1 通知场景
+- **工单创建**：通知相关处理人
+- **状态变更**：通知创建人和关注人
+- **评论回复**：通知相关人员
+- **即将超时**：预警通知
+
+#### 3.4.2 通知渠道
+- **站内消息**：系统内消息中心
+- **邮件通知**：邮件推送
+- **企业微信**：群消息推送
+- **短信通知**：紧急情况短信
+
+## 4. 业务流程设计
+
+### 4.1 工单生命周期
+```mermaid
+graph TD
+    A[新建] --> B[待分配]
+    B --> C[处理中]
+    C --> D[待确认]
+    D --> E[已解决]
+    E --> F[已关闭]
+    C --> G[已拒绝]
+    C --> H[已挂起]
+```
+
+### 4.2 处理流程
+1. **创建阶段**
+   - 用户提交工单
+   - 系统验证必填项
+   - 自动分类和优先级评估
+
+2. **分配阶段**
+   - 根据分类自动分配
+   - 负载均衡考虑
+   - 特殊规则处理
+
+3. **处理阶段**
+   - 处理人接收通知
+   - 问题分析和解决
+   - 进度更新和沟通
+
+4. **验证阶段**
+   - 用户确认解决
+   - 满意度评价
+   - 工单关闭或重开
+
+## 5. 界面设计
+
+### 5.1 工作台
+#### 5.1.1 概览面板
+- **待处理工单**：我的待处理、团队待处理
+- **统计信息**：今日新增、处理中、已解决
+- **快捷操作**：创建工单、批量处理
+
+#### 5.1.2 工单列表
+- **列表视图**：表格展示，支持排序和筛选
+- **卡片视图**：看板模式，拖拽状态变更
+- **时间轴视图**：按时间顺序展示
+
+### 5.2 工单详情页
+#### 5.2.1 基本信息
+- 工单标题、编号、状态
+- 创建人、处理人、时间信息
+- 分类、优先级、标签
+
+#### 5.2.2 内容区域
+- 问题描述（支持富文本）
+- 附件预览和下载
+- 评论和回复（支持@提及）
+
+#### 5.2.3 操作区域
+- 状态变更按钮
+- 分配处理人
+- 添加关注人
+
+### 5.3 管理后台
+#### 5.3.1 分类管理
+- 分类树形结构管理
+- 分类属性配置
+- 批量导入导出
+
+#### 5.3.2 用户管理
+- 用户角色分配
+- 权限配置
+- 工作量统计
+
+#### 5.3.3 系统配置
+- SLA规则设置
+- 通知模板配置
+- 自定义字段管理
+
+## 6. 技术架构
+
+### 6.1 前端架构
+- **框架**：React + TypeScript
+- **UI库**：Ant Design Pro
+- **状态管理**：内置状态管理
+- **构建工具**：Vite
+
+### 6.2 后端架构
+- **运行环境**：Node.js + TypeScript
+- **数据库**：MongoDB
+- **ORM框架**：TypeORM
+- **认证授权**：JWT Token
+
+### 6.3 部署架构
+- **容器化**：Docker容器部署
+- **负载均衡**：Nginx反向代理
+- **数据备份**：定时自动备份
+- **监控告警**：系统健康监控
+
+## 7. 数据模型设计
+
+### 7.1 核心实体关系
+```
+Ticket (工单)
+├── TicketCategory (分类)
+├── TicketStatus (状态)
+├── TicketPriority (优先级)
+├── TicketComment (评论)
+├── TicketAttachment (附件)
+└── TicketHistory (历史记录)
+```
+
+### 7.2 关键字段设计
+- **工单编号**：自动生成，格式：TK-YYYYMMDD-000001
+- **状态流转**：支持自定义状态机
+- **时间记录**：创建、更新、解决、关闭时间
+- **用户关联**：创建人、处理人、关注人
+
+## 8. 性能优化
+
+### 8.1 查询优化
+- **索引设计**：关键字段建立索引
+- **分页查询**：大数据量分页加载
+- **缓存策略**：热点数据缓存
+
+### 8.2 用户体验
+- **懒加载**：图片和附件懒加载
+- **批量操作**：支持批量处理工单
+- **实时更新**：WebSocket实时推送
+
+## 9. 安全设计
+
+### 9.1 数据安全
+- **权限控制**：基于角色的访问控制
+- **数据脱敏**：敏感信息脱敏处理
+- **操作日志**：完整的操作审计日志
+
+### 9.2 系统安全
+- **输入验证**：防止SQL注入和XSS攻击
+- **文件安全**：附件类型和大小限制
+- **接口安全**：API限流和防刷机制
+
+## 10. 扩展功能
+
+### 10.1 高级功能
+- **工单模板**：预设模板快速创建
+- **自动化规则**：基于条件的自动处理
+- **知识库集成**：关联知识库文章
+- **满意度调查**：自动发送满意度问卷
+
+### 10.2 集成能力
+- **第三方登录**：企业微信、钉钉登录
+- **消息推送**：企业微信、钉钉群机器人
+- **API接口**：开放API供第三方集成
+- **Webhook**：支持事件回调
+
+## 11. 数据分析
+
+### 11.1 核心指标
+- **处理效率**：平均处理时间、首次响应时间
+- **质量指标**：解决率、重开率、满意度
+- **工作量**：个人工作量、团队工作量
+- **趋势分析**：问题类型趋势、处理效率趋势
+
+### 11.2 报表功能
+- **实时报表**：当前状态概览
+- **周期报表**：日报、周报、月报
+- **自定义报表**：灵活配置查询条件
+- **导出功能**：支持Excel、PDF导出
+
+## 12. 实施计划
+
+### 12.1 阶段划分
+- **第一阶段**（1-2周）：基础功能开发
+  - 工单创建、处理、查询
+  - 用户权限管理
+  - 基础界面开发
+
+- **第二阶段**（2-3周）：高级功能
+  - 分类管理、优先级管理
+  - 通知机制、报表功能
+  - 界面优化
+
+- **第三阶段**（1-2周）：测试优化
+  - 功能测试、性能测试
+  - 用户体验优化
+  - 部署上线
+
+### 12.2 风险管控
+- **技术风险**：关键技术预研和验证
+- **进度风险**：里程碑节点检查
+- **质量风险**：代码审查和测试覆盖
+- **需求风险**：需求变更管理流程
+
+## 13. 运维支持
+
+### 13.1 监控指标
+- **系统性能**：响应时间、并发量
+- **业务指标**：工单量、处理效率
+- **错误监控**：异常率、错误日志
+
+### 13.2 维护计划
+- **日常维护**：数据备份、日志清理
+- **定期优化**：性能调优、数据归档
+- **版本升级**：功能迭代、安全更新
+
+## 14. 总结
+
+本工单系统采用模块化设计，支持灵活配置和扩展，能够满足不同规模企业的工单管理需求。通过标准化的流程和数据驱动的优化，显著提升问题处理效率和客户满意度。
+
+系统设计充分考虑了用户体验、性能优化和安全保障，为企业提供了一个可靠、高效的工单管理平台。