# ai-custom-flow

**Repository Path**: zaradee/ai-custom-flow

## Basic Information

- **Project Name**: ai-custom-flow
- **Description**: 基于AI的自定义流程管理系统
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2026-06-18
- **Last Updated**: 2026-06-18

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# ai-custom-flow 启动说明

## 1. 环境要求

### 后端
- JDK 17
- Maven 3.9+
- MySQL 8.0
- Redis 7
- RabbitMQ 3.12+

### 前端
- Node.js 18+
- npm 9+

### 可选
- Docker Desktop

---

## 2. 数据库初始化

数据库名：

```sql
ai_custom_flow
```

初始化脚本位置：

- `ai-custom-flow-server/src/main/resources/db/schema.sql`
- `ai-custom-flow-server/src/main/resources/db/data.sql`

执行顺序：

1. 先执行 `schema.sql`
2. 再执行 `data.sql`

---

## 3. 后端启动

进入后端目录：

```bash
cd ai-custom-flow-server
```

先编译：

```bash
mvn -DskipTests compile
```

再启动：

```bash
mvn spring-boot:run
```

默认端口：

- `8080`

如果提示端口被占用，请修改：

- `src/main/resources/application.yml`

将：

```yaml
server:
  port: 8080
```

改成其他端口，例如：

```yaml
server:
  port: 8081
```

---

## 4. 前端启动

进入前端目录：

```bash
cd ai-custom-flow-web
```

安装依赖：

```bash
npm install
```

启动开发环境：

```bash
npm run dev
```

默认端口：

- `5173`

如果后端端口改了，记得同步修改：

- `ai-custom-flow-web/vite.config.js`

把代理里的：

```js
target: 'http://localhost:8080'
```

改成对应端口。

---

## 5. Docker 启动

进入 `docker` 目录：

```bash
cd docker
```

启动容器：

```bash
docker compose up -d
```

停止容器：

```bash
docker compose down
```

默认暴露端口：

- MySQL：`3306`
- Redis：`6379`
- RabbitMQ：`5672`
- RabbitMQ 管理台：`15672`
- 后端：`8080`
- 前端/Nginx：`80`

---

## 6. 一键启动

项目根目录下有：

- `start.bat`

双击后会：

1. 启动后端窗口
2. 启动前端窗口

使用前请确保：

- `mvn` 已加入环境变量
- `npm` 已加入环境变量
- MySQL / Redis / RabbitMQ 已启动

---

## 7. 默认账号

初始化数据中包含示例账号：

- `admin`
- `designer`
- `publisher`
- `user1`
- `approver1`
- `approver2`

默认明文密码约定为：

```text
admin123
```

---

## 8. 启动顺序建议

### 方式一：本地开发

1. 启动 MySQL
2. 启动 Redis
3. 启动 RabbitMQ
4. 初始化数据库
5. 启动后端
6. 启动前端

### 方式二：Docker

1. 执行 `docker compose up -d`
2. 等待容器启动
3. 检查数据库初始化情况

---

## 9. 常见问题

### 9.1 后端启动失败

优先检查：

- JDK 是否为 17
- Maven 是否可用
- 8080 端口是否被占用
- MySQL / Redis / RabbitMQ 是否启动

### 9.2 前端启动失败

优先检查：

- Node.js 是否为 18+
- 是否执行了 `npm install`
- 5173 端口是否被占用

### 9.3 数据库连接失败

优先检查：

- 数据库是否存在 `ai_custom_flow`
- 用户名密码是否与 `application-dev.yml` 一致
- 初始化脚本是否执行成功

### 9.4 AI 接口不可用

当前 `application.yml` 中的：

- `app.ai.base-url`
- `app.ai.api-key`

是占位值，真实联调时需要替换。