# OneTemplate

**Repository Path**: gitee_ZXQ/OneTemplate

## Basic Information

- **Project Name**: OneTemplate
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-01-24
- **Last Updated**: 2025-07-01

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# OneTemplate - Vue 企业级中后台模板

基于 Vue 3 技术栈的现代化中后台前端解决方案，整合行业最佳实践，提供开箱即用的企业级开发体验。

## 核心特性

- 🚀 **前沿技术栈**  
  Vue 3 + TypeScript + Vite + Pinia 架构
- 🎯 **工程化规范**  
  完整的 ESLint + Prettier + Stylelint 代码规范体系
- 🌍 **国际化方案**  
  支持多语言切换 (中文/英文)，动态加载语言包
- 🛡 **安全认证**  
  JWT 鉴权体系 + 细粒度权限控制
- 📱 **响应式布局**  
  自动适配桌面/平板/移动端显示
- 📊 **数据可视化**  
  内置 ECharts 集成方案
- 🧪 **测试覆盖**  
  Vitest 单元测试 + 组件测试
- 🧩 **模块化设计**  
  按功能划分模块，支持动态路由注册
- 🎨 **主题定制**  
  支持在线主题编辑与持久化存储

## 快速开始

### 环境要求
- Node.js ≥18.12.0
- pnpm ≥8.0.0

### 安装依赖
```bash
pnpm install
```

### 开发模式
```bash
pnpm dev
```

### 生产构建
```bash
pnpm build
```

### 预览生产包
```bash
pnpm preview
```

## 项目结构

```text
├── mock/            # Mock 数据服务
├── public/          # 静态资源
├── src/
│   ├── api/         # 接口模块化
│   ├── assets/      # 本地资源
│   ├── components/  # 全局组件
│   ├── i18n/        # 国际化配置
│   ├── layouts/     # 布局组件
│   ├── router/      # 路由配置
│   ├── stores/      # Pinia 状态管理
│   ├── styles/      # 全局样式
│   ├── utils/       # 工具函数
│   └── views/       # 页面组件
├── .env.development # 开发环境变量
└── .env.production  # 生产环境变量
```

## 环境配置

创建 `.env.development` 文件：

```ini
# 接口基础路径
VITE_API_BASE_URL = /api

# 默认语言
VITE_DEFAULT_LANGUAGE = zh-CN

# 启用 Mock 服务
VITE_ENABLE_MOCK = true
```

## 脚本说明

| 命令            | 描述                  |
|-----------------|----------------------|
| `pnpm dev`      | 启动开发服务器        |
| `pnpm build`    | 生产环境构建          |
| `pnpm preview`  | 本地预览生产包        |
| `pnpm test`     | 运行单元测试          |
| `pnpm lint`     | 代码规范检查与修复    |
| `pnpm format`   | 代码格式化            |
| `pnpm mock`     | 启动独立 Mock 服务    |

## 测试规范

```bash
# 运行单元测试
pnpm test

# 生成测试覆盖率报告
pnpm test:coverage
```

## 贡献指南

1. Fork 项目仓库
2. 创建特性分支 (`git checkout -b feat/xxx`)
3. 提交代码变更 (`git commit -am '新增xxx功能'`)
4. 推送至远程仓库 (`git push origin feat/xxx`)
5. 创建 Pull Request

## 开源协议

本项目采用 [MIT 协议](LICENSE) 开源