嘉恒智能报工小程序前端

本仓库是宁波嘉恒智能科技有限公司报工小程序的前端项目。小程序面向冲压工人、管理员和经理三类角色，用于车间扫码报工、考勤定位、报工审核、基础资料维护、模具二维码管理、生产监控、看板统计和对账导出。

后端服务独立维护在 JhHardwareWRS_BackPoint 仓库，本仓库只保存微信小程序端代码。

当前业务范围

系统围绕“考勤点、人员、产品工序、冲压方式、设备、模具二维码、报工记录”建立生产数据链路。当前前端已经覆盖以下核心业务：

• 微信授权登录，按冲压工人、管理员、经理的优先级自动进入角色。
• 首页展示当前位置是否进入考勤点，支持进入系统和下拉刷新时更新定位。
• 人员、产品、设备、通知都支持考勤点维度，管理员按自己拥有的考勤点范围管理数据。
• 工人扫码模具二维码上班、换模具、下班报工，并在报工卡片中展示考勤点。
• 管理员审核报工、修改报工、作废报工、撤销作废、维护审核备注。
• 经理查看报工看板、导出看板、维护考勤设置、使用对账小账本和设备模具使用统计。

角色与模块

冲压工人

• 扫码报工：扫描模具二维码后进入上班、换模具或下班报工流程。
• 报工填报：填写设备号、成品数量、不良数量、材料库存批次号等信息。
• 报工记录：查看自己的历史报工、审核状态、异常标识和审核通过后的参考工资。
• 临时工注册：陌生手机号可在考勤点范围内注册临时工，并必须填写姓名。

管理员

• 报工审核：处理待审核报工，支持校正时间、产品工序、设备号、数量、换料次数、备注等字段。
• 审核记录：查看已审核记录，审核通过 30 天内可更改，作废记录只能查看不能编辑。
• 作废管理：未审核或审核通过一个月内可作废；作废后 30 天内可撤销，超过期限由后端清理。
• 产品清单：维护考勤点、项目号、型材号、产品名称、物料编码、物料名称、供应商、工序、冲压方式、操作人数、工序单价、标准节拍和 ERP 辅助字段。
• 人员清单：维护人员、角色和考勤点权限；电话号唯一。
• 设备管理：维护考勤点、设备号、设备类型和备注，设备类型包括冲压设备和清洗设备。
• 模具二维码：按考勤点、产品名称、工序、冲压方式生成二维码，支持后台 ZIP 任务批量生成、停止、继续、删除和转发。
• 智能监控：查看当前被占用的模具，处理工人反馈，一键解除占用。
• 通知配置：维护按考勤点发布的首页通知。
• 设备模具使用统计：按时间、考勤点、设备或模具统计使用情况。

经理

• 概览：查看全系统范围内的汇总数据和跳转入口。
• 产品清单、人员清单：经理拥有全考勤点视角。
• 考勤设置：按考勤点维护作息时间、就餐时间、考勤范围和系统自动提交时长。
• 报工看板：查看已审核报工，支持过滤作废、异常标识、备注、参考工资和导出。
• 对账小账本：按年份、月份、考勤点和产品名称核对最后一道工序的成品数量，维护对账成品和退货数量。
• 设备模具使用统计：按时间查看设备和模具的使用时长、报工次数、清洗数量等指标。
• 通知配置：可面向一个或多个考勤点发布通知。

特殊业务规则

考勤点

• 每个考勤点代表一个业务分公司或报工地点。
• 人员、产品、设备、通知、报工、审核、看板、统计等业务都带考勤点维度。
• 工人只能扫描自己有权限的考勤点二维码。
• 临时工注册必须在系统考勤点范围内完成。
• 考勤设置按考勤点维护作息、就餐、加班、夜班和定位范围。

模具二维码与占用

• 模具二维码由“考勤点 + 产品名称 + 工序 + 冲压方式”确定。
• 正常单人工序扫码上班后会占用该模具，换模具或报工提交后释放。
• 其他员工扫描被占用模具时，会提示占用人员，并可反馈给管理员。
• 管理员可在智能监控中强制解除占用，或通过反馈信箱一键解除占用。
• 清洗、处理杂活、多人协作工序不走单线占用限制。

清洗

• 冲压方式精确等于“清洗”时进入清洗报工逻辑。
• 清洗报工不计算工时，只填清洗数量。
• 清洗设备号来源于设备管理中设备类型为清洗设备的设备。
• 清洗页面支持一次添加多个清洗产品，并支持多选清洗设备。
• 审核页、记录页、经理看板中清洗记录会打“清洗”水印。

连续模

• 冲压方式精确等于“连续模”时进入连续模逻辑。
• 连续模报工需要填写“换料次数”。
• 换料次数会流转到报工结果、管理员审核、报工记录、经理看板和导出数据。
• 连续模记录会打“连续模”水印。

多人协作

• 产品清单中的操作人数大于 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
• 接口封装：utils/api.js
• 后端地址配置：utils/config.js
• 定位与考勤点校验：utils/locationGuard.js

本地开发时使用微信开发者工具导入本项目目录。project.private.config.json 是本地开发工具私有配置，不提交仓库。

目录说明

• pages/：小程序页面
• utils/：接口、配置、定位、缓存和通用工具
• docs/：接口、数据库和执行计划文档
• scripts/：前端辅助检查脚本
• PRODUCT.md：产品定位和设计约束说明

提交注意事项

不要提交本地私有配置、运行缓存和开发工具生成文件。当前仓库已通过 .gitignore 忽略 project.private.config.json、.superpowers/、.DS_Store、node_modules/、miniprogram_npm/ 等本地文件。