docs: add Chinese frontend README

This commit is contained in:
souplearn 2026-06-24 15:28:06 +08:00
parent fa73a3c184
commit 619ff4e299

53
README.md Normal file
View File

@ -0,0 +1,53 @@
# 嘉恒报工小程序前端
本仓库是宁波嘉恒智能科技有限公司报工小程序的前端项目,面向冲压工人、管理员和经理三类角色,用于扫码报工、考勤定位、生产审核、看板统计、二维码管理和基础资料维护。
## 产品定位
小程序服务于工厂日常生产现场。工人通过手机扫描模具二维码完成上班、换模具、下班和报工填报;管理员维护人员、产品、设备、模具二维码、报工审核、智能监控和异常处理;经理维护考勤设置,并查看跨考勤点的看板、导出、对账和经营统计。
系统的核心目标是让生产数据在手机端容易录入、容易审核、不容易误解,并且能够围绕考勤点、人员、产品、工序、冲压方式、设备、模具和报工记录形成可追溯链路。
## 主要能力
- 工人扫码上班、换模具、下班报工
- 支持普通工序、清洗、连续模、多人协作、处理杂活等业务场景
- 支持考勤点定位、人员权限、设备和模具占用控制
- 管理员报工审核、作废、修改、备注和异常标识
- 产品清单、人员清单、设备管理、模具二维码批量生成
- 智能监控、反馈信箱、设备模具使用统计
- 经理看板、导出、对账小账本和跨考勤点概览
## 设计原则
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/` 等本地文件。