66 lines
1.5 KiB
Markdown
66 lines
1.5 KiB
Markdown
# Backend
|
||
|
||
当前已经补齐首页所需的 Java 后端基础工程，并调整为常规 Spring Boot 单体项目目录结构，技术栈如下：
|
||
|
||
- Java 17
|
||
- Spring Boot 3.2.2
|
||
- MyBatis Plus 3.5.6
|
||
- PostgreSQL
|
||
- Redis
|
||
|
||
## 已实现内容
|
||
|
||
- 首页聚合接口：`GET /api/dashboard/home`
|
||
- 首页欢迎信息：姓名、职位、部门、入职天数
|
||
- 首页统计卡片
|
||
- 首页待办列表
|
||
- 首页最新动态
|
||
- 通用响应体与全局异常处理
|
||
|
||
## 目录结构
|
||
|
||
```text
|
||
backend/
|
||
├── pom.xml
|
||
└── src/main
|
||
├── java/com/unis/crm
|
||
│ ├── common
|
||
│ ├── controller
|
||
│ ├── dto
|
||
│ ├── mapper
|
||
│ ├── service
|
||
│ └── UnisCrmBackendApplication.java
|
||
└── resources
|
||
├── application.yml
|
||
└── mapper/dashboard
|
||
```
|
||
|
||
## 启动前准备
|
||
|
||
1. 执行数据库脚本：
|
||
|
||
```bash
|
||
psql -h 127.0.0.1 -U postgres -d nex_auth -f sql/init_pg17.sql
|
||
```
|
||
|
||
2. 确保 `sys_user`、`work_todo`、`sys_activity_log`、`crm_customer`、`crm_opportunity`、`work_checkin` 中有业务数据。
|
||
|
||
## 启动项目
|
||
|
||
```bash
|
||
cd backend
|
||
mvn spring-boot:run
|
||
```
|
||
|
||
默认启动在 `8081` 端口，供前端开发环境通过 Vite 代理访问；`8080` 可继续保留给现有认证/系统服务。
|
||
|
||
## 首页接口
|
||
|
||
请求示例：
|
||
|
||
```bash
|
||
curl -H "X-User-Id: 1" "http://127.0.0.1:8081/api/dashboard/home"
|
||
```
|
||
|
||
首页接口只允许查询当前登录用户自己的数据，必须通过 `X-User-Id` 传入当前用户ID，不支持指定其他用户查询。
|