# 项目技术栈文档

## 项目概述
**项目名称**: 云·企业官网
**版本**: 1.10.1  
**项目类型**: Vue 3 + TypeScript 前端管理框架
**构建工具**: Vite 3.x  

## 核心技术栈

### 前端框架
- **Vue 3.5.3** - 渐进式 JavaScript 框架
- **TypeScript 4.8.2** - JavaScript 的超集，提供静态类型检查
- **Vite 3.0.9** - 下一代前端构建工具

### UI 组件库
- **Ant Design Vue 3.2.11** - 企业级 UI 设计语言和组件库
- **@ant-design/icons-vue 6.1.0** - Ant Design 图标库
- **@ant-design/colors 6.0.0** - Ant Design 色彩系统

### 状态管理与路由
- **Pinia 2.0.21** - Vue 3 官方推荐的状态管理库
- **Vue Router 4.1.5** - Vue.js 官方路由管理器

### 样式处理
- **Less 4.1.3** - CSS 预处理器
- **TailwindCSS 3.4.6** - 实用优先的 CSS 框架
- **PostCSS 8.4.39** - CSS 后处理器
- **Autoprefixer 10.4.19** - CSS 自动添加浏览器前缀

### 国际化
- **Vue I18n 9.2.2** - Vue.js 国际化插件

### 数据可视化
- **ECharts 5.3.3** - 百度开源的数据可视化库
- **Vue-ECharts 6.2.3** - ECharts 的 Vue 3 组件
- **echarts-wordcloud 2.0.0** - ECharts 词云插件
- **@antv/g2 5.1.22** - 蚂蚁金服数据可视化语法

### 富文本编辑器s
- **TinyMCE 5.10.5** - 富文本编辑器
- **ByteMD 1.17.2** - Markdown 编辑器
- **md-editor-v3 5.2.3** - Vue 3 Markdown 编辑器

### 工具库
- **Axios 0.27.2** - HTTP 客户端
- **Lodash-es 4.17.21** - JavaScript 实用工具库
- **Day.js 1.11.5** - 轻量级日期处理库
- **Crypto-js 4.2.0** - 加密库
- **js-cookie 3.0.5** - Cookie 操作库
- **js-md5 0.7.3** - MD5 加密库
- **mitt 3.0.1** - 事件总线
- **nprogress 0.2.0** - 页面加载进度条

### 文件处理
- **ExcelJS 4.3.0** - Excel 文件处理
- **XLSX 0.18.5** - 电子表格文件处理
- **ali-oss 6.18.0** - 阿里云对象存储

### 交互增强
- **SortableJS 1.15.0** - 拖拽排序库
- **vuedraggable 4.1.0** - Vue 拖拽组件
- **CropperJS 1.5.12** - 图片裁剪库
- **CountUp.js 2.3.2** - 数字动画库
- **JSBarcode 3.11.5** - 条形码生成库

### 地图服务
- **@amap/amap-jsapi-loader 1.0.1** - 高德地图 JS API 加载器

### 实时通信
- **socket.io-client 4.7.1** - WebSocket 客户端

### 视频播放
- **xgplayer 2.31.7** - 西瓜视频播放器

### 企业微信
- **@wecom/jssdk 1.3.1** - 企业微信 JS SDK

## 开发工具配置

### 代码质量
- **ESLint 8.23.0** - JavaScript/TypeScript 代码检查工具
- **Prettier 2.7.1** - 代码格式化工具
- **@typescript-eslint/eslint-plugin 5.36.1** - TypeScript ESLint 插件
- **eslint-plugin-vue 9.4.0** - Vue ESLint 插件

### 构建优化
- **@vitejs/plugin-vue 3.0.3** - Vite Vue 插件
- **@vitejs/plugin-legacy 2.0.1** - 传统浏览器兼容性插件
- **vite-plugin-compression 0.5.1** - Gzip 压缩插件
- **unplugin-vue-components 0.22.4** - 组件自动导入插件
- **terser 5.15.0** - JavaScript 压缩工具

### 类型支持
- **@types/node 18.7.14** - Node.js 类型定义
- **@types/lodash-es 4.17.6** - Lodash 类型定义
- **@types/nprogress 0.2.0** - NProgress 类型定义
- **@types/sortablejs 1.13.0** - SortableJS 类型定义

## 项目结构

```
src/
├── components/          # 公共组件
├── config/             # 配置文件
├── layout/             # 布局组件
├── styles/             # 样式文件
├── utils/              # 工具函数
├── App.vue             # 根组件
└── main.ts             # 入口文件
```

## 构建配置

### Vite 配置特性
- 路径别名配置 (`@/` 指向 `src/`)
- 组件按需导入
- Gzip 压缩
- Less 预处理器支持
- 动态主题支持
- 构建优化配置

### TypeScript 配置
- 严格模式启用
- ES Next 目标
- 路径映射支持
- 装饰器支持

## 开发命令

```bash
# 开发环境启动
npm run dev

# 生产环境构建
npm run build

# 代码检查
npm run lint:eslint

# 清理缓存
npm run clean:cache

# 清理依赖
npm run clean:lib

# 构建 CSS
npm run build-css
```

## 浏览器兼容性
- 目标浏览器: Chrome 63+
- 支持现代浏览器特性
- 通过 Vite Legacy 插件支持旧版浏览器

## 特色功能
1. **组件按需导入** - 减少打包体积
2. **动态主题** - 支持主题切换
3. **国际化支持** - 多语言切换
4. **丰富的数据可视化** - 多种图表组件
5. **完整的文件处理** - 支持 Excel、图片等文件操作
6. **企业级功能** - 权限管理、工作流等

---
*文档生成时间: 2024年*