# cv-web-admin-dev
**Repository Path**: keanxin/cv-web-admin-dev
## Basic Information
- **Project Name**: cv-web-admin-dev
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No
## Statistics
- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-05-23
- **Last Updated**: 2026-07-19
## Categories & Tags
**Categories**: Uncategorized
**Tags**: None
## README
# VTS Admin - 视觉训练系统管理后台
一个基于 Vue 3 + TypeScript + Vite 构建的现代化管理后台系统
## ✨ 特性
- 🎯 **现代技术栈**: 基于 Vue 3 + TypeScript + Vite，支持最新的前端开发体验
- 🎨 **精美UI**: 使用 Ant Design Vue + TailwindCSS，提供一致的设计语言
- 📱 **响应式设计**: 适配桌面端和移动端，支持多屏幕尺寸
- 🔐 **权限管理**: 完整的用户权限体系，支持角色和菜单权限控制
- 📊 **数据可视化**: 集成 ECharts，提供丰富的图表展示
- 🔄 **状态管理**: 使用 Pinia 进行状态管理，数据流清晰
- 🌐 **国际化**: 预留国际化支持，易于扩展多语言
- 📝 **TypeScript**: 全面的类型支持，提升开发体验和代码质量
- 🎪 **组件化**: 高度组件化的架构设计，便于维护和复用
## 🏗️ 项目结构
```
src/
├── assets/ # 静态资源
│ ├── data/ # 静态数据
│ ├── fonts/ # 字体文件
│ └── styles/ # 全局样式
├── components/ # 公共组件
│ ├── form/ # 表单组件
│ ├── layout/ # 布局组件
│ ├── table/ # 表格组件
│ └── query/ # 查询组件
├── composables/ # 组合式函数
├── pages/ # 页面组件
│ ├── approvalManagement/ # 审批管理
│ ├── employeeManagement/ # 员工管理
│ ├── orderManagement/ # 订单管理
│ ├── productManagement/ # 产品管理
│ ├── userManagement/ # 用户管理
│ ├── visionFunction/ # 视觉功能
│ ├── settings/ # 系统设置
│ └── questionnaire/ # 问卷调查
├── router/ # 路由配置
├── store/ # 状态管理
├── types/ # TypeScript 类型定义
└── utils/ # 工具函数
```
## 🚀 快速开始
### 环境要求
- Node.js >= 16.0.0
- npm >= 7.0.0 或 yarn >= 1.22.0
### 安装依赖
```bash
# 使用 npm
npm install
# 或使用 yarn
yarn install
# 或使用 pnpm
pnpm install
```
### 开发模式
```bash
npm run dev
```
访问 [http://localhost:1111](http://localhost:1111) 查看应用
### 构建生产版本
```bash
npm run prod
```
### 预览构建结果
```bash
npm run preview
```
## 📦 主要依赖
### 核心框架
- **Vue 3.5.13** - 渐进式 JavaScript 框架
- **TypeScript 5.8.3** - JavaScript 的超集，提供静态类型检查
- **Vite 6.3.5** - 下一代前端构建工具
### UI 框架
- **Ant Design Vue 4.2.6** - 企业级 UI 组件库
- **TailwindCSS 4.1.11** - 实用优先的 CSS 框架
### 状态管理 & 路由
- **Pinia 3.0.3** - Vue 官方状态管理库
- **Vue Router 4.5.1** - Vue.js 官方路由管理器
### 工具库
- **@vueuse/core** - Vue Composition API 工具集
- **lodash-es** - JavaScript 实用工具库
- **dayjs** - 轻量级日期处理库
- **echarts** - Apache ECharts 数据可视化库
### 开发工具
- **Vite** - 快速的前端构建工具
- **Husky** - Git hooks 工具
- **Prettier** - 代码格式化工具
- **unplugin-auto-import** - 自动导入插件
## 🔧 开发配置
### 代码格式化
项目使用 Prettier 进行代码格式化，配置了 git hooks 确保代码提交前自动格式化：
```bash
npm run format
```
### 类型检查
项目配置了严格的 TypeScript 检查：
```bash
npx vue-tsc --noEmit
```
### 环境变量
项目支持多环境配置：
- **开发环境**: `npm run dev` (使用 dev 模式)
- **生产环境**: `npm run prod` (使用 prod 模式)
## 🎨 功能模块
### 系统管理
- 👥 **用户管理** - 机构账户的增删改查和权限分配
- 🏢 **部门管理** - 组织架构管理
- 📋 **菜单管理** - 动态菜单配置
- 🔑 **角色管理** - 角色权限体系
- 🏪 **门店管理** - 门店信息维护
### 业务管理
- 👤 **客户管理** - 客户信息和档案管理
- 👷 **员工管理** - 员工信息和业绩管理
- 📦 **订单管理** - 订单处理和物流跟踪
- 🛍️ **商品管理** - 商品信息和分类管理
- 💰 **财务管理** - 支付和退款管理
### 视觉功能
- 👁️ **视觉评估** - 视力检测和评估
- 📋 **训练计划** - 个性化训练方案
- 🎯 **训练项目** - 训练内容管理
- 📊 **评估档案** - 检测记录和报告
### 系统功能
- 📋 **问卷系统** - 问卷设计和数据收集
- 📝 **内容管理** - 文章和分类管理
- 🔧 **系统配置** - 参数配置和字典管理
## 🤝 贡献指南
1. Fork 这个仓库
2. 创建你的特性分支 (`git checkout -b feature/AmazingFeature`)
3. 提交你的修改 (`git commit -m 'Add some AmazingFeature'`)
4. 推送到分支 (`git push origin feature/AmazingFeature`)
5. 提交 Pull Request
## 📄 许可证
本项目基于 MIT 许可证开源 - 查看 [LICENSE](LICENSE) 文件了解详情
## 🙏 致谢
感谢所有为这个项目做出贡献的开发者！
---
**如果这个项目对你有帮助，请给它一个 ⭐️**