docs: expand frontend README feature overview
This commit is contained in:
souplearn
parent
619ff4e299
commit
316d054664
162
README.md
162
README.md
@ -1,44 +1,146 @@
|
|||||||
# 嘉恒报工小程序前端
|
# 嘉恒智能报工小程序前端
|
||||||
|
|
||||||
本仓库是宁波嘉恒智能科技有限公司报工小程序的前端项目，面向冲压工人、管理员和经理三类角色，用于扫码报工、考勤定位、生产审核、看板统计、二维码管理和基础资料维护。
|
本仓库是宁波嘉恒智能科技有限公司报工小程序的前端项目。小程序面向冲压工人、管理员和经理三类角色，用于车间扫码报工、考勤定位、报工审核、基础资料维护、模具二维码管理、生产监控、看板统计和对账导出。
|
||||||
|
|
||||||
## 产品定位
|
后端服务独立维护在 `JhHardwareWRS_BackPoint` 仓库，本仓库只保存微信小程序端代码。
|
||||||
|
|
||||||
小程序服务于工厂日常生产现场。工人通过手机扫描模具二维码完成上班、换模具、下班和报工填报；管理员维护人员、产品、设备、模具二维码、报工审核、智能监控和异常处理；经理维护考勤设置，并查看跨考勤点的看板、导出、对账和经营统计。
|
## 当前业务范围
|
||||||
|
|
||||||
系统的核心目标是让生产数据在手机端容易录入、容易审核、不容易误解，并且能够围绕考勤点、人员、产品、工序、冲压方式、设备、模具和报工记录形成可追溯链路。
|
系统围绕“考勤点、人员、产品工序、冲压方式、设备、模具二维码、报工记录”建立生产数据链路。当前前端已经覆盖以下核心业务：
|
||||||
|
|
||||||
## 主要能力
|
- 微信授权登录，按冲压工人、管理员、经理的优先级自动进入角色。
|
||||||
|
- 首页展示当前位置是否进入考勤点，支持进入系统和下拉刷新时更新定位。
|
||||||
|
- 人员、产品、设备、通知都支持考勤点维度，管理员按自己拥有的考勤点范围管理数据。
|
||||||
|
- 工人扫码模具二维码上班、换模具、下班报工，并在报工卡片中展示考勤点。
|
||||||
|
- 管理员审核报工、修改报工、作废报工、撤销作废、维护审核备注。
|
||||||
|
- 经理查看报工看板、导出看板、维护考勤设置、使用对账小账本和设备模具使用统计。
|
||||||
|
|
||||||
- 工人扫码上班、换模具、下班报工
|
## 角色与模块
|
||||||
- 支持普通工序、清洗、连续模、多人协作、处理杂活等业务场景
|
|
||||||
- 支持考勤点定位、人员权限、设备和模具占用控制
|
|
||||||
- 管理员报工审核、作废、修改、备注和异常标识
|
|
||||||
- 产品清单、人员清单、设备管理、模具二维码批量生成
|
|
||||||
- 智能监控、反馈信箱、设备模具使用统计
|
|
||||||
- 经理看板、导出、对账小账本和跨考勤点概览
|
|
||||||
|
|
||||||
## 设计原则
|
### 冲压工人
|
||||||
|
|
||||||
1. 当前任务要清楚，次要信息不能抢主流程。
|
- 扫码报工：扫描模具二维码后进入上班、换模具或下班报工流程。
|
||||||
2. 生产追溯信息要尽量保留在决策现场，包括考勤点、产品、工序、冲压方式、设备、人员和状态。
|
- 报工填报：填写设备号、成品数量、不良数量、材料库存批次号等信息。
|
||||||
3. 页面风格偏生产工具，信息密度可以高，但必须有清晰分组和边界。
|
- 报工记录：查看自己的历史报工、审核状态、异常标识和审核通过后的参考工资。
|
||||||
4. 审核、异常、作废、清洗、连续模、多人协作、超时自动提交等状态要有明确视觉标识。
|
- 临时工注册：陌生手机号可在考勤点范围内注册临时工，并必须填写姓名。
|
||||||
5. 面向车间手机使用，按钮要够大、数字要清楚、筛选和分页要直观。
|
|
||||||
|
|
||||||
## 交互与可用性要求
|
### 管理员
|
||||||
|
|
||||||
- 关键状态不能只靠颜色表达，需要配合文字、水印或标签。
|
- 报工审核：处理待审核报工，支持校正时间、产品工序、设备号、数量、换料次数、备注等字段。
|
||||||
- 触控目标要适合手机操作，避免依赖复杂手势。
|
- 审核记录：查看已审核记录，审核通过 30 天内可更改，作废记录只能查看不能编辑。
|
||||||
- 日期、分页、筛选、下拉选择等控件要给不熟悉手机操作的用户留出容错空间。
|
- 作废管理：未审核或审核通过一个月内可作废；作废后 30 天内可撤销，超过期限由后端清理。
|
||||||
- 生产现场使用时，页面应尽量稳定、清楚、可重复操作。
|
- 产品清单：维护考勤点、项目号、型材号、产品名称、物料编码、物料名称、供应商、工序、冲压方式、操作人数、工序单价、标准节拍和 ERP 辅助字段。
|
||||||
|
- 人员清单：维护人员、角色和考勤点权限；电话号唯一。
|
||||||
|
- 设备管理：维护考勤点、设备号、设备类型和备注，设备类型包括冲压设备和清洗设备。
|
||||||
|
- 模具二维码：按考勤点、产品名称、工序、冲压方式生成二维码，支持后台 ZIP 任务批量生成、停止、继续、删除和转发。
|
||||||
|
- 智能监控：查看当前被占用的模具，处理工人反馈，一键解除占用。
|
||||||
|
- 通知配置：维护按考勤点发布的首页通知。
|
||||||
|
- 设备模具使用统计：按时间、考勤点、设备或模具统计使用情况。
|
||||||
|
|
||||||
## 本地开发
|
### 经理
|
||||||
|
|
||||||
1. 使用微信开发者工具导入本项目目录。
|
- 概览：查看全系统范围内的汇总数据和跳转入口。
|
||||||
2. 后端接口地址在 [utils/config.js](/Users/souplearn/Gitlab/app/JhHardwareWRS/utils/config.js) 中配置。
|
- 产品清单、人员清单：经理拥有全考勤点视角。
|
||||||
3. 本地私有配置文件 `project.private.config.json` 不提交到仓库。
|
- 考勤设置：按考勤点维护作息时间、就餐时间、考勤范围和系统自动提交时长。
|
||||||
4. 前端仓库只保存小程序端代码，后端服务独立维护在 `JhHardwareWRS_BackPoint` 仓库。
|
- 报工看板：查看已审核报工，支持过滤作废、异常标识、备注、参考工资和导出。
|
||||||
|
- 对账小账本：按年份、月份、考勤点和产品名称核对最后一道工序的成品数量，维护对账成品和退货数量。
|
||||||
|
- 设备模具使用统计：按时间查看设备和模具的使用时长、报工次数、清洗数量等指标。
|
||||||
|
- 通知配置：可面向一个或多个考勤点发布通知。
|
||||||
|
|
||||||
|
## 特殊业务规则
|
||||||
|
|
||||||
|
### 考勤点
|
||||||
|
|
||||||
|
- 每个考勤点代表一个业务分公司或报工地点。
|
||||||
|
- 人员、产品、设备、通知、报工、审核、看板、统计等业务都带考勤点维度。
|
||||||
|
- 工人只能扫描自己有权限的考勤点二维码。
|
||||||
|
- 临时工注册必须在系统考勤点范围内完成。
|
||||||
|
- 考勤设置按考勤点维护作息、就餐、加班、夜班和定位范围。
|
||||||
|
|
||||||
|
### 模具二维码与占用
|
||||||
|
|
||||||
|
- 模具二维码由“考勤点 + 产品名称 + 工序 + 冲压方式”确定。
|
||||||
|
- 正常单人工序扫码上班后会占用该模具，换模具或报工提交后释放。
|
||||||
|
- 其他员工扫描被占用模具时，会提示占用人员，并可反馈给管理员。
|
||||||
|
- 管理员可在智能监控中强制解除占用，或通过反馈信箱一键解除占用。
|
||||||
|
- 清洗、处理杂活、多人协作工序不走单线占用限制。
|
||||||
|
|
||||||
|
### 清洗
|
||||||
|
|
||||||
|
- 冲压方式精确等于“清洗”时进入清洗报工逻辑。
|
||||||
|
- 清洗报工不计算工时，只填清洗数量。
|
||||||
|
- 清洗设备号来源于设备管理中设备类型为清洗设备的设备。
|
||||||
|
- 清洗页面支持一次添加多个清洗产品，并支持多选清洗设备。
|
||||||
|
- 审核页、记录页、经理看板中清洗记录会打“清洗”水印。
|
||||||
|
|
||||||
|
### 连续模
|
||||||
|
|
||||||
|
- 冲压方式精确等于“连续模”时进入连续模逻辑。
|
||||||
|
- 连续模报工需要填写“换料次数”。
|
||||||
|
- 换料次数会流转到报工结果、管理员审核、报工记录、经理看板和导出数据。
|
||||||
|
- 连续模记录会打“连续模”水印。
|
||||||
|
|
||||||
|
### 多人协作
|
||||||
|
|
||||||
|
- 产品清单中的操作人数大于 1 时判定为多人协作。
|
||||||
|
- 多人协作由员工各自扫码报工，不再由管理员添加副岗。
|
||||||
|
- 多人协作记录会打“多人协作”水印。
|
||||||
|
- 多人协作不使用普通单人工序的模具占用限制。
|
||||||
|
|
||||||
|
### 处理杂活
|
||||||
|
|
||||||
|
- 创建考勤点时，系统会为该考勤点生成特殊产品“处理杂活”。
|
||||||
|
- 工人扫处理杂活码可以记录杂活工时。
|
||||||
|
- 报工填报时杂活卡片由系统生成，不要求工人填写数量。
|
||||||
|
- 管理员审核时可填写杂活事项备注，经理看板和导出会体现。
|
||||||
|
- 包含杂活的记录会打“包含杂活”水印。
|
||||||
|
|
||||||
|
### 自动提交与作废
|
||||||
|
|
||||||
|
- 考勤设置中维护“系统自动提交时长”，超过该时长未下班报工的班次由系统自动提交。
|
||||||
|
- 自动提交记录右上角打“超时-系统自动提交”水印。
|
||||||
|
- 作废记录会变灰并打“作废”标记。
|
||||||
|
- 作废记录默认被过滤，但相关页面提供“过滤作废”开关。
|
||||||
|
|
||||||
|
### 异常与工资
|
||||||
|
|
||||||
|
- 报工会对实际节拍、标准节拍、实际工作量、标准工作量进行对比。
|
||||||
|
- 过快、过慢、过多、过少等异常会在审核、结果和看板中标识。
|
||||||
|
- 产品清单维护工序单价，审核通过的报工记录展示参考工资。
|
||||||
|
- 经理看板导出包含工序单价、参考工资、工种和人员工资汇总 sheet。
|
||||||
|
|
||||||
|
## 当前页面
|
||||||
|
|
||||||
|
| 页面目录 | 页面名称 | 说明 |
|
||||||
|
| --- | --- | --- |
|
||||||
|
| `pages/index` | 首页 / 工作台 | 登录、定位、概览、角色入口、通知、扫码入口 |
|
||||||
|
| `pages/clock` | 报工打卡 | 上班、换模具、下班、占用反馈、临时工注册 |
|
||||||
|
| `pages/reportForm` | 报工填报 | 普通报工、连续模换料次数、材料库存批次号、杂活卡片 |
|
||||||
|
| `pages/cleaningReport` | 清洗报工 | 清洗产品列表、清洗设备多选、清洗数量填报 |
|
||||||
|
| `pages/reportResult` | 报工结果 | 报工提交后的节拍、工作量、异常和特殊工序提示 |
|
||||||
|
| `pages/records` | 报工记录 / 审核记录 | 历史记录、明细卡片、作废、撤销作废、更改水印 |
|
||||||
|
| `pages/review` | 报工审核 | 管理员审核、校正、更正产品、审核备注、作废 |
|
||||||
|
| `pages/manageProducts` | 产品清单 | 产品工序资料、导入导出、特殊冲压方式、工序单价 |
|
||||||
|
| `pages/managePeople` | 人员清单 | 人员、角色、考勤点权限、导入导出 |
|
||||||
|
| `pages/manageEquipment` | 设备管理 | 设备号、设备类型、考勤点、备注和筛选 |
|
||||||
|
| `pages/deviceQr` | 模具二维码 | 单个二维码、批量 ZIP 任务、任务分页、停止继续删除 |
|
||||||
|
| `pages/smartMonitor` | 智能监控 | 模具占用、反馈信箱、解除占用 |
|
||||||
|
| `pages/workSchedule` | 考勤设置 | 考勤点、作息、就餐、定位范围、自动提交时长 |
|
||||||
|
| `pages/reconciliationLedger` | 对账小账本 | 按年月、考勤点和产品维护对账成品、退货数量 |
|
||||||
|
| `pages/dashboard` | 报工看板 | 经理看板、过滤作废、特殊水印、导出入口 |
|
||||||
|
| `pages/usageStats` | 设备模具使用统计 | 设备/模具切换、时间筛选、全字段搜索、分页 |
|
||||||
|
| `pages/usageStatsDetail` | 使用统计明细 | 使用统计的日报和报工明细 |
|
||||||
|
| `pages/manageNotices` | 通知配置 | 按考勤点维护首页通知 |
|
||||||
|
| `pages/logs` | 日志页 | 小程序基础日志页 |
|
||||||
|
|
||||||
|
## 技术与开发
|
||||||
|
|
||||||
|
- 小程序入口配置：[app.json](app.json)
|
||||||
|
- 接口封装：[utils/api.js](utils/api.js)
|
||||||
|
- 后端地址配置：[utils/config.js](utils/config.js)
|
||||||
|
- 定位与考勤点校验：[utils/locationGuard.js](utils/locationGuard.js)
|
||||||
|
|
||||||
|
本地开发时使用微信开发者工具导入本项目目录。`project.private.config.json` 是本地开发工具私有配置，不提交仓库。
|
||||||
|
|
||||||
## 目录说明
|
## 目录说明
|
||||||
|
|
||||||
@ -50,4 +152,4 @@
|
|||||||
|
|
||||||
## 提交注意事项
|
## 提交注意事项
|
||||||
|
|
||||||
不要提交本地私有配置、运行缓存和开发工具生成文件。当前仓库已通过 `.gitignore` 忽略 `project.private.config.json`、`.superpowers/`、`.DS_Store`、`node_modules/` 等本地文件。
|
不要提交本地私有配置、运行缓存和开发工具生成文件。当前仓库已通过 `.gitignore` 忽略 `project.private.config.json`、`.superpowers/`、`.DS_Store`、`node_modules/`、`miniprogram_npm/` 等本地文件。
|
||||||
|
|||||||
Loading…
Reference in New Issue
Block a user