# 7-宠物管理系统 - 功能说明
# 项目概述
覆盖宠物档案、服务预约、医疗记录、宠物用品、领养救助和社区动态的宠物管理平台。系统设置管理员、医生、店员与用户四类角色，分别处理平台维护、医疗服务、商品订单和个人宠物事务。
# 项目概览
# 创新点
- 四角色协作：医生负责医疗与救助，店员负责商品交易，用户通过前台管理个人宠物业务。
- 服务与档案结合：宠物档案、预约和医疗记录分别保存，支持按业务查看宠物服务信息。
- 领养与社区结合：救助动物和领养申请独立管理，动态、点赞和评论提供日常互动入口。
# 项目亮点
- 角色分工：提供管理员、医生、店员、用户等业务入口。
- 业务数据组织：主初始化脚本包含 16 张表，围绕该系统的核心对象与业务记录建模。
- 前后端分离：前端负责页面交互，后端通过控制器、服务与数据映射层提供接口。
- 操作体验：提供列表查询、表单编辑、状态展示及个人资料维护入口。
# 管理员
# 账号管理
维护用户、医生、店员及管理员信息。
# 宠物服务
管理宠物信息、预约及医疗记录。
# 商品交易
管理商品和订单。
# 领养救助
维护救助动物及领养申请。
# 社区内容
管理动态、评论和轮播图。
# 医生
# 预约与医疗
查看并处理预约，维护医疗记录。
# 领养救助
维护救助动物资料，处理领养申请。
# 店员
# 商品管理
维护宠物用品信息、价格及库存资料。
# 订单管理
查询商城订单，维护发货等订单状态。
# 用户
# 我的宠物
新增与维护个人宠物档案，查看相关服务信息。
# 服务预约
提交体检、疫苗、美容、寄养或治疗等预约，查看处理状态。
# 用品购买
浏览商品详情，填写收货与联系信息并查看订单。
# 领养申请
浏览救助动物，提交领养申请并查看审核结果。
# 社区互动
浏览和发布宠物动态，进行点赞与评论。
# 个人中心
集中查看订单、预约及领养申请，修改个人资料与密码。
# 功能权限对照表
下表说明当前菜单与业务入口分工。“—”表示未列为该角色的常规入口；不代表已对每个接口完成权限安全审计。
| 功能模块 | 管理员 | 医生 | 店员 | 用户 |
|---|---|---|---|---|
| 账号及平台内容 | 管理 | — | — | 浏览 |
| 宠物档案 | 管理 | — | — | 本人维护 |
| 预约与医疗 | 管理 | 处理 | — | 预约查询 |
| 商品与订单 | 管理 | — | 维护处理 | 购买查询 |
| 救助与领养 | 管理 | 处理 | — | 浏览申请 |
| 社区动态 | 管理 | — | — | 发布互动 |
# 业务状态说明
- 预约：待确认、已确认、已完成、已取消。
- 商品订单：待支付、已支付、已发货、已完成、已取消。
- 领养申请：待审核、已通过、已拒绝。
- 救助动物：待领养、已领养、治疗中。
# 默认账号
以下为主初始化 SQL 中能够核实的示例账号；需先导入对应脚本。这里不把脚本初始值视为当前运行数据库的实际账号或余额。
| 登录角色 | 角色标识 | 用户名 | 初始密码 |
|---|---|---|---|
| 管理员 | ADMIN | admin | 123456 |
| 医生 | DOCTOR | doctor1 | 123456 |
| 店员 | STAFF | staff1 | 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_7_pet_system。 - 主初始化脚本：
sql/sql.sql。 - 主脚本建表数量：16 张，仅统计当前主脚本的 CREATE TABLE，不包含临时 SQL、迁移脚本或运行时改动。
- 字符集：主脚本采用 utf8mb4。
- 数据表清单：
admin、adoption、appointment、banner、comment、doctor、likes、medical_record、order_item、orders、pet、pet_post、product、rescue_pet、staff、user。
# 文件上传
- 上传接口：
POST /file/upload。 - 文件访问：
GET /file/{fileName}。 - 配置限制：单文件 100MB，单次请求 1000MB。
- 使用范围：根据业务页面上传图片或附件；具体允许类型以对应上传组件配置为准。
# 系统特色
# 四角色协作
医生负责医疗与救助，店员负责商品交易，用户通过前台管理个人宠物业务。
# 服务与档案结合
宠物档案、预约和医疗记录分别保存，支持按业务查看宠物服务信息。
# 领养与社区结合
救助动物和领养申请独立管理，动态、点赞和评论提供日常互动入口。
# 当前实现说明
- 本项目不同于参考文件中的“宠物综合服务平台”，没有把宠物店作为登录角色，也不按上门喂养、临时寄养两套订单组织业务。
- 用户订单支付按钮直接更新为“已支付”，不能描述为真实在线支付或余额自动扣款。
本次按本地源码进行静态核对，未启动前后端或连接数据库执行端到端验证；上述说明反映当前代码与页面定义。