# deliver-cloud-ai

**Repository Path**: weitw/deliver-cloud-ai

## Basic Information

- **Project Name**: deliver-cloud-ai
- **Description**: cloud项目
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-07-13
- **Last Updated**: 2026-07-13

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# JurisFlow (法律文书智能送达平台)

基于 Spring Cloud Alibaba 微服务架构构建的法务智能送达平台，面向法院电子送达、调解等业务场景，后续将接入图片识别、语音识别、大模型对话等 AI 能力。

## 模块清单

| 模块 | 端口 | 说明 |
|------|------|------|
| `jurisflow-common` | — | 公共基础（工具类、统一返回、异常处理、枚举常量） |
| `jurisflow-gateway` | 8080 | 网关（路由转发、JWT 鉴权、Sentinel 限流） |
| `jurisflow-auth` | 8081 | 认证授权（用户认证、JWT 签发、RBAC 权限） |
| `jurisflow-cases` | 8082 | 案件管理（案件 CRUD、案号生成、状态流转） |
| `jurisflow-document` | 8083 | 文书管理（文书上传、PDF 生成、模板管理、电子签署） |
| `jurisflow-delivery` | 8084 | 送达通讯（送达策略路由、短信/邮件/邮寄通知） |
| `jurisflow-call` | 8085 | 外呼中心（人工外呼、AI 外呼、语音转写） |
| `jurisflow-ai` | 8090 | AI 能力聚合（大模型对话、OCR、语音识别接口封装） |

## 技术栈

- **核心框架**：Spring Boot 3.2.x + Spring Cloud 2023.x + Spring Cloud Alibaba 2023.x
- **服务注册/配置**：Nacos
- **网关**：Spring Cloud Gateway
- **熔断降级**：Sentinel
- **消息队列**：RocketMQ
- **分布式事务**：Seata
- **链路追踪**：SkyWalking
- **ORM**：MyBatis-Plus
- **缓存**：Redis
- **对象存储**：MinIO / OSS
- **搜索引擎**：Elasticsearch
- **文档**：SpringDoc OpenAPI (Swagger)

## 环境要求

- JDK 17+
- Maven 3.6+
- Nacos 2.3.x
- MySQL 8.0+
- Redis
- RocketMQ（可选）

## 快速开始

### 前置准备

1. 启动 Nacos 服务（服务注册与配置中心）
2. 启动 MySQL 服务，执行 `sql/init.sql` 初始化所有数据库和表结构
3. 启动 RocketMQ（如果使用消息队列功能）
4. 启动 Redis（认证服务使用）
5. 启动 MinIO（文书存储使用）
6. 修改各模块 `application.yml` 中的数据库连接等配置

### 服务启动顺序

服务之间有依赖关系，必须按以下顺序启动：

```
第1步: auth                 # 认证服务（无依赖，先生效好）
第2步: cases                # 案件管理（无依赖，基础数据）
第3步: document             # 文书管理（无依赖）
第4步: delivery             # 送达通讯（依赖 cases、document）
第5步: call                 # 外呼中心（无依赖）
第6步: ai                   # AI能力聚合（无依赖）
第7步: gateway              # ★ 网关（最后启动，依赖所有上游服务）
```

**说明**：
- `auth` 先启动是因为它提供 JWT 密钥，后续服务和网关都需要用它做认证
- 其他业务服务之间无启动依赖（通过 Nacos 注册发现，运行时调用），可以并行启动
- `gateway` **必须最后启动**，因为它要发现所有上游服务并注册路由，如果先启动会导致路由不可用
- 每个服务启动后，可通过 `http://localhost:{端口}/api/v1/{service}/ping` 验证是否正常

### 验证

所有服务启动完成后，访问网关验证：
```
http://localhost:8080/api/v1/auth/ping     → 认证服务
http://localhost:8080/api/v1/case/ping     → 案件管理
...
```

## 默认账号

| 用户名 | 密码 | 角色 |
|--------|------|------|
| admin | admin123 | 系统管理员 |

## 项目结构

```
jurisflow/
├── pom.xml
├── jurisflow-common/          # 公共模块（jar）
├── jurisflow-gateway/         # 网关
├── jurisflow-auth/            # 认证授权
├── jurisflow-cases/           # 案件管理
├── jurisflow-document/        # 文书管理
├── jurisflow-delivery/        # 送达通讯
├── jurisflow-call/            # 外呼中心
└── jurisflow-ai/              # AI 能力聚合
```