# Smart Office（智能办公管理系统）

本仓库已根据需求文档完成 v1.0（MVP）完整实现，包含 **后端 Spring Boot** 与 **前端 React**。MVP 聚焦“可运行、可演示、流程闭环”的核心能力。

## 已实现范围（v1.0）
- 认证与权限：JWT + 角色分级（管理员/经理/员工）
- 用户管理：用户新增、查询、状态管理
- 考勤管理：上班/下班打卡、个人考勤记录
- 请假审批：请假申请、审批通过/拒绝
- 通知服务：站内通知（审批结果）

## 目录结构
```
backend/   # Spring Boot 3.2 后端
frontend/  # React 18 + Vite 前端
plans/     # 需求/架构/数据库文档
scripts/   # 数据库初始化脚本（MySQL）
```

## 启动方式

### 后端
```bash
cd backend
mvn spring-boot:run
```
- 默认使用 H2 内存数据库，访问控制台：`http://localhost:8080/h2`
- Swagger: `http://localhost:8080/swagger`

可切换 MySQL：
```bash
mvn spring-boot:run -Dspring-boot.run.profiles=mysql
```

### 前端
```bash
cd frontend
npm install
npm run dev
```
访问：`http://localhost:5173`

如后端运行在非 8080 端口（例如 8081），可在前端设置代理目标：
```bash
# macOS/Linux
VITE_PROXY_TARGET=http://localhost:8081 npm run dev

# Windows PowerShell
$env:VITE_PROXY_TARGET="http://localhost:8081"; npm run dev
```

也可以直接配置 API Base（绕过代理）：
```bash
# macOS/Linux
VITE_API_BASE=http://localhost:8081/api/v1 npm run dev

# Windows PowerShell
$env:VITE_API_BASE="http://localhost:8081/api/v1"; npm run dev
```

## 默认账号
- 管理员：admin / admin123
- 经理：manager / manager123
- 员工：employee / employee123

## 前端外观
- 登录页背景图文件：`frontend/public/login-bg.jpg`（可替换为自定义图片）

## 需求文档
见 `plans/project_requirements_document.md`，已在 v1.0 标注了 MVP 交付边界与后续迭代项。