# com.hyper.admin.x

**Repository Path**: onlymry_admin/com.hyper.admin.x

## Basic Information

- **Project Name**: com.hyper.admin.x
- **Description**: midwayjs4.x版本的前后端一体管理框架
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-01-28
- **Last Updated**: 2026-01-30

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README



```markdown
# Geeker-Admin 全栈管理系统

Geeker-Admin 是一套基于 Vue 3 + Node.js 的全栈后台管理系统，采用了现代化的技术栈，提供完整的前端界面和后端服务解决方案。

## 🌟 项目特性

### 前端特性
- **Vue 3 + TypeScript** - 使用最新的 Vue 3 组合式 API 和类型系统
- **Vite 5** - 极速的开发体验和构建速度
- **Element Plus** - 优秀的 UI 组件库
- **Pinia** - 轻量级的状态管理方案
- **Axios** - 封装了完善的请求拦截和错误处理
- **动态路由** - 支持权限控制的菜单路由
- **主题配置** - 支持暗色模式和主题色切换
- **多布局** - 提供经典、横向、纵向等多布局模式

### 后端特性
- **MidwayJS** - 现代化的 Node.js 企业级框架
- **TypeORM** - 强大的数据库 ORM 工具
- **JWT** - 安全可靠的 Token 认证
- **权限控制** - 完整的 RBAC 权限体系
- **日志系统** - 完善的操作日志记录
- **异常处理** - 全面的 HTTP 异常分类处理

## 🛠 技术栈

### 前端 (apps/admin)
- Vue 3.3 / TypeScript 5.x
- Vite 5.x / Element Plus
- Pinia / Vue Router
- Axios / ECharts
- SCSS / Husky / ESLint

### 后端 (apps/server)
- Node.js 18+ / TypeScript
- MidwayJS 3.x
- TypeORM / MySQL
- JWT / Passport
- Jest / ESLint

### 移动端 (apps/mixs)
- Uni-app / Vue 3
- Pinia / Axios

### 公共包
- @escook/utils - 工具函数库
- @escook/node - Node.js 操作库
- @escook/common - 公共常量/枚举/接口

## 📦 安装依赖

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

# 安装根依赖
cd packages/common && pnpm install
cd packages/node && pnpm install
cd packages/utils && pnpm install

# 安装各应用依赖
cd apps/admin && pnpm install
cd apps/server && pnpm install
cd apps/mixs && pnpm install
```

## 🚀 启动项目

### 开发环境

```bash
# 启动前端（admin）
cd apps/admin
pnpm dev

# 启动后端服务
cd apps/server
pnpm dev

# 启动移动端
cd apps/mixs
pnpm dev
```

### 构建生产版本

```bash
# 构建前端
cd apps/admin
pnpm build

# 构建后端
cd apps/server
pnpm build
```

## 📁 项目结构

```
├── apps/
│   ├── admin/            # 管理后台前端 (Vue 3)
│   ├── server/           # 后端服务 (MidwayJS)
│   └── mixs/             # 移动端应用 (Uni-app)
├── packages/
│   ├── common/           # 公共常量、枚举、接口
│   ├── node/             # Node.js 操作工具库
│   └── utils/            # 工具函数库
├── .husky/               # Git hooks 配置
├── eslint.config.mjs     # ESLint 配置
└── pnpm-workspace.yaml   # PNPM 工作空间配置
```

### apps/admin 结构

```
apps/admin/
├── build/                # Vite 构建配置
├── public/               # 静态资源
├── src/
│   ├── api/              # API 接口封装
│   ├── assets/           # 资源文件
│   ├── components/       # 公共组件
│   ├── configuration/    # 项目配置
│   ├── directives/       # 自定义指令
│   ├── hooks/            # 组合式函数
│   ├── layouts/          # 布局组件
│   ├── locales/          # 国际化
│   ├── router/           # 路由配置
│   ├── stores/           # Pinia 状态管理
│   ├── styles/           # 样式文件
│   ├── typings/          # TypeScript 类型定义
│   ├── utils/            # 工具函数
│   └── views/            # 页面组件
├── index.html
├── package.json
└── vite.config.ts
```

### apps/server 结构

```
apps/server/
├── src/
│   ├── configurations/   # 配置文件
│   ├── libs/             # 核心库
│   │   ├── decorator/    # 自定义装饰器
│   │   ├── exceptions/   # 异常处理
│   │   ├── filter/       # 过滤器
│   │   ├── guard/        # 路由守卫
│   │   ├── middleware/   # 中间件
│   │   ├── model/        # 数据模型
│   │   ├── service/      # 服务层
│   │   ├── strategies/   # 策略模式
│   │   ├── task/         # 定时任务
│   │   └── validator/    # 数据验证
│   ├── modules/          # 业务模块
│   │   ├── controller/   # 控制器
│   │   ├── entities/     # 数据实体
│   │   ├── service/      # 业务服务
│   │   └── validator/    # 验证器
│   └── interface.ts      # 类型接口
├── test/                 # 测试文件
├── bootstrap.js
├── package.json
└── tsconfig.json
```

## 🔐 功能模块

### 系统管理
- **用户管理** - 用户账号的增删改查、角色分配
- **角色管理** - 角色权限配置、数据权限
- **菜单管理** - 动态菜单配置、权限标识
- **部门管理** - 组织架构管理
- **职位管理** - 岗位信息管理
- **权限管理** - 细粒度权限控制

### 系统工具
- **系统日志** - 操作日志记录与查询
- **错误报告** - 客户端错误上报
- **文件上传** - 多种文件格式支持

### 数据展示
- **首页仪表盘** - 统计图表展示
- **表格组件** - 高级表格功能
- **表单组件** - 动态表单生成

## 🎨 界面展示

系统提供多种布局模式：
- **经典布局** - 经典的后台管理布局
- **横向布局** - 顶部导航栏布局
- **纵向布局** - 侧边栏垂直布局
- **分栏布局** - 多列分栏布局

## 📝 提交规范

本项目使用 CommitLint 和 Husky 进行提交信息规范校验：

```bash
# 提交代码（会自动执行 lint-staged）
git add .
git commit -m "feat: 新增用户管理功能"
```

## 🔧 代码规范

```bash
# ESLint 检测
pnpm lint:eslint

# Prettier 格式化
pnpm prettier

# Stylelint 样式格式化
pnpm lint:stylelint
```

## 📄 许可证

本项目基于 [MIT](apps/admin/LICENSE) 协议开源。

## 📧 联系方式

如有问题或建议，欢迎提交 Issue 或 Pull Request。

---

**Geeker-Admin** - 让开发更简单、更高效！
```