# cangku

**Repository Path**: djj2004/cangku

## Basic Information

- **Project Name**: cangku
- **Description**: 00000000000
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: codex/campus-sorting-backend-v2
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-03-12
- **Last Updated**: 2026-03-12

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 校园快递分拣系统（前后端）

项目包含：
- `backend/`：Spring Boot 后端（JWT、RBAC、业务流转、调度、报表、监控）
- `frontend/`：React + TypeScript 管理端（登录、包裹、设备、调度、报表、权限、日志）

## 技术栈
- 后端：Java 17, Spring Boot 3.3, Spring Security, JPA, Flyway, MySQL, Redis, WebSocket, OpenAPI
- 前端：React 18, TypeScript, Vite

## 快速启动

### 1. Docker Compose（推荐）
```bash
docker compose up --build
```

启动后访问：
- 前端控制台：`http://localhost:5173`
- 后端接口：`http://localhost:8080`
- Swagger：`http://localhost:8080/swagger-ui.html`

### 2. 本地分开启动

后端：
```bash
cd backend
mvn spring-boot:run
```

前端：
```bash
cd frontend
npm install
npm run dev
```

## 默认账号
- 管理员：`admin`
- 密码：`admin123`

## 已实现前端页面
- 登录页
- 总览页（效率/准确率/健康）
- 包裹管理（查询、单条入库、批量入库、异常标记、OCR修正、状态推进）
- 设备管理（注册、维护切换、信息更新）
- 调度中心（创建任务、上报事件、任务列表）
- 报表中心（效率、OCR准确率、设备负载、格口使用率）
- 用户权限（管理员账号管理、角色权限配置）
- 日志监控（操作日志、AI调用日志、系统健康）

## 后端关键接口
- 认证：`/api/v1/auth/login`, `/api/v1/auth/refresh`
- 用户：`/api/v1/users/me`
- 管理员：`/api/v1/admin/users`, `/api/v1/admin/roles/{roleId}/permissions`
- 包裹：`/api/v1/packages`, `/api/v1/packages/batch`, `/api/v1/packages/{id}/confirm-delivery`
- 异常：`/api/v1/packages/{id}/exceptions`
- 设备：`/api/v1/agents`, `/api/v1/agents/{id}/maintenance`
- 调度：`/api/v1/dispatch/tasks`, `/api/v1/dispatch/events`
- 报表：`/api/v1/reports/efficiency`, `/api/v1/reports/ocr-accuracy`, `/api/v1/reports/agent-load`, `/api/v1/reports/slot-usage`
- 监控：`/actuator/health`, `/actuator/metrics`, `/api/v1/monitor/health`