工单短信触达需求文档

// 核心字段
- orderId: 工单ID
- orderType: 工单类型（12378、监管转办、消保转送、咨询等）
- contactName: 联系人姓名
- contactPhone: 联系人电话
- complainantPhone: 投诉人电话
- mainOrg: 主办机构（总行/信用卡中心/分行/其他）
- mainOperator: 主办人员
- isSmsReply: 是否短信回复（是/否）
- smsReplyTime: 回复时间
- isSmsVisit: 是否短信回访（是/否）
- visitDate: 回访日期
- visitTime: 回访时间
- visitResult: 回访效果（满意/不满意）
- processNotifyType: 处理决定告知方式（短信/其他）
- processNotifyTime: 处理决定告知时间

- smsId: 短信记录ID
- orderId: 关联工单
- smsType: 短信类型（受理通知/结案通知/回访）
- templateId: 短信模板
- phone: 发送手机号
- customerName: 客户姓名
- sendTime: 短信发送时间
- sendOperator: 发送人
- replyContent: 客户回复内容
- replyTime: 客户回复时间

- templateId: 模板ID
- templateName: 模板名称
- templateContent: 模板内容
- templateType: 类型（受理/结案/回访）
- approvedStatus: 业务审核状态
- visibleRoles: 可见角色（总行/分行）
- enabled: 是否启用

// 测试类：OrderCreatedEventListenerTest
@Test
void test_工单创建后自动发送受理短信_成功() {
    // Given: 创建工单事件，联系人为手机号
    // When: 触发事件监听
    // Then: 验证短信发送服务被调用，记录已保存
}

@Test
void test_工单创建后自动发送受理短信_非手机号跳过() {
    // Given: 创建工单事件，联系人为座机
    // When: 触发事件监听
    // Then: 验证短信发送服务未被调用，记录日志
}

@Test
void test_工单创建后自动发送受理短信_发送失败重试() {
    // Given: 短信网关首次调用失败
    // When: 触发重试机制
    // Then: 验证重试3次，最终记录失败状态
}

@Test
void test_短信模板加载_模板不存在() {
    // Given: 受理短信模板未配置
    // When: 尝试加载模板
    // Then: 抛出业务异常，记录错误日志
}

// 测试类：OrderSmsReplyControllerTest
@Test
void test_发送短信回复_成功() {
    // Given: 工单存在，未发送过短信，模板已审核
    // When: 调用短信回复接口
    // Then: 验证短信发送成功，工单状态已更新
}

@Test
void test_发送短信回复_工单已发送过短信() {
    // Given: 工单已发送过短信回复
    // When: 再次调用短信回复接口
    // Then: 返回业务异常："每个工单仅允许发送一次"
}

@Test
void test_发送短信回复_手机号不一致() {
    // Given: 请求中的手机号与工单联系人手机号不一致
    // When: 调用短信回复接口
    // Then: 返回参数校验异常
}

@Test
void test_发送短信回复_模板未审核() {
    // Given: 选择的模板审核状态为"待审核"
    // When: 调用短信回复接口
    // Then: 返回业务异常："模板未审核通过"
}

@Test
void test_发送短信回复_无权限() {
    // Given: 当前用户无派单处理权限
    // When: 调用短信回复接口
    // Then: 返回权限异常
}

// 测试类：TemplateVisibilityFilterTest
@Test
void test_模板可见性过滤_总行角色() {
    // Given: 当前用户为总行角色
    // When: 获取可用模板列表
    // Then: 仅返回总行模板
}

@Test
void test_模板可见性过滤_分行角色() {
    // Given: 当前用户为分行角色
    // When: 获取可用模板列表
    // Then: 仅返回分行模板
}

// 测试类：OrderClosedEventListenerTest
@Test
void test_工单结案后自动发送回访短信_满足条件() {
    // Given: 工单结案，isSmsVisit=true，联系电话为手机号
    // When: 触发结案事件
    // Then: 验证回访短信已发送
}

@Test
void test_工单结案后自动发送回访短信_不满足条件() {
    // Given: 工单结案，isSmsVisit=false
    // When: 触发结案事件
    // Then: 验证回访短信未发送
}

// 测试类：SmsReplyHandlerTest
@Test
void test_处理客户回复_BMY表示不满意() {
    // Given: 收到客户回复"BMY"
    // When: 处理回复
    // Then: 验证回访效果更新为"不满意"，回访日期时间已更新
}

@Test
void test_处理客户回复_非BMY内容() {
    // Given: 收到客户回复"谢谢"
    // When: 处理回复
    // Then: 验证回访效果未更新（保持原值或默认值）
}

@Test
void test_处理客户回复_仅统计首次回复() {
    // Given: 已处理过首次回复
    // When: 收到第二次回复
    // Then: 验证第二次回复被忽略，不更新回访效果
}

@Test
void test_处理客户回复_超过有效期() {
    // Given: 回访短信发送时间超过3天
    // When: 收到客户回复
    // Then: 验证回复被忽略，记录过期日志
}

// 测试类：VisitValidityCheckerTest
@Test
void test_回访有效期校验_在有效期内() {
    // Given: 发送时间T，当前时间T+2天
    // When: 校验有效期
    // Then: 返回true
}

