54 lines
3.0 KiB
Markdown
54 lines
3.0 KiB
Markdown
# 嘉恒报工小程序前端
|
|
|
|
本仓库是宁波嘉恒智能科技有限公司报工小程序的前端项目，面向冲压工人、管理员和经理三类角色，用于扫码报工、考勤定位、生产审核、看板统计、二维码管理和基础资料维护。
|
|
|
|
## 产品定位
|
|
|
|
小程序服务于工厂日常生产现场。工人通过手机扫描模具二维码完成上班、换模具、下班和报工填报；管理员维护人员、产品、设备、模具二维码、报工审核、智能监控和异常处理；经理维护考勤设置，并查看跨考勤点的看板、导出、对账和经营统计。
|
|
|
|
系统的核心目标是让生产数据在手机端容易录入、容易审核、不容易误解，并且能够围绕考勤点、人员、产品、工序、冲压方式、设备、模具和报工记录形成可追溯链路。
|
|
|
|
## 主要能力
|
|
|
|
- 工人扫码上班、换模具、下班报工
|
|
- 支持普通工序、清洗、连续模、多人协作、处理杂活等业务场景
|
|
- 支持考勤点定位、人员权限、设备和模具占用控制
|
|
- 管理员报工审核、作废、修改、备注和异常标识
|
|
- 产品清单、人员清单、设备管理、模具二维码批量生成
|
|
- 智能监控、反馈信箱、设备模具使用统计
|
|
- 经理看板、导出、对账小账本和跨考勤点概览
|
|
|
|
## 设计原则
|
|
|
|
1. 当前任务要清楚，次要信息不能抢主流程。
|
|
2. 生产追溯信息要尽量保留在决策现场，包括考勤点、产品、工序、冲压方式、设备、人员和状态。
|
|
3. 页面风格偏生产工具，信息密度可以高，但必须有清晰分组和边界。
|
|
4. 审核、异常、作废、清洗、连续模、多人协作、超时自动提交等状态要有明确视觉标识。
|
|
5. 面向车间手机使用，按钮要够大、数字要清楚、筛选和分页要直观。
|
|
|
|
## 交互与可用性要求
|
|
|
|
- 关键状态不能只靠颜色表达，需要配合文字、水印或标签。
|
|
- 触控目标要适合手机操作，避免依赖复杂手势。
|
|
- 日期、分页、筛选、下拉选择等控件要给不熟悉手机操作的用户留出容错空间。
|
|
- 生产现场使用时，页面应尽量稳定、清楚、可重复操作。
|
|
|
|
## 本地开发
|
|
|
|
1. 使用微信开发者工具导入本项目目录。
|
|
2. 后端接口地址在 [utils/config.js](/Users/souplearn/Gitlab/app/JhHardwareWRS/utils/config.js) 中配置。
|
|
3. 本地私有配置文件 `project.private.config.json` 不提交到仓库。
|
|
4. 前端仓库只保存小程序端代码，后端服务独立维护在 `JhHardwareWRS_BackPoint` 仓库。
|
|
|
|
## 目录说明
|
|
|
|
- `pages/`：小程序页面
|
|
- `utils/`：接口、配置、定位、缓存和通用工具
|
|
- `docs/`：接口、数据库和执行计划文档
|
|
- `scripts/`：前端辅助检查脚本
|
|
- `PRODUCT.md`：产品定位和设计约束说明
|
|
|
|
## 提交注意事项
|
|
|
|
不要提交本地私有配置、运行缓存和开发工具生成文件。当前仓库已通过 `.gitignore` 忽略 `project.private.config.json`、`.superpowers/`、`.DS_Store`、`node_modules/` 等本地文件。
|