# 家政服务

**Repository Path**: upcc/housekeeping

## Basic Information

- **Project Name**: 家政服务
- **Description**: 家政项目
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2026-10-10
- **Last Updated**: 2026-10-10

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 家政服务平台 (Housekeeping Service Platform)

## 项目简介

这是一个基于微服务架构的家政服务平台系统，采用 Spring Cloud 技术栈构建。平台支持用户在线预约服务、服务人员抢单/派单、优惠券营销、订单管理等核心功能。

## 系统架构

项目采用微服务架构，主要包含以下模块：

| 模块 | 说明 |
|------|------|
| jzo2o-gateway | API 网关，负责请求路由、鉴权 |
| jzo2o-api | 公共 API 接口定义，供各服务间调用 |
| jzo2o-customer | 客户模块：用户、地址簿、评价、服务人员/机构管理 |
| jzo2o-foundations | 基础模块：区域、服务类型、服务项管理 |
| jzo2o-market | 营销模块：优惠券、活动管理 |
| jzo2o-orders | 订单模块：下单、支付、派单、抢单、服务流程管理 |

## 技术栈

- **后端框架**: Spring Boot, Spring Cloud
- **服务治理**: Spring Cloud Gateway, Feign
- **数据库**: MySQL, Redis
- **搜索引擎**: Elasticsearch
- **消息队列**: RabbitMQ
- **任务调度**: XXL-JOB

## 核心功能

### 用户端 (C端)
- 用户登录注册
- 地址簿管理
- 在线预约下单
- 订单支付
- 优惠券领取使用
- 评价服务

### 服务人员/机构端
- 服务人员/机构注册认证
- 抢单/接单
- 服务范围设置
- 服务技能管理
- 账户资金管理

### 运营管理端
- 区域配置管理
- 服务类型/服务项管理
- 优惠券活动配置
- 认证审核
- 订单管理

## 项目结构

```
jzo2o-code/
├── jzo2o-api/                    # API接口定义模块
│   └── src/main/java/com/jzo2o/api/
│       ├── customer/             # 客户相关API
│       ├── foundations/          # 基础服务相关API
│       ├── market/               # 营销相关API
│       ├── orders/               # 订单相关API
│       ├── publics/              # 公共服务API
│       └── trade/                # 交易相关API
├── jzo2o-customer/               # 客户服务中心
├── jzo2o-foundations/            # 基础服务中心
├── jzo2o-gateway/                # API网关
├── jzo2o-market/                 # 营销中心
└── jzo2o-orders/                 # 订单中心
    ├── jzo2o-orders-base/        # 订单基础模块
    └── jzo2o-orders-manager/     # 订单管理模块
```

## 快速开始

### 环境要求
- JDK 11+
- Maven 3.6+
- Redis
- MySQL 5.7+
- Elasticsearch 7.x
- RabbitMQ

### 构建项目

```bash
# 克隆项目
git clone https://gitee.com/upcc/housekeeping.git
cd housekeeping

# 构建所有模块
mvn clean install -DskipTests
```

### 配置说明

项目使用 Nacos 作为配置中心，主要配置文件：
- `bootstrap.yml` - 基础配置
- `bootstrap-dev.yml` - 开发环境配置
- `bootstrap-test.yml` - 测试环境配置
- `bootstrap-prod.yml` - 生产环境配置

### 启动顺序

1. 启动基础服务 (Redis, MySQL, Elasticsearch, RabbitMQ, Nacos)
2. 启动 jzo2o-gateway
3. 启动 jzo2o-foundations
4. 启动 jzo2o-customer
5. 启动 jzo2o-market
6. 启动 jzo2o-orders

## 主要特性

- **订单状态机**: 采用状态机模式管理订单生命周期
- **抢单/派单**: 支持服务人员抢单和智能派单
- **分布式锁**: 基于 Redis 实现分布式锁，保证高并发数据一致性
- **缓存策略**: 多级缓存机制，提升系统性能
- **消息同步**: 使用 RabbitMQ 实现数据同步

## API 文档

启动服务后，访问各服务的 Swagger 文档：
- Gateway: `http://localhost:8080/swagger-ui/`

## 许可证

本项目仅供学习交流使用。