本次提交包含了大量功能改进与基础优化: 1. 重命名项目标识与前端展示文案,统一为SCC(Sales-Channel-Customer) 2. 新增CRM拓展业务相关DTO、Mapper与服务接口,支持CRM拓展管理 3. 优化签到、日报等业务的biz_type校验,新增crm类型支持 4. 拆分前端Vite打包配置,实现依赖分包优化 5. 新增全局异常处理器,完善资源不存在等场景的错误返回 6. 新增商机查重、仪表盘多卡片批量查询接口 7. 完善渠道拓展、销售拓展的区域覆盖字段支持 8. 新增OMS字典映射服务与回调控制器,实现跨系统数据转换 9. 新增渠道与CRM拓展互转功能,支持业务类型迁移 10. 修复部分前端ECharts按需引入配置,优化打包体积 同时补充了初始化SQL脚本与系统测试记录文档。 |
||
|---|---|---|
| .. | ||
| build/test-uploads/work-report-attachments | ||
| sql | ||
| src | ||
| .dockerignore | ||
| Dockerfile | ||
| README.md | ||
| cp.txt | ||
| pom.xml | ||
| unis-crm-backend-1.0.0-SNAPSHOT.jar | ||
README.md
Backend
当前已经补齐首页所需的 Java 后端基础工程,并调整为常规 Spring Boot 单体项目目录结构,技术栈如下:
- Java 17
- Spring Boot 3.2.2
- MyBatis Plus 3.5.6
- PostgreSQL
- Redis
已实现内容
- 首页聚合接口:
GET /api/dashboard/home - 首页欢迎信息:姓名、职位、部门、入职天数
- 首页统计卡片
- 首页待办列表
- 首页最新动态
- 通用响应体与全局异常处理
目录结构
backend/
├── pom.xml
└── src/main
├── java/com/unis/crm
│ ├── common
│ ├── controller
│ ├── dto
│ ├── mapper
│ ├── service
│ └── UnisCrmBackendApplication.java
└── resources
├── application.yml
└── mapper/dashboard
启动前准备
- 初始化数据库:
psql -h 127.0.0.1 -U postgres -d nex_auth -f sql/init_full_pg17.sql
-
如果是全新环境,先准备基础框架(
unisbase)相关表与基础数据,再执行上面的 CRM 脚本。 -
详细部署顺序见:
启动项目
cd backend
mvn spring-boot:run
默认启动在 8080 端口,供前端开发环境通过 Vite 代理访问。
首页接口
请求示例:
curl -H "X-User-Id: 1" "http://127.0.0.1:8080/api/dashboard/home"
首页接口只允许查询当前登录用户自己的数据,必须通过 X-User-Id 传入当前用户ID,不支持指定其他用户查询。