# machine-front-vue
**Repository Path**: machineswift/machine-front-vue
## Basic Information
- **Project Name**: machine-front-vue
- **Description**: ERP系统（后台管理）
- **Primary Language**: TypeScript
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No
## Statistics
- **Stars**: 2
- **Forks**: 0
- **Created**: 2025-07-09
- **Last Updated**: 2026-02-11
## Categories & Tags
**Categories**: Uncategorized
**Tags**: None
## README
# Machine ERP 后台管理系统
## 项目介绍
Machine Front Vue 是一个基于 Vue 3 和 TypeScript 构建的 ERP 后台管理系统。该项目旨在为企业提供一套高效、稳定且易于扩展的管理界面，涵盖用户权限管理、数据可视化、业务流程控制等多个方面。
## 功能特性
- **完善的权限系统**：支持角色和用户权限的精细控制。
- **数据可视化**：提供直观的图表展示，帮助用户快速理解数据。
- **模块化设计**：系统由多个独立模块组成，便于维护和扩展。
- **响应式布局**：适配不同屏幕尺寸，确保良好的用户体验。
- **API 集成**：与后端服务无缝对接，实现高效的数据交互。
-
## 技术栈
| 技术 | 版本 | 描述 |
|--------------|--------|-----------------------------------|
| Vue3 | 3.5.13 | 构建用户界面的渐进式 JavaScript 框架 |
| TypeScript | 5.8.3 | 为 JavaScript 添加静态类型检查，提高代码质量和可维护性 |
| Element Plus | 2.10.2 | 基于 Vue 3 的组件库，提供丰富的 UI 组件 |
| Vite | 6.3.5 | 新一代前端构建工具，提供更快的冷启动速度和热更新 |
## 项目结构
```bash
machine-front-vue/
├── src/
│ ├── modules/ # 业务模块
│ │ ├── iam/ # 权限管理模块
│ │ ├── scm/ # 供应链管理模块
│ │ ├── system/ # 系统管理模块
│ │ └── ... # 其他业务模块
│ ├── views/ # 页面视图
│ ├── router/ # 路由配置
│ ├── stores/ # Pinia 状态管理
│ ├── styles/ # 全局样式
│ ├── utils/ # 工具函数
│ └── main.ts # 应用入口
├── public/ # 静态资源
├── .env.* # 环境变量配置
├── vite.config.ts # Vite 配置
├── tsconfig.json # TypeScript 配置
└── package.json # 项目依赖
```
## 快速开始
### 环境要求
- Node.js 18+
- npm 9+ 或 yarn 1.22+ 或 pnpm 7+
### 安装依赖
```bash
npm install
# 或
yarn
# 或
pnpm install
```
### 开发模式
```bash
npm run dev
```
### 构建命令
```bash
# 开发环境构建
npm run build
# 测试环境构建
npm run build:test
# 生产环境构建
npm run build:production
```
# 项目配置
## 环境变量
项目使用 `.env` 文件来配置环境变量。以下是一个示例配置：
```env
# .env 示例配置
VITE_API_BASE_URL=/machine-gateway-server/
VITE_SERVER_DEV=http://localhost:8080
VITE_SERVER_TEST=http://localhost:8080
VITE_SERVER_PROD=https://www.machine.com
```
## 应用设置
应用的主要配置位于 `src/setting.ts` 文件中，您可以根据需要调整相关参数。
# 权限系统
## 权限指令使用
```vue
```
## 权限工具类
权限工具类 `PermissionUtil` 提供了多种方法来处理权限相关的逻辑，如检查权限、获取权限列表等。
### 路由配置
#### 常量路由
常量路由定义了系统中的固定页面，如登录页、404 页面等。
#### 动态路由
动态路由根据用户的权限动态生成，确保用户只能访问其有权限的页面。
# 贡献指南
## 开发流程
1. 克隆仓库：`git clone https://gitee.com/your-repo/machine-front-vue.git`
2. 创建分支：`git checkout -b feature/your-feature-name`
3. 编写代码并测试
4. 提交更改：`git commit -m "feat: add your feature"`
5. 推送分支：`git push origin feature/your-feature-name`
6. 创建 Pull Request
### 提交规范
遵循 [Conventional Commits](https://www.conventionalcommits.org/) 规范，确保提交信息清晰易懂。
## 许可证
本项目采用 MIT 许可证，详情请参阅 [LICENSE](LICENSE) 文件。
## 项目截图
📸 点击查看系统截图
| | |
|------------------------------------------------------------------------------------------------------------------|--------------------------------------------------------------------------------------------------------------------------------|
|  |  |
|  |  |
|  |  |
|  |  |
|  |  |
|  |  |
|  | |