# ruovea-template

**Repository Path**: ruovea/ruovea-template

## Basic Information

- **Project Name**: ruovea-template
- **Description**: 模版项目
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2026-05-11
- **Last Updated**: 2026-10-26

## Categories & Tags

**Categories**: Uncategorized

**Tags**: 模板

## README

# 🚀 RuoVea.Template

<div align="center">

**基于 .NET 8 与 [RuoVea](https://gitee.com/ruovea) 组件生态的一站式 `dotnet new` 项目模板库**

一行命令，即刻生成 —— 后端 API · 前后端分离 · 前端 SPA · MVC · Blazor，覆盖主流开发场景

</div>

---

## ✨ 为什么选择 RuoVea.Template

| 亮点 | 说明 |
|------|------|
| 🎯 一套模板，三种形态 | `ruovea-omi-api` 一个 `tt` 参数，切换纯后端 / 前后端一体 / 纯前端 |
| ⚡ 开箱即用 | 安装即生成，默认 SQLite，无需额外配置即可运行 |
| 🧩 企业级能力 | 动态 WebAPI、JWT 认证、多租户隔离、日志、国际化开箱即用 |
| 🛠️ RuoVea 生态 | SqlSugar + Mapster + RuoVea.Extend 组件全家桶 |
| 📦 六种模板 | 覆盖后端、前端、MVC、Blazor 全部主流场景 |

## 📦 模板一览

| 模板 | 短名 (shortName) | 说明 |
|------|------------------|------|
| 🚀 **RuoVea OmiAPI** | `ruovea-omi-api` | 前后端一体化，一套模板三种形态 |
| 🔌 **RuoVea OpenAPI** | `ruovea-open-api` | 分层架构标准 Web API |
| 🖥️ **RuoVea Web** | `ruovea-web` | 传统 MVC Web 应用 |
| 🎨 **RuoVea OmiWeb** | `ruovea-omi-web` | ASP.NET Core MVC + Vue，企业级后台管理 |
| 🧱 **RuoVea OmiApp** | `ruovea-app` | Blazor 快速 UI 应用 |
| ⚛️ **RuoVea OmiVue** | `ruovea-omi-vue` | Vue 3 + Element Plus 前端 SPA |

## ⚡ 快速开始

### 1. 安装

```bash
# 以 Simple Omi Api Template 为例
cd "Simple Omi Api Template/RuoVea.Omi.Api.Template/Content"
dotnet new install .
```

> 每个模板目录内均附带 `install.bat`，双击即可一键安装。

### 2. 生成项目

```bash
dotnet new ruovea-omi-api -n MyApp
```

### 3. 运行

```bash
cd MyApp
dotnet run --project MyApp.Entry
# Swagger：http://localhost:5000/swagger
```

## 🎯 明星模板：ruovea-omi-api 三合一

`ruovea-omi-api` 是模板库的核心，一个 `tt` 参数即可切换三种项目形态：

| `tt` 值 | 生成内容 | 适用场景 |
|---------|----------|----------|
| `api`（默认） | 纯后端（`Entry` + `Server`） | 前后端分离的后端服务 |
| `full` | 前后端一体（后端 + `Web/`） | 单体应用，一次部署 |
| `web` | 纯前端（前端摊平到根目录） | 对接已有后端 |

```bash
dotnet new ruovea-omi-api -n MyApp              # 纯后端
dotnet new ruovea-omi-api -n MyApp --tt full    # 前后端一体
dotnet new ruovea-omi-api -n MyApp --tt web     # 纯前端
```

> 三种形态的产物均经编译 / 构建验证：后端 `dotnet build` 0 警告 0 错误，前端 `pnpm build` 正常产出 `dist`。

## 🧩 前后端分离组合

需要前后端分仓库部署时，可组合使用：

```bash
dotnet new ruovea-omi-api -n MyApp     # 后端
dotnet new ruovea-omi-vue -n MyWeb     # 前端
```

## 🔧 环境要求

- .NET 8 SDK
- 前端构建需 Node.js >= 16、pnpm

## 📄 许可证

基于 [RuoVea](https://gitee.com/ruovea) 开源组件生态，采用 MIT 许可证。详见 [LICENSE](LICENSE)。