校园失物招领系统面向校园里的拾物登记和物品寻找场景。捡到物品的人发布失物信息，丢失物品的人查看招领内容或提交寻物启事，双方通过页面信息和留言进一步沟通。项目由 Spring Boot 后端、uni-app 小程序前端和管理后台组成。
项目配套 Java 后端、uni-app 前端、Vue 管理后台、MySQL 数据库脚本与设计论文，可结合业务页面、接口和数据表理解功能实现。
一、项目概况
| 项目名称 | 校园失物招领系统 |
|---|---|
| 资源编号 | MINI002 |
| 主要角色 | 用户、管理员 |
| 后端技术 | Java 8、Spring Boot 2.2.2.RELEASE、MyBatis-Plus |
| 前端与数据 | uni-app 小程序、Vue 2 管理后台、MySQL |
| 工程形式 | Maven 后端工程，配套小程序及管理端源码 |
| 业务范围 | 失物信息、寻物启事、物品状态、寻物留言、论坛与公告 |
二、小程序端：区分拾到物品与寻找物品
失物信息保存物品名称、编号、类型、图片、拾取时间、拾取地址、发布用户及详细介绍，并设有状态字段。用户通过名称与分类查找相关记录，打开详情核对物品外观、时间和地点，减少仅凭一个标题寻找物品的局限。
寻物启事使用独立的数据结构，记录物品名称、图片、丢失时间、丢失地址、类型和状态。寻物留言关联具体启事与用户，同时保存留言和回复内容。发布者可以围绕某一条寻物信息集中接收线索，交流内容不会与其他物品混在一起。
三、管理端：维护信息与公共交流内容
管理员负责失物信息、寻物启事、用户资料及基础分类维护。列表页提供检索与记录管理入口，物品照片和详情用于补充识别信息，状态字段用于表达处理阶段。学习时可以重点比较两类物品表单的相似处，以及拾取地点和丢失地点的业务差别。
公共论坛承载校园交流，公告信息用于发布平台说明和通知。论坛的父级关系用来组织帖子与回复，公告按类型管理。用户资料与物品发布记录通过用户标识关联，方便理解当前登录用户与信息归属之间的关系。
四、业务结构：双向信息发布与定向留言
项目的核心是两条互补的信息流：一条从拾物者发布的招领信息开始，另一条从失主发布的寻物启事开始。两类记录分别管理，使表单字段和筛选条件保持清楚；寻物留言则把沟通内容绑定到具体启事。
阅读代码时可以沿着物品列表、详情、发布表单与留言接口逐步查看，结合用户标识、类型字典与状态值理解查询条件。演示时可分别准备一条失物信息和一条寻物启事，用两个测试账号核对发布归属与留言回复，重点观察前后端数据是否一致。
五、技术结构与学习重点
后端采用 Spring Boot 组织接口，业务代码按控制器、服务、数据访问与实体分层，MyBatis-Plus 配合映射文件完成数据库操作。管理端使用 Vue 2 与 Element UI，小程序端由 uni-app 页面、路由配置和公共请求方法组成，两端通过接口访问同一套业务数据。
建议选择一条完整业务链来阅读：失物列表—寻物启事—物品详情—留言与回复。从前端页面找到请求，再对应控制器、服务方法和表字段，观察新增、查询和状态更新分别发生在哪里。类型字典、当前用户标识及文件地址是联调时需要一起关注的内容。
六、部署入口与配置位置
- 以
shiwuzhaolingon/pom.xml导入 Maven 工程。项目配置使用 Java 8 与 Spring Boot 2.2.2.RELEASE，先完成依赖加载。 - 创建 MySQL 数据库并导入工程中的
db.sql，修改src/main/resources/application.yml内的数据库连接、账号和端口。默认接口上下文为/shiwuzhaolingon。 - 管理端源码位于
src/main/resources/admin/admin，依据其 package.json 安装依赖并运行npm run serve，同步调整接口请求地址。 - 小程序源码位于
src/main/resources/front/front，可在 HBuilderX 中打开，核对 manifest.json、pages.json 和公共请求地址，再编译到微信开发者工具。AppID 使用自己的小程序配置。
先确认后端接口与图片等静态资源能访问，再分别登录相关角色，按上述业务链验证新增、查询与处理结果。真机访问时需要使用手机可达的后端地址，并同步核对小程序的域名配置。通用环境准备步骤可从网站导航中的“部署教程”进入查看。
七、配套资料清单
- 项目源码：shiwuzhaolingon，包含 Java 后端、uni-app 小程序前端与 Vue 管理端。
- 数据库：MySQL 数据库脚本
db.sql。 - 设计论文：基于uniapp+springboot的校园失物招领系统的设计与实现论文.doc。
