连接每一只需要家的动物与每一颗愿意付出爱的心。

LinkPet 是一个面向普通用户与管理员的宠物领养平台，支持宠物发布与浏览、领养申请、社区帖子、图片上传等完整业务闭环。

• 首页：动态统计数据（成功领养数、待领养数、注册用户数）、全局装饰背景
• 领养中心：按品种筛选宠物、查看宠物详情弹窗（多图轮播）、申请领养、发布宠物
• 宠物社区：浏览帖子、发布帖子、点赞 / 取消点赞、评论 / 回复、删除自己的帖子
• 个人中心：查看我发布的宠物 / 帖子、领养申请记录
• 自定义品种：发布宠物时可填写自定义品种名称，提交管理员审核

• 用户管理、宠物管理、帖子管理（包括删帖）、领养申请审核
• 品种管理：审核用户提交的自定义品种，通过后自动创建品种记录

• JWT 无状态认证（用户端 + 管理端独立 Security 配置）
• MinIO 图片对象存储（支持多图上传）
• 全局统一响应格式 { code, message, data }
• 雪花 ID Long → String 序列化，避免前端精度丢失

LinkPet/ ├── linkpet-common/ # 公共模块：JWT、MinIO、ThreadLocal、统一响应、全局异常 ├── linkpet-model/ # 数据模型：Entity / DTO / VO ├── linkpet-mapper/ # 持久层：MyBatis-Plus Mapper + XML ├── linkpet-service/ # 业务层：Service 接口 + 实现 ├── linkpet-web-app/ # 用户端 API（端口 8080） ├── linkpet-web-admin/ # 管理端 API（独立端口） ├── linkpet-frontend/ # Vue 3 前端（Vite） │ └── src/ │ ├── api/ # 接口封装（pets / posts / auth / upload...） │ ├── views/ # 页面（home / adoption / community / guide / profile） │ ├── router/ # 路由配置 │ ├── store/ # 用户状态管理 │ └── utils/ # 工具函数（format / http） └── docs/ # 开发文档（dev-log.md / issues.md） 

完整建表语句见 docs/db.sql。

• JDK 17+
• Maven 3.8+
• MySQL 8.0+
• MinIO（本地部署或云端）
• Node.js 18+

1. 初始化数据库

   -- 执行建表语句 source docs/db.sql;

2. 配置文件

   在 linkpet-web-app/src/main/resources/application.yml 和 linkpet-web-admin/src/main/resources/application.yml 中配置：

   spring: datasource: url: jdbc:mysql://localhost:3306/linkpet username: your_username password: your_password minio: endpoint: http://localhost:9000 access-key: your_access_key secret-key: your_secret_key bucket-name: linkpet

3. 编译并启动

   # 编译整个多模块项目 mvn clean install -DskipTests # 启动用户端 cd linkpet-web-app mvn spring-boot:run # 启动管理端（新终端） cd linkpet-web-admin mvn spring-boot:run

cd linkpet-frontend npm install npm run dev

访问 http://localhost:5173

• 开发日志 — 记录每次提交的功能变更与设计决策
• Bug 修复记录 — 已修复的问题与根因分析