# ordering-saas

**Repository Path**: toopoor/ordering-saas

## Basic Information

- **Project Name**: ordering-saas
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-02-26
- **Last Updated**: 2026-02-26

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# SaaS点餐系统

基于DDD架构的SaaS点餐系统，采用微服务架构设计，支持多租户、多门店模式。

## 项目结构

```
ordering-saas/
├── ordering-common/          # 公共模块
├── ordering-gateway/         # 网关服务
├── ordering-merchant/        # 商户服务
├── ordering-menu/            # 菜单服务
├── ordering-order/           # 订单服务
├── ordering-user/            # 用户服务
├── ordering-payment/         # 支付服务
├── ordering-notification/    # 通知服务
├── ordering-analytics/       # 数据分析服务
├── ordering-tenant/          # 租户服务
├── docs/                     # 文档
├── mysql/                    # MySQL配置
└── docker-compose.yml        # Docker编排文件
```

## 技术栈

- **后端框架**: Spring Boot 3.5, Spring Cloud Alibaba 2024
- **数据库**: MySQL 8.0
- **ORM框架**: MyBatis-Plus
- **注册中心**: Nacos
- **配置中心**: Nacos
- **网关**: Spring Cloud Gateway
- **缓存**: Redis
- **消息队列**: RabbitMQ
- **容器化**: Docker, Docker Compose
- **数据库迁移**: Flyway
- **API文档**: SpringDoc OpenAPI
- **日志**: Logback
- **监控**: Prometheus + Grafana

## 领域模型

### 商户领域 (Merchant)
- 商户管理
- 门店管理
- 品牌管理
- 餐桌管理
- 区域管理
- 用户管理

### 菜单领域 (Menu)
- 菜单分类管理
- 菜品管理

### 订单领域 (Order)
- 订单管理
- 订单明细管理

### 支付领域 (Payment)
- 支付记录管理
- 退款管理

### 租户领域 (Tenant)
- 租户管理
- 租户配置管理
- 多租户数据隔离

### 通知领域 (Notification)
- 系统通知管理
- 用户通知管理
- 通知发送跟踪

### 数据分析领域 (Analytics)
- 业务数据统计
- 销售数据分析
- 客户行为分析

## 服务端口

| 服务名称 | 端口 | 说明 |
|---------|------|------|
| Gateway | 8080 | API网关 |
| Merchant | 8083 | 商户服务 |
| Menu | 8081 | 菜单服务 |
| Order | 8082 | 订单服务 |
| User | 8084 | 用户服务 |
| Payment | 8085 | 支付服务 |
| Tenant | 8086 | 租户服务 |
| Notification | 8087 | 通知服务 |
| Analytics | 8088 | 数据分析服务 |

## 快速开始

### 环境要求
- JDK 17+
- Docker & Docker Compose
- Maven 3.8+

### 启动步骤

1. **构建项目**
```bash
mvn clean install
```

2. **启动基础服务**
```bash
docker-compose up -d mysql nacos redis
```

3. **启动业务服务**
```bash
docker-compose up -d
```

4. **访问服务**
- API文档: http://localhost:8080/swagger-ui.html
- Nacos控制台: http://localhost:8848/nacos

## 开发指南

### 项目规范

1. **DDD分层架构**
   - 接口层 (interfaces)
   - 应用层 (application)
   - 领域层 (domain)
   - 基础设施层 (infrastructure)

2. **包命名规范**
   ```
   cn.net.susan.ordering.{module}.{layer}.{subpackage}
   ```

3. **代码规范**
   - 遵循阿里巴巴Java开发手册
   - 使用Lombok简化代码
   - 统一异常处理
   - 统一日志处理

### 数据库设计

每个服务使用独立的数据库，通过Flyway进行数据库版本管理。

### API设计

RESTful API设计规范：
- 使用HTTP动词表示操作类型
- 统一返回格式
- 统一错误码
- 参数验证

## 部署说明

### Docker部署

```bash
# 构建镜像
docker-compose build

# 启动服务
docker-compose up -d

# 查看日志
docker-compose logs -f
```

### Kubernetes部署

TODO: 后续补充K8s部署配置

## 监控与运维

### 日志管理
- 使用Logback进行日志记录
- 支持日志级别动态调整
- 支持日志文件滚动

### 性能监控
- 集成Prometheus监控
- 集成Grafana可视化
- 支持自定义监控指标

## 贡献指南

1. Fork项目
2. 创建功能分支
3. 提交代码
4. 发起Pull Request

## 许可证

Apache License 2.0