# 小马顺风车

**Repository Path**: sky-su/xiaoma-windmill

## Basic Information

- **Project Name**: 小马顺风车
- **Description**: 前端nuxt3，后端微服务，需要百度开发者api
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-06-27
- **Last Updated**: 2025-06-27

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

## 项目简介

Hitch 是一个基于微服务架构的顺风车平台，包含用户管理、行程管理、订单管理、支付系统、通知系统和后台管理系统。项目采用 Spring Cloud Alibaba 技术栈，结合 Nuxt.js 前端框架，实现了完整的顺风车业务流程。

## 技术架构

- **后端技术栈**:
  - Spring Boot
  - Spring Cloud Alibaba
  - MyBatis Plus
  - Redis
  - MongoDB
  - RabbitMQ
  - MinIO
  - Feign
  - Nacos 服务发现
  - Gateway 网关
  - Sentinel 流控

- **前端技术栈**:
  - Nuxt.js
  - Vue 3
  - TypeScript
  - Pinia 状态管理
  - Tailwind CSS

## 主要模块

### 1. 用户服务 (hitch-account)
实现用户注册、登录、个人信息管理、实名认证、车辆认证等功能

### 2. 行程服务 (hitch-stroke)
处理行程发布、顺路行程匹配、行程邀请、行程状态管理等核心业务

### 3. 订单服务 (hitch-order)
管理行程订单生成、订单状态变更、订单查询等

### 4. 支付服务 (hitch-payment)
集成微信支付，处理订单支付、支付状态查询

### 5. 通知服务 (hitch-notice)
实现 WebSocket 实时通知、消息持久化、消息推送

### 6. 存储服务 (hitch-storage)
统一管理用户、行程、订单等数据存储，提供 Feign 接口

### 7. 网关服务 (hitch-gateway)
统一 API 路由、鉴权、限流等

### 8. 后台管理系统
基于 Nuxt 的后台管理界面，提供用户管理、统计分析、系统监控等功能

### 9. 用户端应用
基于 Nuxt 的用户端应用，支持乘客和司机两种角色

## 核心功能

### 用户管理
- 注册/登录
- 个人信息维护
- 实名认证
- 车辆认证

### 行程管理
- 发布行程
- 顺路行程匹配
- 行程邀请与接受
- 实时位置更新
- 行程状态跟踪

### 订单系统
- 自动生成订单
- 订单状态管理
- 订单查询

### 支付系统
- 微信支付集成
- 支付状态查询
- 订单支付确认

### 实时通知
- WebSocket 实时通信
- 消息持久化存储
- 消息推送

## 系统特色

1. **微服务架构**：采用 Spring Cloud Alibaba 技术栈，实现高可用、可扩展的微服务架构

2. **实时匹配**：基于 Redis GEO 的地理位置匹配算法，实现高效的顺路行程匹配

3. **分布式事务**：通过 RocketMQ 事务消息实现跨服务的数据一致性

4. **智能计价**：支持基础费用、燃油附加费、起步价等多种计价方式

5. **实时位置追踪**：基于 WebSocket 的实时位置更新和展示

6. **缓存优化**：使用 Redis 缓存热点数据，提升系统性能

7. **消息队列**：通过 RabbitMQ 处理异步任务和延迟任务

8. **文件存储**：集成 MinIO 实现图片和文件的分布式存储

## 部署要求

- Java 1.8+
- MySQL 5.7+
- Redis 6.0+
- RabbitMQ 3.8+
- MinIO
- Nacos 服务发现
- Node.js 16+ (前端)
- MongoDB (通知服务)

## 安装指南

1. 克隆项目到本地
2. 配置 Nacos 服务注册中心
3. 修改各模块的 application.yml 配置数据库、Redis等信息
4. 按顺序启动服务：注册中心 -> 网关 -> 各业务服务
5. 启动前端项目：安装依赖并运行开发服务器

## 使用说明

1. 用户注册并完善个人信息
2. 司机发布行程
3. 乘客查找顺路行程或接受邀请
4. 生成订单并完成支付
5. 实时查看行程状态
6. 接收系统通知