70 lines
1.6 KiB
Markdown
70 lines
1.6 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_full_pg17.sql
|
||
```
|
||
|
||
2. 如果是全新环境，先准备基础框架（`unisbase`）相关表与基础数据，再执行上面的 CRM 脚本。
|
||
|
||
3. 详细部署顺序见：
|
||
|
||
- [docs/deployment-guide.md](/Users/kangwenjing/Downloads/crm/unis_crm/docs/deployment-guide.md)
|
||
|
||
## 启动项目
|
||
|
||
```bash
|
||
cd backend
|
||
mvn spring-boot:run
|
||
```
|
||
|
||
默认启动在 `8080` 端口，供前端开发环境通过 Vite 代理访问。
|
||
|
||
## 首页接口
|
||
|
||
请求示例：
|
||
|
||
```bash
|
||
curl -H "X-User-Id: 1" "http://127.0.0.1:8080/api/dashboard/home"
|
||
```
|
||
|
||
首页接口只允许查询当前登录用户自己的数据，必须通过 `X-User-Id` 传入当前用户ID，不支持指定其他用户查询。
|