# Forge Admin

**Repository Path**: project_test001/forge-admin

## Basic Information

- **Project Name**: Forge Admin
- **Description**: ⚡ Vue 3 + Vite 7 + Element Plus 企业级中后台框架，多布局、ProTable、国际化、PWA、ECharts、权限指令
- **Primary Language**: JavaScript
- **License**: MIT
- **Default Branch**: master
- **Homepage**: https://vuejs.org/
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-03-28
- **Last Updated**: 2026-05-21

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Forge Admin

> ⚡ 基于 **Vue 3 + Vite 7 + Element Plus** 的企业级中后台框架

开箱即用的前端解决方案，助力快速搭建高质量管理后台。

## ✨ 特性

- 🏗️ **Vue 3 生态** — Composition API + `<script setup>`，拥抱最新语法
- ⚡ **Vite 7 极速构建** — 毫秒级 HMR，生产环境自动分包 + Gzip 压缩
- 🎨 **Element Plus** — 企业级 UI 组件库，深色/浅色主题切换
- 📊 **ECharts 6** — 内置图表能力，数据可视化开箱即用
- 🧩 **ProTable** — 高级表格组件，JSON 配置驱动，支持搜索/分页/排序
- 🌍 **国际化 (i18n)** — 内置 vue-i18n 多语言支持
- 📱 **PWA 支持** — 渐进式 Web 应用，离线可用
- 🔐 **权限体系** — 指令级按钮权限 `v-auth`，路由级页面权限
- 🎛️ **多布局** — Classic / Vertical / Transverse 三种布局自由切换
- 🛡️ **安全** — RSA + AES 加密，请求防重放
- 🧪 **工程规范** — ESLint + Prettier + Stylelint + Husky + Commitlint + Vitest

## 🛠 技术栈

| 类别 | 技术 |
|------|------|
| 框架 | Vue 3.5 + Vue Router 4 + Pinia 3 |
| 构建 | Vite 7 |
| UI | Element Plus 2.x |
| 图表 | ECharts 6 |
| 编辑器 | WangEditor 5、CodeMirror 6 |
| 通信 | Axios、Socket.io |
| 国际化 | vue-i18n 11 |
| 样式 | SCSS |
| 测试 | Vitest + Vue Test Utils |

## 📦 快速开始

```bash
# 克隆项目
git clone git@gitee.com:project_test001/forge-admin.git

# 进入目录
cd forge-admin

# 安装依赖 (推荐 pnpm)
pnpm install

# 启动开发服务器
pnpm dev

# 构建生产版本
pnpm build:pro
```

## 📂 目录结构

```
src/
├── api/              # 接口定义 (按业务模块)
├── assets/           # 静态资源
├── components/       # 全局组件 (ProTable, SearchForm ...)
├── config/           # 全局配置
├── directives/       # 自定义指令 (auth, copy, debounce ...)
├── hooks/            # 组合式函数
├── languages/        # 国际化资源
├── layouts/          # 布局组件
├── router/           # 路由配置
├── stores/           # Pinia 状态管理
├── styles/           # 全局样式 (SCSS)
├── utils/            # 工具函数
├── views/            # 页面视图
└── types/            # TypeScript 类型定义
```

## 🌐 浏览器兼容

| 浏览器 | 最低版本 | 说明 |
|--------|:---:|------|
| Chrome | 60+ | 主要兼容目标 |
| 360 安全浏览器 | 极速模式 | Chromium 内核 |
| 360 政务浏览器 | 极速模式 | Chromium 内核 |
| 搜狗/QQ/UC 浏览器 | 极速模式 | Chromium 内核 |
| Firefox | 55+ | 基本兼容 |
| Safari | 12+ | 基本兼容 |
| IE | ❌ | 不支持 |

> **内网部署说明**：所有 polyfill 均内置打包，不依赖外部 CDN，适合纯内网环境部署。

## 📖 架构详细文档

以下为项目架构设计详细说明。

---

test