# 商家场景多租户 SaaS 企业综合管理系统

**Repository Path**: cencat1/cencat_saas

## Basic Information

- **Project Name**: 商家场景多租户 SaaS 企业综合管理系统
- **Description**: 
日常配送需求，构建 “固定商家管理 - 智能派单 - 路线规划 - 司机执行 - 线路发票管理” 全闭环系统。通过**多租户 SaaS 架构**，支持企业为不同固定商家提供定制化配送服务与规范化发票管理，解决 “派单效率低、路线不合理、司机与商家匹配度差、发票筛选难、打印顺序混乱” 等痛点，最终实现 “固定商家服务标准化、派单智能化、配送高效化、发票管理精细化” 的目标。
- **Primary Language**: Java
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: https://gitee.com/cencat_saas
- **GVP Project**: No

## Statistics

- **Stars**: 3
- **Forks**: 1
- **Created**: 2025-09-15
- **Last Updated**: 2026-03-03

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# CenCat SaaS 平台

> 基于Spring Boot 3.x + Vue 3.x 的现代化SaaS出行服务平台

## 📋 项目简介

CenCat SaaS是一个现代化的出行服务平台，采用微服务架构设计，提供订单管理、司机管理、路由规划等核心功能。项目使用最新的技术栈，具备高性能、高可用、易扩展的特点。

## 🏗️ 项目架构

```
my-cencat/
├── cencat-common/          # 公共模块
│   ├── config/            # 配置类
│   ├── constant/          # 常量定义
│   ├── enums/            # 枚举类
│   ├── exception/        # 异常处理
│   ├── result/           # 统一返回结果
│   └── utils/            # 工具类
├── cencat-order/          # 订单管理模块
│   ├── controller/       # 控制器层
│   ├── service/          # 业务逻辑层
│   ├── mapper/           # 数据访问层
│   ├── entity/           # 实体类
│   ├── dto/              # 数据传输对象
│   └── vo/               # 视图对象
├── cencat-driver/         # 司机管理模块
│   └── ...
├── cencat-route/          # 路由管理模块
│   └── ...
├── sql/                   # 数据库脚本
└── frontend/              # 前端项目
```

## 🚀 技术栈

### 后端技术

- **框架**: Spring Boot 3.2.0
- **数据库**: MySQL 8.0 + Redis 7.0
- **ORM**: MyBatis-Plus 3.5.5
- **连接池**: HikariCP
- **文档**: Swagger 3 (SpringDoc)
- **构建工具**: Maven 3.9+
- **JDK版本**: JDK 17+

### 前端技术

- **框架**: Vue 3.4 + TypeScript 5.0
- **构建工具**: Vite 5.0
- **UI组件**: Element Plus 2.7
- **状态管理**: Pinia 2.1
- **路由**: Vue Router 4.3

## 📦 模块说明

### cencat-common (公共模块)
- 统一配置管理
- 通用工具类
- 异常处理
- 统一返回结果

### cencat-order (订单模块)
- 订单创建与管理
- 订单状态流转
- 支付集成
- 订单统计分析

### cencat-driver (司机模块)
- 司机注册与认证
- 司机状态管理
- 位置追踪
- 收入统计

### cencat-route (路由模块)
- 路线规划
- 轨迹记录
- 路况分析
- 智能调度

## 🛠️ 环境要求

- **JDK**: 17+
- **Maven**: 3.9+
- **MySQL**: 8.0+
- **Redis**: 7.0+
- **Node.js**: 18+ (前端开发)

## 🚀 快速开始

### 1. 克隆项目

```bash
git clone https://github.com/cencat/my-cencat.git
cd my-cencat
```

### 2. 数据库初始化

```sql
-- 创建数据库
CREATE DATABASE cencat_saas CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;

-- 导入初始化脚本
source sql/init.sql
```

### 3. 配置修改

修改各模块的 `application.yml` 配置文件：

```yaml
spring:
  datasource:
    url: jdbc:mysql://localhost:3306/cencat_saas
    username: root
    password: 123456
  data:
    redis:
      host: localhost
      port: 6379
```

### 4. 编译项目

```bash
mvn clean compile
```

### 5. 启动服务

#### 方式一：使用启动脚本 (推荐)

```bash
# Windows
start-all.bat

# Linux/Mac
./start-all.sh
```

#### 方式二：手动启动

```bash
# 启动订单模块
cd cencat-order
mvn spring-boot:run

# 启动司机模块
cd cencat-driver
mvn spring-boot:run

# 启动路由模块
cd cencat-route
mvn spring-boot:run
```

## 📚 接口文档

启动服务后，可通过以下地址访问API文档：

- **订单模块**: http://localhost:8080/api/order/swagger-ui.html
- **司机模块**: http://localhost:8081/api/driver/swagger-ui.html
- **路由模块**: http://localhost:8082/api/route/swagger-ui.html

## 🔧 开发规范

### 代码规范

- 使用统一的代码格式化配置
- 遵循阿里巴巴Java开发手册
- 类名使用PascalCase，方法名使用camelCase
- 常量使用UPPER_SNAKE_CASE

### 数据库规范

- 表名使用 `t_` 前缀
- 字段名使用snake_case
- 必须包含 `created_time`、`updated_time`、`deleted` 字段
- 使用逻辑删除，不进行物理删除

### API规范

- 使用RESTful风格
- 统一返回结果格式
- 使用HTTP状态码
- 完善的接口文档

## 📈 性能优化

- **数据库优化**: 合理使用索引，避免N+1查询
- **缓存策略**: Redis缓存热点数据
- **连接池**: HikariCP高性能连接池
- **异步处理**: 使用@Async处理耗时操作

## 🔒 安全特性

- 参数校验使用Jakarta Validation
- SQL注入防护
- XSS攻击防护
- CORS跨域配置

## 📊 监控运维

- Spring Boot Actuator健康检查
- 日志文件滚动配置
- 性能指标监控
- 异常告警机制

## 🤝 贡献指南

1. Fork 项目
2. 创建特性分支 (`git checkout -b feature/AmazingFeature`)
3. 提交更改 (`git commit -m 'Add some AmazingFeature'`)
4. 推送到分支 (`git push origin feature/AmazingFeature`)
5. 打开 Pull Request

## 📄 许可证

本项目采用 MIT 许可证 - 查看 [LICENSE](LICENSE) 文件了解详情

## 👨‍💻 作者

- **cencat** - *项目创建者* - [cencat](https://github.com/cencat)

## 🙏 致谢

感谢所有为这个项目做出贡献的开发者！

---

⭐ 如果这个项目对你有帮助，请给它一个星标！