@Test
void test_回访有效期校验_超过有效期() {
    // Given: 发送时间T，当前时间T+4天
    // When: 校验有效期
    // Then: 返回false
}

// 测试类：ComplaintOrderServiceTest
@Test
void test_12378工单_主办机构为总行时默认主办人员() {
    // Given: 创建12378工单，主办机构=总行，当前经办人=张三
    // When: 保存工单
    // Then: 验证主办人员自动填充为"张三"，支持手动修改
}

@Test
void test_12378工单_回复时间必填校验() {
    // Given: 12378工单，isSmsReply=是，回复时间为空
    // When: 保存工单
    // Then: 返回字段校验异常："回复时间必填"
}

@Test
void test_消保转送工单_处理决定告知方式为短信() {
    // Given: 消保转送工单，处理决定告知方式选择"是（短信）"
    // When: 发送短信后保存工单
    // Then: 验证告知方式显示为"短信"，告知时间已填充
}

// 测试类：DynamicFormFieldControllerTest
@Test
void test_字段显示控制_转办类型为转办时显示投诉转办部门() {
    // Given: 监管转办工单，转办类型="转办"
    // When: 获取表单字段配置
    // Then: 验证"投诉转办部门"字段可见
}

@Test
void test_字段显示控制_流程处理方式为本节点处理时显示情况表() {
    // Given: 监管转办工单，流程处理方式="本节点处理"
    // When: 获取表单字段配置
    // Then: 验证"机构投诉办理情况表"字段可见
}

// 测试类：ThroughputRateCalculatorTest
@Test
void test_总直通率计算() {
    // Given: 工单总量100，各主办机构工单量80
    // When: 计算总直通率
    // Then: 验证结果=80%
}

@Test
void test_总行直通率计算() {
    // Given: 工单总量100，总行工单30，信用卡中心工单20
    // When: 计算总行直通率
    // Then: 验证结果=(30+20)/100=50%
}

@Test
void test_分行直通率计算() {
    // Given: 分行经办过的工单：分行50，其他10
    // When: 计算分行直通率
    // Then: 验证结果=50/(50+10)=83.33%
}

@Test
void test_直通率分类_总行直通() {
    // Given: 主办机构=总行
    // When: 判断直通类型
    // Then: 验证返回"总行直通"
}

@Test
void test_直通率分类_分行直通() {
    // Given: 主办机构=分行
    // When: 判断直通类型
    // Then: 验证返回"分行直通"
}

@Test
void test_直通率分类_非直通() {
    // Given: 主办机构=其他
    // When: 判断直通类型
    // Then: 验证返回"非直通"
}

// 测试类：OrderStatisticsServiceTest
@Test
void test_按主办机构统计工单量() {
    // Given: 数据库中存在不同主办机构的工单
    // When: 调用统计服务
    // Then: 验证按主办机构正确分组统计
}

@Test
void test_统计查询_时间范围筛选() {
    // Given: 设置时间范围2024-01-01至2024-01-31
    // When: 调用统计服务
    // Then: 验证仅统计该时间范围内的工单
}

CREATE TABLE complaint_order (
    order_id VARCHAR(64) PRIMARY KEY,
    order_type VARCHAR(32) NOT NULL,
    contact_name VARCHAR(64),
    contact_phone VARCHAR(32),
    complainant_phone VARCHAR(32),
    main_org VARCHAR(32),
    main_operator VARCHAR(64),
    is_sms_reply CHAR(1) DEFAULT 'N',
    sms_reply_time DATETIME,
    is_sms_visit CHAR(1) DEFAULT 'N',
    visit_date DATE,
    visit_time DATETIME,
    visit_result VARCHAR(16),
    process_notify_type VARCHAR(16),
    process_notify_time DATETIME,
    created_time DATETIME DEFAULT CURRENT_TIMESTAMP,
    updated_time DATETIME DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP
);

CREATE TABLE sms_record (
    sms_id VARCHAR(64) PRIMARY KEY,
    order_id VARCHAR(64) NOT NULL,
    sms_type VARCHAR(16) NOT NULL,
    template_id VARCHAR(64),
    phone VARCHAR(32) NOT NULL,
    customer_name VARCHAR(64),
    send_time DATETIME NOT NULL,
    send_operator VARCHAR(64),
    send_status VARCHAR(16) NOT NULL,
    reply_content TEXT,
    reply_time DATETIME,
    validity_end_time DATETIME,
    created_time DATETIME DEFAULT CURRENT_TIMESTAMP,
    INDEX idx_order_id (order_id),
    INDEX idx_phone (phone),
    INDEX idx_send_time (send_time)
);

CREATE TABLE sms_template (
    template_id VARCHAR(64) PRIMARY KEY,
    template_name VARCHAR(128) NOT NULL,
    template_content TEXT NOT NULL,
    template_type VARCHAR(16) NOT NULL,
    approved_status VARCHAR(16) NOT NULL,
    visible_roles VARCHAR(128),
    enabled CHAR(1) DEFAULT 'Y',
    created_time DATETIME DEFAULT CURRENT_TIMESTAMP,
    updated_time DATETIME DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP
);