# imboy-admin-frontend

**Repository Path**: imboy-pub/imboy-admin-frontend

## Basic Information

- **Project Name**: imboy-admin-frontend
- **Description**: 采用Vue 3 （Element Plus+nuxt4）技术栈的 imboy管理后台项目
- **Primary Language**: TypeScript
- **License**: MulanPSL-2.0
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2025-09-11
- **Last Updated**: 2026-01-29

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# IMBoy Admin Frontend

IMBoy 即时通讯系统的管理后台前端项目。

## 技术栈

- **框架**: Nuxt 4 + Vue 3
- **UI 库**: Element Plus
- **状态管理**: Pinia
- **国际化**: Vue I18n
- **构建工具**: Vite
- **测试框架**: Vitest

## 功能特性

- 🔐 完整的认证系统（RSA + CSRF + JWT）
- 👥 用户和角色管理
- 🛡️ 基于 RBAC 的权限控制
- 🌍 中英文国际化
- 📊 数据可视化仪表盘
- 📱 响应式设计

## 快速开始

### 环境要求

- Node.js 20+
- bun


### 安装依赖

```bash
bun install
```

### 开发模式

```bash
bun dev
bun dev -o
```

访问 http://localhost:3000

### 构建生产版本

```bash
bun build
```

### 预览生产构建

```bash
bun preview
```

## 代码规范

```bash
# 代码检查
bun lint

# 自动修复
bun lint:fix

# 格式化代码
bun format

# 类型检查
bun type-check
```

## 测试

```bash
# 运行测试
bun test

# 测试 UI
bun test:ui

# 测试覆盖率
bun test:run --coverage
```

## 项目结构

```
app/
├── assets/          # 静态资源
├── components/      # Vue 组件
├── composables/     # 组合式函数
├── layouts/         # 布局组件
├── middleware/      # 路由中间件
├── pages/           # 页面组件
├── plugins/         # Nuxt 插件
├── stores/          # Pinia 状态管理
└── utils/           # 工具函数
```

## 环境变量

创建 `.env` 文件：

```bash
API_BASE_URL=http://localhost:9800
```

## 部署

### Docker 构建

```bash
docker build -t imboy-admin .
docker run -p 3000:3000 imboy-admin
```

### Docker Compose

```bash
docker-compose up -d
```

## 许可证

[MIT License](LICENSE)