# reglow-admin（Rust版本）

**Repository Path**: reglow-ai/reglow-admin-rust

## Basic Information

- **Project Name**: reglow-admin（Rust版本）
- **Description**: 基于 axum + sea-orm 的现代化后台管理系统（Rust 版），对标 Node.js / Python / Java 版本。 采用拷贝基础库方式：backend-rust/reglow/ 内置基础库代码（源自 reglow-library/reglow-rust）， backend-rust/app/ 存放业务代码。
- **Primary Language**: Rust
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-08-31
- **Last Updated**: 2026-09-02

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# ReglowAdmin - 新辉通用后台管理系统 (Rust)

> 基于 axum + sea-orm 的现代化后台管理系统（Rust 版），对标 Node.js / Python / Java 版本。
> 采用**拷贝基础库**方式：`backend-rust/reglow/` 内置基础库代码（源自 `reglow-library/reglow-rust`），
> `backend-rust/app/` 存放业务代码。**升级基础库时直接覆盖 `reglow/` 目录即可，业务代码不受影响。**

## 项目构成

| 目录              | 说明                                                                                         |
| ----------------- | -------------------------------------------------------------------------------------------- |
| `backend-rust/`   | Rust 后端（axum + sea-orm，`reglow/` 基础库 + `app/` 业务）                                  |
| `frontend-admin/` | Vue 3 + Vite 管理端前端（[reglow-design](https://gitee.com/reglow-ai/reglow-design) 子模块） |

## 前端子模块（Git Submodule）

`frontend-admin/` 是 reglow-design 的 Git 子模块（版本锁定，由 gitee 仓库管理，无需手动同步副本）。

**克隆项目时需一并拉取子模块**：

```bash
git clone --recurse-submodules git@gitee.com:reglow-ai/reglow-admin-rust.git
# 或已克隆后执行：
git submodule update --init --recursive
```

**前端更新**（reglow-design 发版后同步最新）：

```bash
git submodule update --remote --merge frontend-admin
git add frontend-admin && git commit -m "chore: 同步 reglow-design 最新" && git push
```

## 技术栈

| 技术         | 版本  | 说明                     |
| ------------ | ----- | ------------------------ |
| Rust         | 1.85+ | 编程语言                 |
| axum         | 0.7   | Web 框架                 |
| sea-orm      | 2.0   | ORM 数据访问             |
| sqlx         | 0.8   | SQL 驱动（SQLite/MySQL） |
| validator    | 0.19  | 声明式参数校验           |
| jsonwebtoken | 9.x   | JWT 认证（双 Token）     |
| bcrypt       | 0.15  | 密码加密                 |

## 架构设计

### 分层结构（业务侧，等价 Python 的 `app/` 包）

```
backend-rust/app/（业务层，reglow 升级不受影响）
├── src/
│   ├── main.rs              # 入口：建表 + 种子 + 组装应用 + 启动
│   ├── lib.rs               # 业务库根
│   ├── middleware.rs        # 业务中间件（安全响应头）
│   ├── modules/{module}/    # 六层：model → schema → repository → service → controller → mod(路由)
│   └── scripts/             # 业务种子数据（幂等）
```

通用后台能力（认证、RBAC、内容管理、素材、支付、AI、智能客服等 20+ 模块）由 `reglow/` 基础库提供，
业务代码通过 `reglow::server::build_app_with_extras` 将业务路由注入 `/admin/api/v1`。

### 统一响应格式

```json
{ "code": 0, "success": true, "msg": "操作成功", "data": { ... } }
```

分页响应：

```json
{
  "code": 0,
  "success": true,
  "msg": "操作成功",
  "data": { "items": [...], "total": 100, "page": 1, "size": 20 }
}
```

### RBAC 权限模型

```
Admin → Role → Menu/Button Permission
                └── Data Scope (5级)
```

### 多端点分离

| 端点             | 路径             | 状态      |
| ---------------- | ---------------- | --------- |
| 管理后台 API     | `/admin/api/v1/` | ✅ 已实现 |
| 客户端 API       | `/api/v1/`       | ✅ 已实现 |
| 健康检查         | `/health`        | ✅ 已实现 |
| 静态文件（上传） | `/uploads/`      | ✅ 已实现 |

## 快速开始

```bash
cd backend-rust
cp .env.example .env
cargo run -p reglow-admin-rust
```

默认监听：http://localhost:8000

- 管理后台 API：http://localhost:8000/admin/api/v1
- 健康检查：http://localhost:8000/health

默认账号：`rootadmin / admin123`（超级管理员）、`demo / demo123`（演示账号）

详见 [backend-rust/README.md](backend-rust/README.md)。

## 升级基础库（拷贝方式）

```powershell
# 将 reglow-library/reglow-rust 整体覆盖到 backend-rust/reglow/ 即可
Copy-Item -Recurse -Force reglow-library/reglow-rust/* reglow-admin-rust/backend-rust/reglow/
```

## 项目结构

```
reglow-admin-rust/
├── backend-rust/                # Rust 后端（workspace）
│   ├── Cargo.toml               # workspace 根（members: reglow + app）
│   ├── reglow/                  # 基础库（拷贝自 reglow-library/reglow-rust）
│   ├── app/                     # 业务工程（依赖 reglow）
│   │   ├── Cargo.toml
│   │   └── src/                 # main.rs / lib.rs / middleware.rs / modules / scripts
│   ├── .env.example             # 环境变量模板
│   └── Dockerfile               # 容器部署
├── frontend-admin/              # 管理端前端（待接入）
├── LICENSE
└── README.md
```

## 关联项目

| 项目                                                        | 说明                           |
| ----------------------------------------------------------- | ------------------------------ |
| [reglow-library/reglow-rust](../reglow-library/reglow-rust) | reglow Rust 基础库（拷贝来源） |
| [reglow-admin-python](../reglow-admin-python)               | Python 版后台（架构参考）      |

## 许可证

Apache License 2.0