jiebanke/docs/项目概述.md

# 结伴客项目概述

## 📋 项目简介

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

## 🎯 产品定位

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

## 👥 目标用户

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

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

## 🌟 核心功能

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

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

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

## 🏗️ 技术架构

### 前端技术栈
- **微信小程序**：原生小程序开发 + 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) - 开发规范和最佳实践

## 🔄 开发状态

### 当前版本
- **版本号**：v1.0.0
- **发布状态**：开发中
- **最新更新**：2024年1月

### 功能完成度
- ✅ **微信小程序**：核心功能已完成，正在优化用户体验
- ✅ **后台管理系统**：基础管理功能已完成，持续迭代中
- 🚧 **官方网站**：开发中，预计2024年2月上线
- ✅ **Node.js后端**：主要API已完成，性能优化中
- 🚧 **Java微服务**：架构设计完成，部分服务开发中

### 近期规划
- **2024年1月**：完善文档体系，优化代码质量
- **2024年2月**：官方网站上线，增加营销功能
- **2024年3月**：Java微服务版本发布，支持高并发
- **2024年4月**：移动端APP开发启动

## 🏆 项目特色

### 创新亮点
1. **独特的动物认领模式**：将传统农场体验与现代科技结合
2. **智能匹配算法**：基于用户兴趣和地理位置的精准匹配
3. **多端统一体验**：小程序、网站、管理后台无缝衔接
4. **灵活的商家生态**：支持多种类型商家入驻和服务

### 技术优势
1. **现代化架构**：采用微服务架构，支持水平扩展
2. **多语言支持**：Node.js和Java双后端架构
3. **容器化部署**：Docker容器化，支持云原生部署
4. **完善的监控**：全链路监控和日志管理

## 📊 业务数据

### 用户规模（预期）
- **目标用户**：10万+注册用户
- **日活用户**：5000+
- **月活用户**：30000+
- **商家数量**：500+

### 业务指标
- **活动发布**：每日100+个活动
- **成功匹配**：每日50+次成功匹配
- **动物认领**：累计1000+只动物被认领
- **订单量**：每月2000+订单

## 🔐 安全与合规

### 数据安全
- **数据加密**：敏感数据AES-256加密存储
- **传输安全**：全站HTTPS，API接口SSL加密
- **访问控制**：基于角色的权限管理（RBAC）
- **数据备份**：每日自动备份，异地容灾

### 隐私保护
- **用户隐私**：严格遵守《个人信息保护法》
- **数据最小化**：仅收集必要的用户信息
- **用户授权**：明确的隐私政策和用户授权
- **数据删除**：支持用户数据删除请求

## 📞 联系我们

### 开发团队
- **项目负责人**：dev@jiebanke.com
- **技术支持**：tech@jiebanke.com
- **产品反馈**：feedback@jiebanke.com
- **商务合作**：business@jiebanke.com

### 社区资源
- **GitHub仓库**：https://github.com/jiebanke/jiebanke
- **技术文档**：https://docs.jiebanke.com
- **API文档**：https://api.jiebanke.com/docs
- **用户社区**：https://community.jiebanke.com

### 支持渠道
- **在线客服**：工作日 9:00-18:00
- **技术QQ群**：123456789
- **微信群**：扫描二维码加入
- **邮件支持**：24小时内回复

---

*文档版本：v1.2 | 最后更新时间：2024年1月20日 | 维护者：结伴客开发团队*