# CampusLostFound

**Repository Path**: qin-mingwang/campus-lost-found

## Basic Information

- **Project Name**: CampusLostFound
- **Description**: SpringBoot +  Vue3 项目实践
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-04-24
- **Last Updated**: 2026-05-31

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# CampusLostFound - 校园失物招领系统

一个基于 Spring Boot + Vue3 的现代化校园失物招领平台，帮助师生快速发布、查找和认领失物。

## 项目架构

```
CampusLostFound/
├── code/springboot/          # Spring Boot 后端服务
│   └── 用户管理、资源管理、失物招领核心业务
├── prototype/
│   ├── admin/               # 管理后台前端 (Vue3)
│   └── user/                # 用户端前端 (Vue3)
├── docs/                    # 项目文档
└── README.md               # 项目说明
```

## 技术栈

### 后端 (Spring Boot)
- **框架**: Spring Boot 3.x
- **安全**: Spring Security + JWT
- **数据库**: MySQL + MyBatis-Plus
- **缓存**: Redis
- **文档**: Swagger / SpringDoc OpenAPI
- **构建工具**: Maven

### 前端 (Vue3)
- **框架**: Vue 3 + TypeScript
- **构建工具**: Vite
- **UI 组件**: Element Plus
- **状态管理**: Pinia
- **路由**: Vue Router
- **HTTP 客户端**: Axios
- **代码规范**: ESLint + Prettier

## 核心功能

### 用户端
- 失物发布（丢失/拾取）
- 失物搜索与筛选
- 失物详情查看
- 认领申请与审核
- 个人中心管理
- 消息通知

### 管理后台
- 用户管理
- 失物信息管理
- 认领审核
- 数据统计分析
- 系统配置
- 公告管理

## 快速开始

### 环境要求
- JDK 17+
- Node.js 18+
- MySQL 8.0+
- Redis 6.0+
- Maven 3.8+
- pnpm 8+

### 后端启动
```bash
cd code/springboot
mvn clean install
mvn spring-boot:run
```

### 管理后台启动
```bash
cd prototype/admin
pnpm install
pnpm dev
```

### 用户端启动
```bash
cd prototype/user
pnpm install
pnpm dev
```

## 项目文档

- [开发路线图](docs/roadmap.md) - 项目开发阶段规划
- [后端文档](code/springboot/README.md) - 后端 API 文档
- [管理后台文档](prototype/admin/README.md) - 管理前端开发指南
- [用户端文档](prototype/user/README.md) - 用户前端开发指南

## 开发规范

- 遵循 RESTful API 设计规范
- 前后端分离，通过 JSON 交互
- 统一响应格式
- 代码提交前需通过 ESLint 检查
- 分支管理采用 Git Flow 工作流

## 许可证

[MIT License](LICENSE)

## 贡献者

欢迎提交 Issue 和 Pull Request 参与项目贡献。