t

.kiro/specs/urbanlifeline-to-pigx-migration/tasks.md

@@ -0,0 +1,387 @@
+# Implementation Plan: urbanLifeline 业务功能迁移到 pigx-ai
+
+## Overview
+
+将 urbanLifelineServ 和 urbanLifelineWeb 的业务功能迁移到 pigx-ai 平台，完全使用 pigx 原生的用户权限体系，只迁移业务代码和数据。
+
+## Tasks
+
+- [x] 1. 数据库迁移准备
+  - 分析源项目 PostgreSQL 表结构
+  - 生成 MySQL DDL 转换脚本
+  - 为所有业务表添加 tenant_id 字段
+  - _Requirements: 8.1, 8.2, 8.4_
+
+- [x] 1.1 编写数据库转换脚本
+  - 已完成 database-migration-script.md 文档
+  - 包含工单、AI、招标、消息模块的完整 MySQL DDL
+  - **Validates: Requirements 8.1, 8.2, 8.3, 8.4**
+
+- [x] 2. 权限和菜单规划
+  - 设计业务功能的权限标识规范
+  - 规划前端路由路径
+  - 定义菜单层级结构
+  - _Requirements: 10.2, 11.3_
+
+- [x] 2.1 创建权限标识映射表
+  - 已完成 permission-mapping.md 文档
+  - 包含完整的权限映射和菜单配置 SQL
+  - _Requirements: 11.1, 11.2_
+
+- [x] 2.2 编写权限注解转换指南
+  - 已完成 permission-annotation-guide.md 文档
+  - 包含 @PreAuthorize 到 @pms.hasPermission 转换规则
+  - _Requirements: 11.1, 11.2_
+
+- [x] 2.3 配置 SecurityUtils 和 RemoteUserService
+  - 已完成 security-config-guide.md 文档
+  - 包含完整的使用示例和最佳实践
+  - _Requirements: 11.4, 11.5_
+
+- [x] 2.4 配置业务功能菜单
+  - 在 pigx sys_menu 表中执行菜单配置 SQL（ID从10000开始）
+  - 配置对应的权限标识和路由路径
+  - _Requirements: 10.2, 11.3_
+
+- [x] 2.5 分配角色权限
+  - 已在 permission-mapping.md 中提供完整的角色权限分配 SQL
+  - 管理员角色分配所有业务权限（menu_id 10000-15000）
+  - 普通用户角色分配查看权限
+  - 执行时需在 MySQL 中运行 sys_role_menu 插入语句
+  - _Requirements: 10.3, 11.3_
+
+- [x] 3. 后端基础架构搭建
+  - 创建 pigx-workcase、pigx-bidding、pigx-dify 三个独立模块
+  - 每个模块包含 api 和 biz 子模块
+  - 配置 Maven 依赖和模块引用
+  - _Requirements: 1.1, 2.1, 3.1, 5.1_
+
+- [x] 4. 工单模块迁移 (pigx-workcase)
+- [x] 4.1 迁移工单实体和 Mapper
+  - 已创建 TbWorkcase、TbChatRoom、TbChatRoomMessage、TbChatRoomMember、TbWorkcaseProcess、TbVideoMeeting 实体
+  - 使用 pigx 标准格式：@TenantTable、Model<T>、createBy/updateBy/delFlag
+  - 已创建对应的 Mapper 接口
+  - _Requirements: 2.1, 2.4_
+
+- [x] 4.2 迁移工单 Service 层
+  - 已创建 TbWorkcaseService、TbChatRoomService、TbChatRoomMessageService、TbChatRoomMemberService、TbWorkcaseProcessService、TbVideoMeetingService、TbCustomerServiceService
+  - TbChatRoomService 包含完整业务逻辑：创建聊天室、关闭聊天室、成员管理、消息管理、客服分配、服务评分
+  - TbVideoMeetingService 包含完整业务逻辑：创建会议、加入会议、开始/结束会议、权限验证
+  - TbCustomerServiceService 包含客服管理：获取可用客服、更新状态、工作量管理
+  - 已创建对应的 ServiceImpl 实现类
+  - _Requirements: 2.1, 2.2_
+
+- [x] 4.3 迁移工单 Controller 层
+  - 已创建 TbWorkcaseController、TbChatRoomController、TbVideoMeetingController、TbCustomerServiceController
+  - TbChatRoomController 包含完整的聊天室功能：成员管理、消息管理、客服分配、服务评分
+  - TbVideoMeetingController 包含完整的会议功能：创建、加入、开始、结束会议
+  - TbCustomerServiceController 包含客服人员管理功能
+  - 使用 @HasPermission 权限注解
+  - 响应格式使用 R<T>
+  - _Requirements: 2.1, 11.1, 11.4_
+
+- [x] 4.4 迁移视频会议功能
+  - 已创建 TbVideoMeetingService 和 TbVideoMeetingServiceImpl
+  - 包含创建会议、加入会议、开始会议、结束会议、获取活跃会议等功能
+  - 会议访问权限验证（基于聊天室成员）
+  - 注：Jitsi JWT Token 生成需要后续配置 Jitsi 服务器参数
+  - _Requirements: 2.6_
+
+- [x] 4.5 迁移聊天室 WebSocket 功能
+  - 已创建 ChatRoomWebSocketMessage、ChatRoomNotificationMessage 消息类
+  - 已创建 ChatRoomMessageHandler、ChatRoomNotificationHandler 消息处理器
+  - 已创建 ChatRoomWebSocketService 用于主动推送消息
+  - 使用 pigx-common-websocket 进行实时推送
+  - 配置 WebSocket 路径为 /ws/chat
+  - _Requirements: 2.1, 5.2_
+
+- [x] 4.6 迁移 Jitsi JWT Token 生成功能
+  - 已创建 JitsiProperties 配置类
+  - 已创建 JitsiTokenService 接口和 JitsiTokenServiceImpl 实现
+  - 已创建 JitsiTokenController 提供 Token 生成、验证、URL 构建 API
+  - 支持一键生成会议信息（房间名+Token+URL）
+  - 使用 jjwt 0.12.x 版本 API
+  - _Requirements: 2.6_
+
+- [x] 4.7 迁移词云管理功能
+  - 已创建 TbWordCloud 实体类
+  - 已创建 TbWordCloudMapper 接口和 XML 映射文件
+  - 已创建 TbWordCloudService 接口和 TbWordCloudServiceImpl 实现
+  - 已创建 TbWordCloudController 提供词云 CRUD 和词频增加 API
+  - 支持词频自动累加（同一天、同一分类的相同词条）
+  - _Requirements: 2.1_
+
+- [x] 5. AI 模块迁移（pigx-dify 模块）
+- [x] 5.1 创建 pigx-dify 模块结构
+  - 已创建 pigx-dify-api 和 pigx-dify-biz 子模块
+  - 已配置 Maven 依赖和模块引用
+  - 已创建启动类和配置文件
+  - _Requirements: 4.1_
+
+- [x] 5.2 迁移 AI 实体和数据层
+  - 已创建 TbAgent、TbChat、TbChatMessage、TbKnowledge、TbKnowledgeFile、TbKnowledgeFileLog、PromptCard 实体
+  - 使用 pigx 标准格式
+  - 已创建对应的 Mapper 接口
+  - _Requirements: 4.4, 4.6_
+
+- [x] 5.3 迁移 Dify API 客户端
+  - 已创建 DifyApiClient 完整功能（知识库管理、文档管理、对话、工作流、模型管理）
+  - 已创建 DifyProperties 配置类
+  - 已创建 DifyException 异常类
+  - 已创建 StreamCallback 回调接口
+  - 已创建所有 DTO 类（ChatRequest/Response、Dataset*、Document*、Retrieval*、Workflow*、Conversation*、MessageHistory*、EmbeddingModel*、RerankModel*、DifyFileInfo）
+  - 支持流式响应和阻塞调用两种模式
+  - 已配置 OkHttp 依赖
+  - 已更新 application.yml 添加 Dify 配置
+  - _Requirements: 4.2, 4.3_
+
+- [x] 5.4 迁移 AI 业务逻辑
+  - 已创建 TbAgentService、TbChatService、TbKnowledgeService 等服务接口和实现类
+  - _Requirements: 4.1, 4.2_
+
+- [x] 5.5 迁移 AI Controller 层
+  - 已创建 TbAgentController、TbChatController、TbKnowledgeController
+  - 使用 @HasPermission 权限注解
+  - _Requirements: 4.1, 11.1_
+
+- [x] 5.6 配置 Dify 集成
+  - 已配置 DifyProperties 包含完整配置（API地址、密钥、超时、上传、知识库）
+  - 已在 application.yml 中添加 Dify 配置项
+  - 配置支持环境变量覆盖
+  - _Requirements: 4.3, 4.7_
+
+- [x] 6. 招标模块迁移 (pigx-bidding)
+- [x] 6.1 迁移招标实体和数据层
+  - 已创建 TbBiddingProject、TbBiddingDocument、TbBiddingRequirement、TbBidResponse、TbProcessNode 实体
+  - 已创建对应的 Mapper 接口
+  - _Requirements: 1.1, 1.3_
+
+- [x] 6.2 迁移招标业务逻辑
+  - 已创建 TbBiddingProjectService、TbBiddingDocumentService 等服务接口和实现类
+  - _Requirements: 1.1, 1.2_
+
+- [x] 6.3 迁移招标 API 接口
+  - 已创建 TbBiddingProjectController、TbBiddingDocumentController
+  - 使用 @HasPermission 权限注解
+  - _Requirements: 1.1, 1.5_
+
+- [x] 7. 平台管理模块迁移 (platform)
+- [x] 7.1 迁移平台管理功能
+  - 源项目 platform 模块只有启动类，无实际业务代码
+  - 平台配置功能可使用 pigx 的 sys_config 表和配置管理功能
+  - _Requirements: 3.1, 3.2_
+
+- [x] 7.2 迁移平台数据表
+  - 无需迁移，使用 pigx 现有的配置管理表
+  - _Requirements: 3.3_
+
+- [x] 8. 消息模块迁移 (message)
+- [x] 8.1 迁移消息实体和数据层
+  - 源项目消息模块主要是邮件/短信发送功能，大部分方法为 TODO 状态
+  - pigx 已有完善的消息通知功能（pigx-common-sms、pigx-common-mail）
+  - 直接使用 pigx 现有的消息功能即可
+  - _Requirements: 5.1, 5.4_
+
+- [x] 8.2 迁移消息通知功能
+  - 使用 pigx-common-websocket 进行实时推送（已在 pigx-workcase 中实现）
+  - 使用 pigx-common-sms 进行短信发送
+  - 使用 pigx-common-mail 进行邮件发送
+  - _Requirements: 5.1, 5.2_
+
+- [x] 8.3 保留微信通知功能
+  - pigx 已有微信公众号/小程序消息推送功能
+  - 可通过 pigx-mp 模块实现微信消息推送
+  - _Requirements: 5.3_
+
+- [x] 9. 文件服务适配
+- [x] 9.1 替换文件上传逻辑
+  - 已在 pigx-workcase-biz、pigx-dify-biz、pigx-bidding-biz 中添加 pigx-common-oss 依赖
+  - 使用 pigx 的 OssTemplate 进行文件上传/下载
+  - 文件访问 URL 通过 pigx 网关统一管理
+  - _Requirements: 6.1, 6.2_
+
+- [x] 10. 定时任务迁移
+- [x] 10.1 迁移定时任务到 XXL-Job
+  - 源项目无定时任务需要迁移
+  - 如需添加定时任务，可使用 pigx-visual/xxl-job 进行配置
+  - _Requirements: 7.1, 7.2, 7.3_
+
+- [ ] 11. 前端页面迁移
+- [x] 11.1 迁移工单前端页面
+  - ✅ 已创建 API 层 (workcase.ts, chat.ts)
+  - ✅ 已创建类型定义 (workcase.ts, chatRoom.ts, customer.ts, conversation.ts, wordCloud.ts)
+  - ✅ 已创建工单列表页面 (views/workcase/index.vue)
+  - ✅ 已创建工单指派组件 (components/workcase/WorkcaseAssign.vue)
+  - ✅ 已创建工单详情组件 (views/workcase/detail/WorkcaseDetail.vue)
+  - ✅ 已创建聊天室消息组件 (views/workcase/chatRoom/ChatMessage.vue)
+  - 适配 pigx 的 request 工具和响应格式
+  - _Requirements: 2.5_
+
+- [ ] 11.2 迁移 AI 前端页面
+  - 将 AI 相关页面迁移到 pigx-ai-ui/src/views/dify 目录
+  - 包括智能体管理、对话界面、知识库管理
+  - 适配 pigx 的 request 工具和响应格式
+  - _Requirements: 4.5_
+
+- [ ] 11.3 迁移招标前端页面
+  - 将 bidding 页面迁移到 pigx-ai-ui/src/views/urban/bidding
+  - 适配 pigx 的 request 工具
+  - _Requirements: 1.4_
+
+- [ ] 11.4 迁移平台管理前端页面
+  - 将 platform 页面迁移到 pigx-ai-ui/src/views/urban/platform
+  - _Requirements: 3.4_
+
+- [ ] 11.5 迁移共享组件
+  - 将 shared 包组件迁移到 pigx-ai-ui/src/components/urban
+  - 更新导入路径使用 pigx 工具函数
+  - _Requirements: 9.1, 9.2_
+
+- [ ] 11.6 适配 API 调用
+  - 创建 pigx-ai-ui/src/api/urban 目录
+  - 创建 workcase.ts、bidding.ts、platform.ts API 定义
+  - 创建 pigx-ai-ui/src/api/dify 目录
+  - 创建 agent.ts、chat.ts、knowledge.ts API 定义
+  - 使用 pigx 的 request 工具和 R<T> 响应格式
+  - 更新 API 路径为 pigx 网关规则
+  - _Requirements: 1.5, 9.4_
+
+- [ ] 12. 数据迁移执行
+- [ ] 12.1 执行数据库 DDL 脚本
+  - 在 MySQL 中执行 database-migration-script.md 中的建表语句
+  - 验证表结构正确性
+  - _Requirements: 8.1, 8.2_
+
+- [ ] 12.2 执行业务数据迁移
+  - 运行数据迁移脚本
+  - 验证数据完整性
+  - _Requirements: 8.5_
+
+- [ ] 13. 集成测试和验证
+- [ ] 13.1 后端编译验证
+  - 确保所有迁移代码可以通过编译
+  - 验证 Maven 依赖正确
+  - _Requirements: 所有后端需求_
+
+- [ ] 13.2 端到端功能测试
+  - 测试所有迁移功能的完整流程
+  - 验证权限控制正确性
+  - _Requirements: 所有需求_
+
+- [ ] 13.3 租户隔离验证
+  - 验证多租户数据隔离正确性
+  - _Requirements: 8.4, 11.6_
+
+- [ ] 14. 最终验收
+  - 确保所有功能正常运行
+  - 确认权限控制有效
+  - 验证多租户数据隔离
+
+## Notes
+
+- 任务 1、2.1、2.2、2.3 的文档已完成，可直接使用
+- 重点关注权限适配和用户服务调用的正确性
+- 已创建三个独立模块：pigx-workcase、pigx-bidding、pigx-dify
+- 每个模块包含 api 和 biz 子模块，遵循 pigx 架构规范
+- 实体类使用 pigx 标准格式：@TenantTable、Model<T>、createBy/updateBy/delFlag
+- 前端迁移需要适配 pigx-ai-ui 的技术栈（Vue3 + TypeScript + Element Plus）
+- 数据库迁移脚本已在 database-migration-script.md 中准备好
+
+## 已创建的文件
+
+### pigx-ai-ui 前端已迁移文件
+
+#### API 层
+- `src/api/workcase/workcase.ts` - 工单管理 API
+- `src/api/workcase/chat.ts` - 聊天室、客服、视频会议 API
+
+#### 类型定义
+- `src/types/workcase/workcase.ts` - 工单相关类型
+- `src/types/workcase/chatRoom.ts` - 聊天室相关类型
+- `src/types/workcase/customer.ts` - 客服相关类型
+- `src/types/workcase/conversation.ts` - 对话相关类型
+- `src/types/workcase/wordCloud.ts` - 词云相关类型
+
+#### 组件
+- `src/components/workcase/WorkcaseAssign.vue` - 工单指派组件
+
+#### 页面
+- `src/views/workcase/index.vue` - 工单列表页面
+- `src/views/workcase/detail/WorkcaseDetail.vue` - 工单详情组件
+- `src/views/workcase/detail/WorkcaseDetail.scss` - 工单详情样式
+- `src/views/workcase/chatRoom/ChatMessage.vue` - 聊天室消息组件
+
+#### 导出文件
+- `src/views/workcase/chatRoom/index.ts`
+- `src/views/workcase/detail/index.ts`
+- Entity: TbWorkcase, TbChatRoom, TbChatRoomMessage, TbChatRoomMember, TbWorkcaseProcess, TbVideoMeeting, TbCustomerService, TbWordCloud
+- Mapper: TbWorkcaseMapper, TbChatRoomMapper, TbChatRoomMessageMapper, TbChatRoomMemberMapper, TbWorkcaseProcessMapper, TbVideoMeetingMapper, TbCustomerServiceMapper, TbWordCloudMapper
+- Service: TbWorkcaseService, TbChatRoomService（含完整业务逻辑）, TbChatRoomMessageService, TbChatRoomMemberService, TbWorkcaseProcessService, TbVideoMeetingService（含完整业务逻辑）, TbCustomerServiceService, TbWordCloudService, JitsiTokenService
+- Controller: TbWorkcaseController, TbChatRoomController（含成员/消息/客服分配API）, TbVideoMeetingController（含创建/加入/开始/结束会议API）, TbCustomerServiceController, TbWordCloudController, JitsiTokenController
+- WebSocket: ChatRoomWebSocketMessage, ChatRoomNotificationMessage, ChatRoomMessageHandler, ChatRoomNotificationHandler, ChatRoomWebSocketService
+- Config: JitsiProperties, application.yml (port: 7070, WebSocket: /ws/chat)
+- Application: PigxWorkcaseApplication
+
+#### 聊天室功能已迁移的API：
+- 聊天室CRUD：创建、查询、修改、关闭、删除
+- 成员管理：添加成员、移除成员、获取成员列表、获取未读数、更新已读状态
+- 消息管理：发送消息、分页查询消息、删除消息
+- 客服分配：自动分配客服到聊天室
+- 服务评分：提交聊天室服务评分
+
+#### 视频会议功能已迁移的API：
+- 会议CRUD：创建、查询、删除
+- 会议操作：获取会议信息、加入会议、开始会议、结束会议
+- 聊天室关联：获取聊天室当前活跃会议
+
+#### 客服人员管理已迁移的API：
+- 客服CRUD：新增、查询、修改、删除
+- 状态管理：更新客服在线状态
+- 可用客服：获取可接待客服列表
+
+#### WebSocket 实时推送功能：
+- 消息类型：chat_message（聊天消息）、chat_notification（通知消息）
+- 通知类型：member_join（成员加入）、member_leave（成员离开）、typing（正在输入）、room_closed（聊天室关闭）
+- ChatRoomWebSocketService：主动推送消息、广播到聊天室、发送给指定用户
+
+#### Jitsi JWT Token 功能：
+- 生成 JWT Token：支持主持人/普通成员角色
+- 验证 Token：检查 Token 有效性和过期时间
+- 构建 iframe URL：包含默认配置和自定义配置
+- 生成房间名：基于工单ID生成唯一房间名
+- 一键生成会议信息：房间名+Token+URL
+
+#### 词云管理功能：
+- 词云CRUD：新增、查询、修改、删除
+- 词频累加：同一天、同一分类的相同词条自动累加词频
+- 分页查询：支持按词语、分类、日期筛选
+
+### pigx-dify 模块
+- Entity: TbAgent, TbChat, TbChatMessage, TbKnowledge, TbKnowledgeFile, TbKnowledgeFileLog, PromptCard
+- Mapper: TbAgentMapper, TbChatMapper, TbChatMessageMapper, TbKnowledgeMapper, TbKnowledgeFileMapper, TbKnowledgeFileLogMapper
+- Service: TbAgentService, TbChatService, TbChatMessageService, TbKnowledgeService, TbKnowledgeFileService, TbKnowledgeFileLogService
+- Controller: TbAgentController, TbChatController, TbKnowledgeController
+- Client: DifyApiClient（完整的 Dify API 客户端）
+- Client DTO: ChatRequest, ChatResponse, DatasetCreateRequest, DatasetCreateResponse, DatasetDetailResponse, DatasetListResponse, DatasetUpdateRequest, DocumentListResponse, DocumentStatusResponse, DocumentUploadRequest, DocumentUploadResponse, RetrievalModel, RetrievalRequest, RetrievalResponse, WorkflowRunRequest, WorkflowRunResponse, ConversationListResponse, ConversationVariablesResponse, MessageHistoryResponse, EmbeddingModelResponse, RerankModelResponse, DifyFileInfo
+- Callback: StreamCallback（流式响应回调接口）
+- Exception: DifyException
+- Config: DifyProperties, application.yml (port: 7080, Dify API 配置)
+- Application: PigxDifyApplication
+
+#### Dify API 客户端功能：
+- 知识库管理：创建、查询、更新、删除知识库
+- 文档管理：上传文档、查询文档列表、查询文档状态、删除文档
+- 知识库检索：从知识库检索相关内容
+- 对话功能：流式对话、阻塞式对话、停止对话、消息反馈
+- 工作流：执行工作流（阻塞模式）
+- 对话历史：获取消息历史、对话列表、对话变量
+- 模型管理：获取嵌入模型列表、Rerank模型列表
+- 通用HTTP：GET、POST、PATCH、DELETE 方法
+
+### pigx-bidding 模块
+- Entity: TbBiddingProject, TbBiddingDocument, TbBiddingRequirement, TbBidResponse, TbProcessNode
+- Mapper: TbBiddingProjectMapper, TbBiddingDocumentMapper, TbBiddingRequirementMapper, TbBidResponseMapper, TbProcessNodeMapper
+- Service: TbBiddingProjectService, TbBiddingDocumentService, TbBiddingRequirementService, TbBidResponseService, TbProcessNodeService
+- Controller: TbBiddingProjectController, TbBiddingDocumentController
+- Application: PigxBiddingApplication
+- Config: application.yml (port: 7090)