# 结伴客项目概述

## 📋 项目简介

结伴客是一个创新的社交旅行平台，专注于为用户提供结伴旅行服务，并融入了独特的动物认领功能。该项目包含微信小程序、后台管理系统和官方网站三个核心模块，为用户和商家提供完整的服务生态。

## 🎯 产品定位

结伴客不仅仅是一个旅行社交平台，更是一个融合了农场体验、动物互动的创新服务平台。通过结合传统的结伴旅行功能与现代的动物认领体验，为用户创造独特的旅行记忆。

## 👥 目标用户

### 普通用户
- 热爱旅行的年轻人群
- 希望通过旅行结识新朋友的用户
- 对农场生活和动物互动感兴趣的用户
- 追求个性化旅行体验的用户

### 商家用户
- **花店商家**：提供鲜花产品和相关服务
- **活动组织者**：组织各类结伴活动和旅行项目
- **农场主**：提供动物认领和农场体验服务
- **旅行服务商**：提供专业的旅行规划和服务

## 🌟 核心功能

### 结伴旅行
- 智能匹配系统，根据兴趣爱好和行程安排匹配旅伴
- 多样化的活动类型：旅行、看电影、聚餐、桌游等
- 基于地理位置的本地化服务推荐

### 动物认领
- 提供牛、羊、猪、鸡等多种动物的认领服务
- 实时动物状态更新和成长记录
- 农场实地探访和互动体验

### 商家服务
- 完善的商家入驻和管理系统
- 多元化的产品和服务展示平台
- 订单管理和客户服务支持

## 🏗️ 技术架构

### 前端技术栈
- **微信小程序**：原生小程序开发 + Vant Weapp UI组件
- **后台管理系统**：Vue 3 + TypeScript + Element Plus
- **官方网站**：Vue 3 + Vue Router + 响应式设计

### 后端技术栈
- **Node.js版本**：Express.js + Sequelize ORM + MySQL
- **Java微服务版本**：Spring Boot + Spring Cloud + MyBatis Plus
- **数据存储**：MySQL 8.0 + Redis缓存
- **认证授权**：JWT Token + 微信OAuth

### 部署架构
- **容器化部署**：Docker + Docker Compose
- **负载均衡**：Nginx反向代理
- **数据库**：MySQL主从复制
- **缓存系统**：Redis集群

## 📁 项目结构

```
jiebanke/
├── mini-program/          # 微信小程序
├── admin-system/          # 后台管理系统
├── website/              # 官方网站
├── backend/              # Node.js后端服务
├── backend-java/         # Java微服务后端
├── fastapi-backend/      # FastAPI后端（实验性）
├── docs/                 # 项目文档
└── scripts/              # 部署和工具脚本
```

## 🚀 快速开始

### 环境要求
- Node.js 16.x 或更高版本
- MySQL 8.0+
- Redis 6.0+（可选）
- 微信开发者工具

### 安装步骤
1. 克隆项目代码
2. 安装项目依赖
3. 配置数据库连接
4. 启动开发服务器

详细的安装和部署说明请参考 [部署指南](./部署指南.md)

## 📚 文档导航

- [产品需求文档](./产品需求文档.md) - 详细的功能需求和业务逻辑
- [系统架构文档](./系统架构文档.md) - 技术架构和系统设计
- [API接口文档](./API接口文档.md) - 完整的API接口说明
- [数据库设计文档](./数据库设计文档.md) - 数据库表结构和关系
- [部署指南](./部署指南.md) - 系统部署和运维说明
- [开发指南](./开发指南.md) - 开发规范和最佳实践

## 📞 联系我们

如有任何问题或建议，请通过以下方式联系我们：
- 项目仓库：[GitHub Repository]
- 技术支持：[技术支持邮箱]
- 产品反馈：[产品反馈渠道]

---

*最后更新时间：2025年1月*