# 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-03-19
## Categories & Tags
**Categories**: Uncategorized
**Tags**: None
## README
# Machine ERP 后台管理系统
基于 Vue 3 + TypeScript + Element Plus + Vite 的 ERP 后台管理系统，提供权限管理、数据管理、CRM 等模块，支持响应式布局与动态路由。
---
## 功能特性
- **权限系统**：组织、角色、用户、菜单/权限管理，支持数据权限与指令 `v-hasPermission`
- **业务模块**：IAM 权限、数据（品牌/区域/门店/标签/素材/下载）、CRM 客户与会员等
- **模块化设计**：按业务拆分 `modules`，便于维护与扩展
- **响应式布局**：多端适配，标签页、侧栏、主题可配置
- **工程化**：TypeScript、ESLint、Prettier、Stylelint、Husky
---
## 技术栈
| 技术 | 版本 | 说明 |
|----------------|---------|--------------------------|
| Vue 3 | 3.5.x | 渐进式前端框架 |
| TypeScript | 5.8.x | 类型安全与可维护性 |
| Element Plus | 2.13.x | Vue 3 UI 组件库 |
| Vite | 6.4.x | 构建与开发服务器 |
| Pinia | 3.0.x | 状态管理 |
| Vue Router | 4.5.x | 路由（含动态路由） |
| Axios | 1.13.x | HTTP 请求 |
| Sass | 1.89.x | 样式预处理 |
---
## 项目结构
```
machine-front-vue/
├── src/
│ ├── modules/ # 业务模块
│ │ ├── common/ # 公共组件、工具、stores、类型
│ │ ├── iam/ # 权限（组织、角色、用户、菜单、登录日志）
│ │ ├── data/ # 数据（品牌、区域、门店、标签、素材、下载）
│ │ ├── crm/ # 客户与会员
│ │ └── ...
│ ├── views/ # 布局、登录、回调等页面
│ ├── router/ # 路由与守卫
│ ├── styles/ # 全局样式与变量
│ ├── setting.ts # 应用标题、Logo 等配置
│ └── main.ts # 应用入口
├── public/
├── .env.* # 环境变量
├── vite.config.ts
├── tsconfig.json
└── package.json
```
---
## 快速开始
### 环境要求
- **Node.js** 18+
- **npm** 9+ / **yarn** 1.22+ / **pnpm** 7+
### 安装与运行
```bash
# 安装依赖
npm install
# 开发模式（默认 http://localhost:5173）
npm run dev
```
### 构建与预览
```bash
# 开发环境构建
npm run build
# 测试环境构建
npm run build:test
# 生产环境构建（含类型检查）
npm run build:production
# 本地预览构建产物
npm run preview
```
### 代码规范
```bash
# 检查 ESLint
npm run lint:check
# 自动修复 ESLint
npm run lint:format
```
---
## 项目配置
### 环境变量
通过 `.env`、`.env.development`、`.env.test`、`.env.production` 配置接口与环境：
```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
```
### 应用设置
标题、Logo 等见 **`src/setting.ts`**，按需修改即可。
---
## 权限系统
### 权限指令
```vue
```
### 路由
- **常量路由**：登录、404 等固定页面
- **动态路由**：根据用户权限从后端拉取并注册，保证仅可访问有权限的菜单与页面
权限工具类 `PermissionUtil` 提供权限校验、列表获取等能力，可与指令、路由配合使用。
---
## 贡献指南
1. Fork / 克隆仓库
2. 创建分支：`git checkout -b feature/xxx` 或 `fix/xxx`
3. 开发并自测，执行 `npm run lint:format`、`npm run build:production`
4. 提交：建议遵循 [Conventional Commits](https://www.conventionalcommits.org/)
5. 推送分支并提交 Pull Request
---
## 许可证
MIT，详见 [LICENSE](LICENSE)。
---
## 项目截图
📸 点击查看系统截图
| | |
|------------------------------------------------------------------------------------------------------------------|--------------------------------------------------------------------------------------------------------------------------------|
|  |  |
|  |  |
|  |  |
|  |  |
|  |  |
|  |  |
|  | |