1. 项目背景与核心价值
这个基于SpringBoot的企业客户信息反馈平台(zypuo)是我去年为一家中型制造企业实施的内部系统改造项目。当时企业面临的最大痛点在于：销售部门收集的客户反馈分散在Excel、邮件甚至纸质表单中，技术部门无法及时获取产品改进需求，售后团队也难以跟踪问题处理进度。
传统制造业在数字化转型过程中，客户反馈管理往往是最容易被忽视的环节。我们设计的这个平台实现了三大核心价值：
- 统一入口：整合微信、邮件、官网等多渠道反馈
- 闭环处理：从问题录入到解决的全流程追踪
- 数据分析：自动生成客户满意度报告和产品缺陷热力图
2. 技术架构设计解析
2.1 整体技术栈选型
采用经典的SpringBoot+Vue前后端分离架构，具体技术矩阵如下：
| 层级 | 技术选型 | 选型理由 |
|---|---|---|
| 前端 | Vue2 + ElementUI | 企业级UI组件库，快速构建管理后台界面 |
| 后端 | SpringBoot 2.7 + MyBatis | 简化配置，与旧系统JDBC兼容 |
| 数据库 | MySQL 8.0 | 支持JSON字段存储非结构化反馈数据 |
| 消息队列 | RabbitMQ | 处理高并发场景下的反馈提交 |
| 文件存储 | MinIO | 自建对象存储服务，节省云存储成本 |
| 部署 | Docker Compose | 一键部署所有服务，适应企业本地化部署需求 |
特别说明：没有选用更新的SpringBoot3是因为企业现有服务器仍运行JDK8，技术选型必须考虑客户实际环境。
2.2 核心模块设计
系统包含6个关键业务模块：
- 多渠道接入层：通过Nginx配置统一API网关
- 反馈处理引擎：包含自动分类、优先级计算等算法
- 工单流转系统：基于状态机实现处理流程可视化
- 数据看板：使用ECharts实现动态报表
- 权限管理：RBAC模型+部门数据隔离
- 消息通知：集成邮件、短信、企业微信
3. 关键实现细节
3.1 智能工单分配算法
// 基于反馈内容的关键词匹配算法 public class FeedbackClassifier { private static final Map<String, Integer> KEYWORD_WEIGHTS = Map.of( "质量", 5, "交货", 3, "服务", 2 ); public int calculatePriority(String content) { return KEYWORD_WEIGHTS.entrySet().stream() .filter(e -> content.contains(e.getKey())) .mapToInt(Map.Entry::getValue) .sum(); } }3.2 数据库表结构设计
核心的工单表设计考虑了扩展性：
CREATE TABLE `feedback_ticket` ( `id` bigint NOT NULL AUTO_INCREMENT, `customer_id` varchar(32) NOT NULL COMMENT '客户编码', `content` json NOT NULL COMMENT '结构化反馈内容', `attachments` json DEFAULT NULL COMMENT '附件信息', `priority` tinyint DEFAULT '0' COMMENT '0-低 1-中 2-高', `status` enum('pending','processing','resolved','rejected') DEFAULT 'pending', `created_at` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP, PRIMARY KEY (`id`), KEY `idx_customer` (`customer_id`), KEY `idx_status` (`status`) ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;4. 部署实战经验
4.1 生产环境配置要点
在application-prod.yml中需要特别注意：
spring: datasource: hikari: maximum-pool-size: 20 # 根据服务器CPU核心数调整 connection-timeout: 30000 rabbitmq: listener: simple: concurrency: 5 # 消息队列消费者线程数 max-concurrency: 104.2 性能优化技巧
通过JMeter压测发现的三个关键优化点：
- 添加Nginx缓存静态资源
- 开启MyBatis二级缓存
- 对工单列表接口添加@Cacheable注解
5. 典型问题解决方案
5.1 文件上传失败排查
常见错误场景：
- MinIO桶权限未设置public-read
- Nginx配置client_max_body_size过小
- 前端未正确设置Content-Type
5.2 工单状态不同步
分布式环境下的解决方案：
- 引入Redis分布式锁
- 采用最终一致性策略
- 添加状态变更日志表
6. 系统界面展示
前端采用经典的左右布局：
- 左侧导航菜单
- 顶部面包屑导航
- 中部工单列表采用卡片式设计
- 右侧快捷操作面板
具体实现了：
- 拖拽排序功能
- 批量操作菜单
- 自定义列显示
- 高级筛选器
7. 论文文档要点
配套的万字技术文档包含：
- 系统需求分析（含UML用例图）
- 数据库ER图设计
- 核心算法流程图
- 压力测试报告
- 安全审计方案
实际开发中我们发现，制造业客户特别关注这两个文档：
- 数据备份恢复手册
- 系统操作培训视频
这个项目给我最深的体会是：企业级系统开发必须平衡技术先进性和落地实用性。比如我们最终放弃了Elasticsearch搜索方案，改用MySQL全文索引，虽然性能有所下降，但大幅降低了运维复杂度。
