# ktg-mes-uniapp

**Repository Path**: bashui/ktg-mes-uniapp

## Basic Information

- **Project Name**: ktg-mes-uniapp
- **Description**: 为ktg-mes全新开发的uniapp移动端
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-01-18
- **Last Updated**: 2026-01-27

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 苦糖果 MES 移动端 (ktg-mes-uniapp)  
  
基于 **Vue 3** + **Vite** + **uni-app** + **Pinia** + **uView Plus** 构建的制造执行系统移动端应用。  
## 📋 项目概述  
  
**项目名称**: 苦糖果MES移动端 - Vue3重构版    
**技术栈**: Vue 3 Composition API + uni-app + Pinia + uView Plus    
**支持平台**: H5、微信小程序、APP  
  
### 核心特性  
  
- ✅ **Vue 3 Composition API** - 使用最新的 Vue 3 语法和响应式系统  
- ✅ **Pinia 状态管理** - 轻量级、类型安全的状态管理方案  
- ✅ **uView Plus UI** - 全面的 uni-app UI 组件库  
- ✅ **自动化拦截器** - Token 自动注入、会话失效重试、防重复提交  
- ✅ **Composables 模式** - 可复用的逻辑组合  
- ✅ **SCSS 设计系统** - 统一的样式变量和 Mixins  
- ✅ **业务组件封装** - 任务卡片、进度条、状态徽章等  
  
## 🚀 快速开始  
  
### 环境要求  
  
- Node.js >= 16.x  
- npm >= 8.x 或 pnpm >= 7.x  
- HBuilderX (可选，用于 APP 开发)  
  
### 安装依赖  
  
 
cd ktg-mes-uniapp 
npm install  
# 或  
pnpm install
开发运行
# H5 开发  
npm run dev:h5  
  
# 微信小程序开发  
npm run dev:mp-weixin  
  
# APP 开发  
npm run dev:app
生产构建
# H5 构建 
npm run build:h5  
  
# 微信小程序构建  
npm run build:mp-weixin  
  
# APP 构建  
npm run build:app

📁 项目结构
ktg-mes-uniapp/  
├── pages/                      # 页面目录  
│   ├── login/                  # 登录页  
│   ├── index/                  # 首页  
│   ├── task/                   # 任务相关页面  
│   └── splash/                 # 启动页  
├── src/                        # 源代码目录  
│   ├── api/                    # API 接口定义  
│   ├── components/             # 组件  
│   │   ├── business/           # 业务组件  
│   │   └── common/             # 通用组件  
│   ├── composables/            # 组合式函数  
│   ├── constants/              # 常量定义  
│   ├── interceptors/           # 请求拦截器  
│   ├── stores/                 # Pinia 状态管理  
│   ├── styles/                 # 样式文件  
│   └── utils/                  # 工具函数  
├── docs/                       # 文档目录  
└── package.json  

🔑 核心概念
1. Composition API 优先
所有组件和逻辑都使用 Vue 3 Composition API 编写，通过 <script setup> 语法简化代码。

2. Composables 模式
将可复用的逻辑提取为 composables，如 useLogin、usePageState 等。

3. 状态管理规范
认证状态 (useAuthStore) - Token、用户信息
生产状态 (useProductionStore) - 任务列表、当前任务
应用状态 (useAppStore) - 全局配置

4. 请求拦截机制
自动注入 Token
会话失效自动重试
统一错误处理
防重复提交

🎯 开发规范要点
组件命名: 使用 PascalCase，业务组件加前缀 Mes
文件命名: 使用 kebab-case
样式管理: 使用 SCSS 变量和 Mixins
API 定义: 集中在 src/api/ 目录
类型安全: 使用 JSDoc 注释提供类型提示

🔧 配置说明
API 配置
配置文件位置: src/config.js

代理配置
开发环境代理配置在 vite.config.js 中的 server.proxy