unis_crm/backend/README.md

# 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，不支持指定其他用户查询。