# uctoo-app-client-pc

**Repository Path**: UCT/uctoo-app-client-pc

## Basic Information

- **Project Name**: uctoo-app-client-pc
- **Description**: uctoo 应用开发管理后台PC前端项目
- **Primary Language**: JavaScript
- **License**: MIT
- **Default Branch**: v3
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 3
- **Forks**: 2
- **Created**: 2021-03-28
- **Last Updated**: 2025-09-17

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 管理系统 (UCToo Admin)

UCToo Admin管理系统是一个基于Vue 3和Ant Design Vue的企业级管理系统，采用现代化的前端技术栈和架构设计，提供丰富的功能模块和良好的用户体验。

## 项目简介

本系统采用monorepo项目结构，使用pnpm进行包管理，包含以下主要部分：
- 前端应用 (uctoo-app-client-pc)
- 后端模拟服务 (backend-mock)
- 核心组件库和工具包 (packages目录)

系统提供了CMS内容管理、CRM客户管理、电商系统、数据分析等多个功能模块，适用于各类企业级应用场景。

## 技术栈

- **前端框架**: Vue 3
- **UI组件库**: Ant Design Vue
- **编程语言**: TypeScript
- **构建工具**: Vite、Turbo
- **状态管理**: Pinia
- **路由**: Vue Router
- **包管理器**: pnpm
- **CSS预处理器**: Tailwind CSS
- **代码规范**: ESLint、Prettier、StyleLint

## 项目结构

```
qintong-admin/
├── apps/
│   ├── backend-mock/        # 后端模拟服务
│   └── uctoo-app-client-pc/ # PC端前端应用
├── internal/                # 内部配置和工具
├── packages/                # 核心包和组件
│   ├── @core/               # 核心功能
│   ├── constants/           # 常量定义
│   ├── effects/             # 效果和钩子
│   ├── icons/               # 图标库
│   ├── locales/             # 国际化
│   ├── preferences/         # 偏好设置
│   ├── stores/              # 状态管理
│   ├── styles/              # 样式
│   ├── types/               # 类型定义
│   └── utils/               # 工具函数
├── scripts/                 # 脚本
├── .gitignore
├── package.json
├── pnpm-lock.yaml
├── pnpm-workspace.yaml
└── README.md
```

## 安装使用

### 环境要求
- Node.js >= 20
- pnpm >= 9

### 安装步骤

1. 启用corepack
```bash
corepack enable
```

2. 安装依赖
```bash
pnpm install
```

3. 配置环境变量
在uctoo-app-client-pc目录下创建.env配置文件，可参考.env.development配置文件，配置VITE_GLOB_API_URL参数为后端API地址。

4. 运行开发服务器
```bash
pnpm dev
```

5. 构建生产环境
```bash
pnpm build
```

## Git 贡献提交规范

- `feat` 增加新功能
- `fix` 修复问题/BUG
- `style` 代码风格相关无影响运行结果的
- `perf` 优化/性能提升
- `refactor` 重构
- `revert` 撤销修改
- `test` 测试相关
- `docs` 文档/注释
- `chore` 依赖更新/脚手架配置修改等
- `ci` 持续集成
- `types` 类型定义文件更改
- `wip` 开发中

## 浏览器支持

本地开发推荐使用`Chrome 80+` 浏览器

支持现代浏览器, 不支持 IE

| [<img src="https://raw.githubusercontent.com/alrra/browser-logos/master/src/edge/edge_48x48.png" alt=" Edge" width="24px" height="24px" />](http://godban.github.io/browsers-support-badges/)</br>IE | [<img src="https://raw.githubusercontent.com/alrra/browser-logos/master/src/edge/edge_48x48.png" alt=" Edge" width="24px" height="24px" />](http://godban.github.io/browsers-support-badges/)</br>Edge | [<img src="https://raw.githubusercontent.com/alrra/browser-logos/master/src/firefox/firefox_48x48.png" alt="Firefox" width="24px" height="24px" />](http://godban.github.io/browsers-support-badges/)</br>Firefox | [<img src="https://raw.githubusercontent.com/alrra/browser-logos/master/src/chrome/chrome_48x48.png" alt="Chrome" width="24px" height="24px" />](http://godban.github.io/browsers-support-badges/)</br>Chrome | [<img src="https://raw.githubusercontent.com/alrra/browser-logos/master/src/safari/safari_48x48.png" alt="Safari" width="24px" height="24px" />](http://godban.github.io/browsers-support-badges/)</br>Safari |
| :-: | :-: | :-: | :-: | :-: |
| not support | last 2 versions | last 2 versions | last 2 versions | last 2 versions |

## 文档地址

[系统文档](https://doc.vben.pro/)