# 嘉恒智能报工小程序前端 本仓库是宁波嘉恒智能科技有限公司报工小程序的前端项目。小程序面向冲压工人、管理员和经理三类角色，用于车间扫码报工、考勤定位、报工审核、基础资料维护、模具二维码管理、生产监控、看板统计和对账导出。 后端服务独立维护在 `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](app.json) - 接口封装：[utils/api.js](utils/api.js) - 后端地址配置：[utils/config.js](utils/config.js) - 定位与考勤点校验：[utils/locationGuard.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/` 等本地文件。