# 铨一小程序

**Repository Path**: wjmnet/quanyi-mini-program

## Basic Information

- **Project Name**: 铨一小程序
- **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-06-30
- **Last Updated**: 2026-07-07

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 铨一智造 - 微信小程序项目文档

## 📱 项目概述

**铨一智造**是面向电机生产行业的移动端生产管理系统，采用微信小程序原生框架开发，提供生产报工、计划管理、订单跟踪、质检管理、数据统计等核心功能。

## 🏗️ 技术架构

- **框架**: 微信小程序原生框架（WXML + WXSS + JS + JSON）
- **设计模式**: 深色科技风格，电机行业专业配色
- **网络请求**: 基于 wx.request 的 Promise 封装
- **状态管理**: 本地存储（wxStorage）+ 全局数据（App.globalData）

## 📂 项目结构

```
WxApp/
├── app.js                  # 应用入口
├── app.json                # 全局配置
├── app.wxss                # 全局样式（CSS变量 + 通用组件）
├── sitemap.json            # 搜索配置
├── pages/                  # 页面目录
│   ├── login/              # 登录页
│   ├── index/              # 首页（功能导航）
│   ├── user/               # 我的（用户中心）
│   ├── work-report/        # 工序报工列表
│   ├── work-report-detail/ # 报工详情
│   ├── production-plan/    # 生产计划
│   ├── order-tracking/     # 订单跟踪
│   ├── qc-management/      # 质检管理
│   ├── qc-detail/          # 质检详情
│   ├── production-statistics/  # 生产统计
│   ├── work-report-analysis/   # 报工分析
│   └── production-process/     # 生产流程
├── utils/
│   └── api.js              # API接口封装
└── docs/
    └── README.md           # 项目文档
```

## 🎨 UI设计规范

### 配色方案
| 用途 | 色值 | 说明 |
|------|------|------|
| 背景深色 | `#0f172a` | 主背景色 |
| 主色调 | `#3b82f6` | 科技蓝 |
| 强调色 | `#06b6d4` | 青色 |
| 成功色 | `#22c55e` | 绿色 |
| 警告色 | `#f97316` | 橙色 |
| 错误色 | `#ef4444` | 红色 |
| 文字主色 | `#f1f5f9` | 白色 |
| 文字次色 | `#94a3b8` | 灰色 |

### 设计特点
- **深色主题**: 符合工业生产环境的视觉习惯
- **毛玻璃效果**: 卡片使用 backdrop-filter 实现毛玻璃
- **渐变高亮**: 数据使用渐变色强调
- **圆角卡片**: 统一的 24rpx 圆角设计

## 🔌 接口文档

### 基础配置
- **Base URL**: `https://mes.1stall.cn/api`
- **Headers**: `Accept: application/json`, `Content-Type: application/json`, `dbname: fjqydb`

### 接口列表

| 接口名称 | 方法 | 路径 | 参数 | 返回值 |
|---------|------|------|------|--------|
| 账号密码登录 | POST | `/prod-api/tenantLogin/mobile/common` | username, password, openid | {code, msg, data} |
| 获取OpenId | GET | `/prod-api/wx/getOpenId?code={code}` | code | {code, data: openid} |
| OpenId登录 | GET | `/prod-api/tenantLogin/mobile/openid?openid={openid}` | openid | {code, msg, data} |
| 获取用户信息 | GET | `/prod-api/mobile/getUserInfo?openid={openid}` | openid | {code, data: userInfo} |
| 退出登录 | GET | `/prod-api/mobile/logout?openid={openid}` | openid | {code, msg} |
| 工序报工列表 | GET | `/api/mobile/workReportAnalysis/total` | pageId, pageNum, pageSize, beginTime, endTime | {code, data: {result, total}} |
| 生产计划 | GET | `/api/mobile/planningManagement/total` | pageId, beginTime, endTime | {code, data: {result}} |
| 订单跟踪 | GET | `/api/mobile/orderTracking` | orderNumber(可选) | {code, data: {result}} |
| 质检管理 | GET | `/api/mobile/qualityManagement/list` | pageId | {code, data: {result}} |
| 生产统计 | GET | `/api/mobile/productionStatistics/total` | pageId, beginTime, endTime | {code, data: {result}} |
| 报工分析 | GET | `/api/mobile/workReportAnalysis/chart` | pageId, beginTime, endTime | {code, data: {result}} |
| 生产流程 | GET | `/api/mobile/productionProcess/list` | pageId | {code, data: {result}} |

## 🔐 登录流程

```
1. 打开小程序
2. 检查本地存储是否有 openid
   ├── 有 → 调用 loginByOpenId 自动登录 → 成功则跳转首页
   └── 无 → 显示登录页面
3. 用户输入账号密码
4. 获取微信 code → 换取 openid
5. 调用登录接口
6. 保存 openid 到本地存储
7. 跳转首页
```

## 📱 页面功能说明

### 登录页 (pages/login)
- 账号密码登录
- 自动登录检查（已登录用户直接进入首页）
- 用户协议勾选

### 首页 (pages/index)
- 欢迎语 + 用户头像
- 今日/本周/本月数据概览
- 6大功能模块入口（网格布局）

### 工序报工 (pages/work-report)
- 时间筛选（全部/今日/本周/本月）
- 报工记录卡片列表
- 下拉刷新 + 上拉加载
- 点击跳转详情

### 生产计划 (pages/production-plan)
- 日期范围选择
- 计划/完成/在产统计卡片
- 图表/列表视图切换

### 订单跟踪 (pages/order-tracking)
- 订单号搜索
- 可展开的订单卡片
- 子订单详情展示

### 质检管理 (pages/qc-management)
- 合格/不合格筛选
- 质检记录卡片
- 状态标签展示

### 生产统计 (pages/production-statistics)
- 本月数据概览（4大指标）
- 趋势图表展示

### 报工分析 (pages/work-report-analysis)
- 近30天报工趋势
- 工序分布图表

### 生产流程 (pages/production-process)
- 时间轴式流程展示
- 工序状态标记

### 我的 (pages/user)
- 用户信息卡片
- 功能菜单列表
- 退出登录

## ⚙️ 开发注意事项

1. **深色主题适配**: 所有页面背景使用 `#0f172a`，文字使用 `#f1f5f9`
2. **状态栏适配**: 使用 `env(safe-area-inset-bottom)` 处理底部安全区
3. **图表组件**: 统计页面预留了图表占位，建议集成 echarts-for-weixin
4. **图片资源**: 静态图片建议放置在 `static/images/` 目录

## 📝 更新日志

### v1.0.0 (2025-06-30)
- 初始版本发布
- 完成所有核心功能页面
- 实现登录免密功能
- 统一的深色科技风格UI