wangys/urbanLifeline
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

结构

Browse Source
This commit is contained in:
wangys
2025-12-22 11:06:48 +08:00
parent 6c1aa13498
commit 1f37db80d8
12 changed files with 548 additions and 29 deletions
Download Patch File Download Diff File Expand all files Collapse all files

29
urbanLifelineServ/.bin/database/postgres/sql/createTableWorkcase.sql
View File

@@ -37,10 +37,7 @@ CREATE TABLE workcase.tb_chat_room(
guest_id VARCHAR(50) NOT NULL, -- 来客ID（创建者）
guest_name VARCHAR(100) NOT NULL, -- 来客姓名
ai_session_id VARCHAR(50) DEFAULT NULL, -- AI对话会话ID（从ai.tb_chat同步）
current_agent_id VARCHAR(50) DEFAULT NULL, -- 当前负责客服ID
agent_count INTEGER NOT NULL DEFAULT 0, -- 已加入的客服人数
message_count INTEGER NOT NULL DEFAULT 0, -- 消息总数
unread_count INTEGER NOT NULL DEFAULT 0, -- 未读消息数（客服端）
last_message_time TIMESTAMPTZ DEFAULT NULL, -- 最后消息时间
last_message TEXT DEFAULT NULL, -- 最后一条消息内容（用于列表展示）
closed_by VARCHAR(50) DEFAULT NULL, -- 关闭人
@@ -55,7 +52,6 @@ CREATE TABLE workcase.tb_chat_room(
UNIQUE (optsn)
);
CREATE INDEX idx_chat_room_guest ON workcase.tb_chat_room(guest_id, status);
CREATE INDEX idx_chat_room_agent ON workcase.tb_chat_room(current_agent_id, status);
CREATE INDEX idx_chat_room_time ON workcase.tb_chat_room(last_message_time DESC);
COMMENT ON TABLE workcase.tb_chat_room IS 'IM聊天室表，一个工单对应一个聊天室';
@@ -196,10 +192,21 @@ CREATE TABLE workcase.tb_meeting_transcription(
segment_index INTEGER NOT NULL DEFAULT 0, -- 片段序号（按时间排序）
is_final BOOLEAN NOT NULL DEFAULT true, -- 是否最终结果（实时转录会有中间结果）
service_provider VARCHAR(50) DEFAULT 'xunfei', -- 服务提供商：xunfei aliyun tencent google
agent_id VARCHAR(50) NOT NULL, -- 客服ID（关联sys用户ID）
agent_name VARCHAR(100) NOT NULL, -- 客服姓名
agent_code VARCHAR(50) DEFAULT NULL, -- 客服工号
status VARCHAR(20) NOT NULL DEFAULT 'online', -- 状态：online-在线 busy-忙碌 offline-离线
create_time TIMESTAMPTZ NOT NULL DEFAULT now(), -- 创建时间
PRIMARY KEY (transcription_id)
);
CREATE INDEX idx_transcription_meeting ON workcase.tb_meeting_transcription(meeting_id, segment_index);
COMMENT ON TABLE workcase.tb_meeting_transcription IS '会议转录记录表，用于保存视频会议的语音转文字内容';
-- 8. 员工配置表
-- 用于控制哪些人员可以在聊天室里接待来客
DROP TABLE IF EXISTS workcase.tb_customer_service CASCADE;
CREATE TABLE workcase.tb_customer_service(
optsn VARCHAR(50) NOT NULL, -- 流水号
user_id VARCHAR(50) NOT NULL, -- 员工ID（关联sys用户ID）
username VARCHAR(100) NOT NULL, -- 员工姓名
user_code VARCHAR(50) DEFAULT NULL, -- 员工工号
status VARCHAR(20) NOT NULL DEFAULT 'offline', -- 状态：online-在线 busy-忙碌 offline-离线
skill_tags VARCHAR(50)[] DEFAULT '{}', -- 技能标签（如：电力、燃气、水务）
max_concurrent INTEGER NOT NULL DEFAULT 5, -- 最大并发接待数
current_workload INTEGER NOT NULL DEFAULT 0, -- 当前工作量
@@ -211,10 +218,10 @@ CREATE TABLE workcase.tb_meeting_transcription(
update_time TIMESTAMPTZ DEFAULT NULL, -- 更新时间
delete_time TIMESTAMPTZ DEFAULT NULL, -- 删除时间
deleted BOOLEAN NOT NULL DEFAULT false, -- 是否删除
PRIMARY KEY (agent_id)
PRIMARY KEY (user_id)
);
CREATE INDEX idx_agent_status ON workcase.tb_customer_service(status, current_workload);
COMMENT ON TABLE workcase.tb_customer_service IS '客服人员配置表';
CREATE INDEX idx_customer_service_status ON workcase.tb_customer_service(status, current_workload);
COMMENT ON TABLE workcase.tb_customer_service IS '员工配置表，用于控制哪些人员可以在聊天室接待来客';
-- 工单表
DROP TABLE IF EXISTS workcase.tb_workcase CASCADE;

49
urbanLifelineServ/apis/api-workcase/src/main/java/org/xyzh/api/workcase/dto/TbCustomerServiceDTO.java Normal file
View File

@@ -0,0 +1,49 @@
package org.xyzh.api.workcase.dto;
import java.util.List;
import org.xyzh.common.dto.BaseDTO;
import io.swagger.v3.oas.annotations.media.Schema;
import lombok.Data;
/**
* @description 客服人员配置表数据对象DTO
* @filename TbCustomerServiceDTO.java
* @author cascade
* @copyright xyzh
* @since 2025-12-22
*/
@Data
@Schema(description = "客服人员配置表对象")
public class TbCustomerServiceDTO extends BaseDTO {
private static final long serialVersionUID = 1L;
@Schema(description = "员工ID（关联sys用户ID）")
private String userId;
@Schema(description = "员工姓名")
private String username;
@Schema(description = "员工工号")
private String userCode;
@Schema(description = "状态：online-在线 busy-忙碌 offline-离线")
private String status;
@Schema(description = "技能标签")
private List<String> skillTags;
@Schema(description = "最大并发接待数")
private Integer maxConcurrent;
@Schema(description = "当前工作量")
private Integer currentWorkload;
@Schema(description = "累计服务次数")
private Integer totalServed;
@Schema(description = "平均响应时间（秒）")
private Integer avgResponseTime;
@Schema(description = "满意度评分（0-5）")
private Double satisfactionScore;
}

51
urbanLifelineServ/apis/api-workcase/src/main/java/org/xyzh/api/workcase/dto/TbMeetingParticipantDTO.java Normal file
View File

@@ -0,0 +1,51 @@
package org.xyzh.api.workcase.dto;
import org.xyzh.common.dto.BaseDTO;
import io.swagger.v3.oas.annotations.media.Schema;
import lombok.Data;
/**
* @description 会议参与记录表数据对象DTO
* @filename TbMeetingParticipantDTO.java
* @author cascade
* @copyright xyzh
* @since 2025-12-22
*/
@Data
@Schema(description = "会议参与记录表对象")
public class TbMeetingParticipantDTO extends BaseDTO {
private static final long serialVersionUID = 1L;
@Schema(description = "参与记录ID")
private String participantId;
@Schema(description = "会议ID")
private String meetingId;
@Schema(description = "用户ID")
private String userId;
@Schema(description = "用户类型：guest-来客 agent-客服")
private String userType;
@Schema(description = "用户名称")
private String userName;
@Schema(description = "加入时间")
private String joinTime;
@Schema(description = "离开时间")
private String leaveTime;
@Schema(description = "参与时长（秒）")
private Integer durationSeconds;
@Schema(description = "是否主持人")
private Boolean isModerator;
@Schema(description = "加入方式：web-网页 mobile-移动端 desktop-桌面端")
private String joinMethod;
@Schema(description = "设备信息")
private String deviceInfo;
}

76
urbanLifelineServ/apis/api-workcase/src/main/java/org/xyzh/api/workcase/dto/TbVideoMeetingDTO.java Normal file
View File

@@ -0,0 +1,76 @@
package org.xyzh.api.workcase.dto;
import com.alibaba.fastjson2.JSONObject;
import org.xyzh.common.dto.BaseDTO;
import io.swagger.v3.oas.annotations.media.Schema;
import lombok.Data;
/**
* @description 视频会议表数据对象DTO
* @filename TbVideoMeetingDTO.java
* @author cascade
* @copyright xyzh
* @since 2025-12-22
*/
@Data
@Schema(description = "视频会议表对象")
public class TbVideoMeetingDTO extends BaseDTO {
private static final long serialVersionUID = 1L;
@Schema(description = "会议ID")
private String meetingId;
@Schema(description = "关联聊天室ID")
private String roomId;
@Schema(description = "关联工单ID")
private String workcaseId;
@Schema(description = "会议名称")
private String meetingName;
@Schema(description = "会议密码")
private String meetingPassword;
@Schema(description = "JWT Token")
private String jwtToken;
@Schema(description = "Jitsi房间名")
private String jitsiRoomName;
@Schema(description = "Jitsi服务器地址")
private String jitsiServerUrl;
@Schema(description = "状态：scheduled-已安排 ongoing-进行中 ended-已结束 cancelled-已取消")
private String status;
@Schema(description = "创建者ID")
private String creatorId;
@Schema(description = "创建者类型：guest-来客 agent-客服")
private String creatorType;
@Schema(description = "创建者名称")
private String creatorName;
@Schema(description = "参与人数")
private Integer participantCount;
@Schema(description = "最大参与人数")
private Integer maxParticipants;
@Schema(description = "实际开始时间")
private String actualStartTime;
@Schema(description = "实际结束时间")
private String actualEndTime;
@Schema(description = "会议时长（秒）")
private Integer durationSeconds;
@Schema(description = "iframe嵌入URL")
private String iframeUrl;
@Schema(description = "Jitsi配置项")
private JSONObject config;
}

60
urbanLifelineServ/apis/api-workcase/src/main/java/org/xyzh/api/workcase/vo/CustomerServiceVO.java Normal file
View File

@@ -0,0 +1,60 @@
package org.xyzh.api.workcase.vo;
import lombok.Data;
import lombok.EqualsAndHashCode;
import org.xyzh.common.vo.BaseVO;
import io.swagger.v3.oas.annotations.media.Schema;
import java.util.List;
/**
* 客服人员配置VO
* 用于前端展示客服人员信息
*/
@Data
@EqualsAndHashCode(callSuper = true)
@Schema(description = "客服人员配置VO")
public class CustomerServiceVO extends BaseVO {
private static final long serialVersionUID = 1L;
@Schema(description = "员工ID（关联sys用户ID）")
private String userId;
@Schema(description = "员工姓名")
private String username;
@Schema(description = "员工工号")
private String userCode;
@Schema(description = "员工头像")
private String avatar;
@Schema(description = "状态：online-在线 busy-忙碌 offline-离线")
private String status;
@Schema(description = "状态名称")
private String statusName;
@Schema(description = "技能标签")
private List<String> skillTags;
@Schema(description = "最大并发接待数")
private Integer maxConcurrent;
@Schema(description = "当前工作量")
private Integer currentWorkload;
@Schema(description = "累计服务次数")
private Integer totalServed;
@Schema(description = "平均响应时间（秒）")
private Integer avgResponseTime;
@Schema(description = "平均响应时间（格式化）")
private String avgResponseTimeFormatted;
@Schema(description = "满意度评分（0-5）")
private Double satisfactionScore;
@Schema(description = "是否可接待（工作量未满）")
private Boolean isAvailable;
}

19
urbanLifelineServ/workcase/工单+Jitsi Meet技术方案.md
View File

@@ -199,23 +199,8 @@ device_info -- 设备信息
**用途**：管理有客服权限的员工
```sql
agent_id -- 客服ID（关联sys用户ID）
agent_name -- 客服姓名
agent_code -- 客服工号
status -- 状态：online busy offline
skill_tags -- 技能标签（如：电力、燃气、水务）
max_concurrent -- 最大并发接待数
current_workload -- 当前工作量
total_served -- 累计服务次数
avg_response_time -- 平均响应时间（秒）
satisfaction_score -- 满意度评分（0-5）
```
**业务规则**：
- 用于客服负载均衡
- 技能标签用于智能分配
- 实时更新工作量
user_id
username
---
#### 7. **tb_word_cloud** - 词云统计表（已有）

64
urbanLifelineWeb/packages/shared/src/types/workcase/chatRoom.ts
View File

@@ -64,6 +64,48 @@ export interface TbChatRoomMemberDTO extends BaseDTO {
leaveTime?: string
}
/**
* 视频会议DTO
*/
export interface TbVideoMeetingDTO extends BaseDTO {
meetingId?: string
roomId?: string
workcaseId?: string
meetingName?: string
meetingPassword?: string
jwtToken?: string
jitsiRoomName?: string
jitsiServerUrl?: string
status?: string
creatorId?: string
creatorType?: string
creatorName?: string
participantCount?: number
maxParticipants?: number
actualStartTime?: string
actualEndTime?: string
durationSeconds?: number
iframeUrl?: string
config?: Record<string, any>
}
/**
* 会议参与记录DTO
*/
export interface TbMeetingParticipantDTO extends BaseDTO {
participantId?: string
meetingId?: string
userId?: string
userType?: string
userName?: string
joinTime?: string
leaveTime?: string
durationSeconds?: number
isModerator?: boolean
joinMethod?: string
deviceInfo?: string
}
// ==================== VO ====================
/**
@@ -163,6 +205,28 @@ export interface VideoMeetingVO extends BaseVO {
config?: Record<string, any>
}
/**
* 会议参与记录VO
* 用于前端展示会议参与者信息
*/
export interface MeetingParticipantVO extends BaseVO {
participantId?: string
meetingId?: string
userId?: string
userType?: string
userName?: string
userAvatar?: string
joinTime?: string
leaveTime?: string
durationSeconds?: number
durationFormatted?: string
isModerator?: boolean
joinMethod?: string
joinMethodName?: string
deviceInfo?: string
isOnline?: boolean
}
/**
* 发送消息参数
*/

66
urbanLifelineWeb/packages/shared/src/types/workcase/conversation.ts Normal file
View File

@@ -0,0 +1,66 @@
import { BaseVO } from '../base'
// ==================== VO ====================
/**
* 会话VO
* 用于前端展示会话信息
*/
export interface ConversationVO extends BaseVO {
/** 会话ID */
conversationId?: string
/** 客户ID */
customerId?: string
/** 客户姓名 */
customerName?: string
/** 客户头像 */
customerAvatar?: string
/** 会话类型 */
conversationType?: string
/** 会话类型名称 */
conversationTypeName?: string
/** 渠道 */
channel?: string
/** 渠道名称 */
channelName?: string
/** 智能体ID或客服人员ID */
agentId?: string
/** 座席名称 */
agentName?: string
/** 座席类型 */
agentType?: string
/** 座席类型名称 */
agentTypeName?: string
/** 会话开始时间 */
sessionStartTime?: string
/** 会话结束时间 */
sessionEndTime?: string
/** 会话时长（秒） */
durationSeconds?: number
/** 会话时长格式化显示 */
durationFormatted?: string
/** 消息数量 */
messageCount?: number
/** 会话状态 */
conversationStatus?: string
/** 会话状态名称 */
conversationStatusName?: string
/** 会话状态颜色 */
statusColor?: string
/** 满意度评分（1-5星） */
satisfactionRating?: number
/** 满意度反馈 */
satisfactionFeedback?: string
/** 会话摘要 */
summary?: string
/** 会话标签 */
tags?: string[]
/** 会话元数据 */
metadata?: Record<string, any>
/** 最后一条消息内容 */
lastMessageContent?: string
/** 最后一条消息时间 */
lastMessageTime?: string
/** 创建者姓名 */
creatorName?: string
}

133
urbanLifelineWeb/packages/shared/src/types/workcase/customer.ts Normal file
View File

@@ -0,0 +1,133 @@
import { BaseDTO, BaseVO } from '../base'
// ==================== DTO ====================
/**
* 客服人员配置表数据对象DTO
*/
export interface TbCustomerServiceDTO extends BaseDTO {
/** 员工ID（关联sys用户ID） */
userId?: string
/** 员工姓名 */
username?: string
/** 员工工号 */
userCode?: string
/** 状态：online-在线 busy-忙碌 offline-离线 */
status?: string
/** 技能标签 */
skillTags?: string[]
/** 最大并发接待数 */
maxConcurrent?: number
/** 当前工作量 */
currentWorkload?: number
/** 累计服务次数 */
totalServed?: number
/** 平均响应时间（秒） */
avgResponseTime?: number
/** 满意度评分（0-5） */
satisfactionScore?: number
}
// ==================== VO ====================
/**
* 客服人员配置VO
* 用于前端展示客服人员信息
*/
export interface CustomerServiceVO extends BaseVO {
/** 员工ID（关联sys用户ID） */
userId?: string
/** 员工姓名 */
username?: string
/** 员工工号 */
userCode?: string
/** 员工头像 */
avatar?: string
/** 状态：online-在线 busy-忙碌 offline-离线 */
status?: string
/** 状态名称 */
statusName?: string
/** 技能标签 */
skillTags?: string[]
/** 最大并发接待数 */
maxConcurrent?: number
/** 当前工作量 */
currentWorkload?: number
/** 累计服务次数 */
totalServed?: number
/** 平均响应时间（秒） */
avgResponseTime?: number
/** 平均响应时间（格式化） */
avgResponseTimeFormatted?: string
/** 满意度评分（0-5） */
satisfactionScore?: number
/** 是否可接待（工作量未满） */
isAvailable?: boolean
}
/**
* 客户信息VO
* 用于前端展示客户信息
*/
export interface CustomerVO extends BaseVO {
/** 客户ID */
customerId?: string
/** 客户编号 */
customerNo?: string
/** 客户姓名 */
customerName?: string
/** 客户类型 */
customerType?: string
/** 客户类型名称 */
customerTypeName?: string
/** 公司名称 */
companyName?: string
/** 电话 */
phone?: string
/** 邮箱 */
email?: string
/** 微信OpenID */
wechatOpenid?: string
/** 头像URL */
avatar?: string
/** 性别 */
gender?: number
/** 性别名称 */
genderName?: string
/** 地址 */
address?: string
/** 客户等级 */
customerLevel?: string
/** 客户等级名称 */
customerLevelName?: string
/** 客户来源 */
customerSource?: string
/** 客户来源名称 */
customerSourceName?: string
/** 客户标签 */
tags?: string[]
/** 备注 */
notes?: string
/** CRM系统客户ID */
crmCustomerId?: string
/** 最后联系时间 */
lastContactTime?: string
/** 咨询总次数 */
totalConsultations?: number
/** 订单总数 */
totalOrders?: number
/** 总消费金额 */
totalAmount?: number
/** 满意度评分 */
satisfactionScore?: number
/** 状态 */
status?: string
/** 状态名称 */
statusName?: string
/** 状态颜色 */
statusColor?: string
/** 创建者姓名 */
creatorName?: string
/** 更新者姓名 */
updaterName?: string
}

3
urbanLifelineWeb/packages/shared/src/types/workcase/index.ts
View File

@@ -1,2 +1,5 @@
export * from "./workcase"
export * from "./chatRoom"
export * from "./customer"
export * from "./conversation"
export * from "./wordCloud"

19
urbanLifelineWeb/packages/shared/src/types/workcase/wordCloud.ts Normal file
View File

@@ -0,0 +1,19 @@
import { BaseDTO } from '../base'
// ==================== DTO ====================
/**
* 词云表数据对象DTO
*/
export interface TbWordCloudDTO extends BaseDTO {
/** 词条ID */
wordId?: string
/** 词语 */
word?: string
/** 词频 */
frequency?: string
/** 分类 */
category?: string
/** 统计日期 */
statDate?: string
}

8
urbanLifelineWeb/packages/workcase/src/types/shared.d.ts vendored
View File

@@ -145,13 +145,19 @@ declare module 'shared/types' {
TbChatRoomDTO,
TbChatMessageDTO,
TbChatRoomMemberDTO,
TbVideoMeetingDTO,
TbMeetingParticipantDTO,
ChatRoomVO,
ChatMessageVO,
ChatMemberVO,
VideoMeetingVO,
MeetingParticipantVO,
SendMessageParam,
CreateMeetingParam,
MarkReadParam
MarkReadParam,
// 来客相关
TbGuestDTO,
GuestVO
} from '../../../shared/src/types/workcase'
// 重新导出 menu