# 5-闲置物品交易系统 - 功能说明
# 项目概述
面向用户之间闲置物品流转的平台，支持付费交易与免费领取两种模式，同时提供评论、交易评价、收藏、关注、私信和举报功能。系统设管理员与用户两类登录角色。
# 项目概览
# 创新点
- 双交易模式：付费交易使用订单，免费赠送使用领取记录，业务记录分开维护。
- 用户关系与物品互动：收藏对应物品，关注对应用户，消息用于双方沟通。
- 社区治理：评论与交易评价分开记录，举报用于违规内容处理。
# 项目亮点
- 角色分工：提供管理员、用户等业务入口。
- 业务数据组织：主初始化脚本包含 13 张表，围绕该系统的核心对象与业务记录建模。
- 前后端分离：前端负责页面交互，后端通过控制器、服务与数据映射层提供接口。
- 操作体验：提供列表查询、表单编辑、状态展示及个人资料维护入口。
# 管理员
# 系统资料
维护管理员、用户、公告与物品分类。
# 物品管理
查询和维护物品信息、交易类型与上下架状态。
# 交易管理
维护付费订单及免费领取记录。
# 互动治理
管理评价、评论、收藏、关注、消息和举报记录。
# 用户
# 闲置发布
发布与维护物品，选择免费或付费交易类型。
# 物品浏览
查看物品详情、价格、描述及发布人信息。
# 付费订单
提交购买订单，查看支付状态、确认收货并评价。
# 免费领取
提交领取申请，查询确认结果并确认完成。
# 社交互动
收藏物品、关注用户、发布评论、发送消息和提交举报。
# 个人记录
查看我的物品、订单、领取、收藏、关注、消息、评价和举报。
# 功能权限对照表
下表说明当前菜单与业务入口分工。“—”表示未列为该角色的常规入口；不代表已对每个接口完成权限安全审计。
| 功能模块 | 管理员 | 用户 |
|---|---|---|
| 账号、分类及公告 | 管理 | 浏览公告 |
| 闲置物品 | 后台管理 | 发布维护 |
| 付费订单 | 后台管理 | 购买及交易处理 |
| 免费领取 | 后台管理 | 申请及确认 |
| 评论、关注、私信 | 后台管理 | 参与互动 |
| 举报 | 处理 | 提交查询 |
# 业务状态说明
- 物品：上架、下架、已交易；交易类型为免费或付费。
- 付费订单：待支付、已支付、已完成、已取消。
- 领取记录：待确认、已确认、已完成、已取消。
- 举报：待处理、已处理、已驳回。
# 默认账号
以下为主初始化 SQL 中能够核实的示例账号；需先导入对应脚本。这里不把脚本初始值视为当前运行数据库的实际账号或余额。
| 登录角色 | 角色标识 | 用户名 | 初始密码 |
|---|---|---|---|
| 管理员 | ADMIN | admin | 123456 |
| 用户 | USER | user1 | 123456 |
# 核心业务流程
# 付费交易
- 浏览付费物品。
- 填写联系及交付信息。
- 创建订单。
- 页面确认支付。
- 确认收货。
- 发表评价。
# 免费领取
- 浏览免费物品。
- 提交领取申请。
- 等待确认。
- 完成物品交接。
- 确认完成。
# 互动流程
- 查看物品。
- 收藏或关注发布人。
- 评论、私信咨询。
- 必要时提交举报。
# 技术说明
# 系统架构
| 项目 | 当前源码配置 |
|---|---|
| Vue | ^3.4.29 |
| Element Plus | ^2.8.4 |
| Pinia | ^2.2.2 |
| Axios | ^1.7.5 |
| Vite | ^5.3.1 |
| Spring Boot | 3.2.10 |
| Java | 17 |
| MyBatis 集成组件 | 3.0.4 |
| 数据库 | MySQL；具体运行版本以实际部署为准 |
| 身份认证 | JWT；通过登录接口生成令牌 |
前端版本按 package.json 中的声明范围记录，不将依赖范围等同于已安装的精确版本。
# 访问地址
- 后端接口：http://localhost:1000 (opens new window)，对应服务端端口配置。
- 前端开发页面：http://localhost:5173 (opens new window)，项目未显式覆盖 Vite 默认端口，实际以启动日志为准。
- 登录入口：前端
/login；管理端基础路由/admin。
# 数据库
- 配置数据库名：
a_2026_5_idle_item_trading_system。 - 主初始化脚本：
sql/sql.sql。 - 主脚本建表数量：13 张，仅统计当前主脚本的 CREATE TABLE，不包含临时 SQL、迁移脚本或运行时改动。
- 字符集：主脚本采用 utf8mb4。
- 数据表清单：
admin、category、claim_record、collect、comment、follow、item、message、notice、order_info、report、review、user。
# 文件上传
- 上传接口：
POST /file/upload。 - 文件访问：
GET /file/{fileName}。 - 配置限制：单文件 100MB，单次请求 1000MB。
- 使用范围：根据业务页面上传图片或附件；具体允许类型以对应上传组件配置为准。
# 系统特色
# 双交易模式
付费交易使用订单，免费赠送使用领取记录，业务记录分开维护。
# 用户关系与物品互动
收藏对应物品，关注对应用户，消息用于双方沟通。
# 社区治理
评论与交易评价分开记录，举报用于违规内容处理。
# 当前实现说明
- 系统没有独立商家角色，用户自行承担物品发布与购买身份。
- 支付方式字段包含微信支付、支付宝或现金等选项，但字段和状态修改不能视为已接入第三方支付网关。
本次按本地源码进行静态核对，未启动前后端或连接数据库执行端到端验证；上述说明反映当前代码与页面定义。