changhaoting1998-star/manufacturing-wechat-miniapp-starter

选用指南

AI 根据 README 整理 · 2026/11/3 03:07:13

适用场景

适用于中小型制造企业，将员工熟悉的微信小程序作为一线数据采集入口，与MES系统集成，实现报工、质量、异常事件等数据的实时回传。

查看 README 依据

Many frontline events are still reported on paper, in chat messages or after a shift. The delay makes production, quality and workforce records incomplete when managers need them. A Mini Program can collect structured data at the point of work without asking employees to install or learn another application, then return validated events to MES, payroll or factory administration systems.

The intended production model always works with an MES. MES remains the system of record for work orders, processes, routing, equipment, production results and quality records. The Mini Program is the employee-facing collection and feedback layer: it receives authorized tasks from MES and sends verified shop-floor events back through an auditable adapter. This starter focuses on four practical outcomes: - capture production completion, material use, quality, abnormal events, work time and forms as close to the event as possible;

目标用户

面向中小型制造企业的开发者和系统集成商，需要将微信小程序与MES或工厂管理系统对接。

查看 README 依据

# Manufacturing WeChat Mini Program Starter [](https://github.com/changhaoting1998-star/manufacturing-wechat-miniapp-starter/actions/workflows/ci.yml) [](LICENSE) A privacy-first, synthetic starter that turns a familiar WeChat Mini Program into a low-friction shop-floor data channel for small and medium-sized manufacturers. ## Why this matters

The intended production model always works with an MES. MES remains the system of record for work orders, processes, routing, equipment, production results and quality records. The Mini Program is the employee-facing collection and feedback layer: it receives authorized tasks from MES and sends verified shop-floor events back through an auditable adapter. This starter focuses on four practical outcomes: - capture production completion, material use, quality, abnormal events, work time and forms as close to the event as possible;

使用方式

作为微信小程序项目模板，需在微信开发者工具中编译预览，并配置云函数和数据库。

查看 README 依据

cloudfunctions/ Platform-neutral gateway and production boundary src/ Domain rules, memory store and MES connector tests/ Synthetic authorization and failure-path tests examples/ Deterministic local demo ``` ## Mini Program setup 1. Copy `miniprogram/project.config.example.json` to a local `project.config.json`. 2. Replace the placeholder AppID locally. Do not commit the resulting file. 3. Copy `miniprogram/config.example.js` to your own environment-specific configuration.

4. Connect `cloudfunctions/employeeGateway/handler.js` to a persistent repository and CloudBase identity provider. 5. Configure collections so Mini Program clients cannot read or write employee, payroll, signature, attendance or audit data directly. 6. Compile and preview in WeChat Developer Tools, then verify privacy disclosures before submission. The included cloud gateway is deliberately not deployable without operator-owned identity and storage wiring. This prevents a demo identity model from being mistaken for production authentication. ## Architecture ```text Native Mini Program

部署要求

需要Node.js 20或更高版本用于测试和演示；需要微信小程序AppID和CloudBase环境；需要企业自己的MES适配器。

查看 README 依据

All names, departments, dates, amounts, identifiers and locations in this repository are synthetic. The repository contains no production AppID, CloudBase environment, endpoint, credential, employee record, attendance location, payroll record or signature. ## Quick start Node.js 20 or newer is required for the zero-dependency test and demo runtime. ```bash npm test npm run demo ``` Expected demo output contains only synthetic identifiers, one MES receipt and a SHA-256 payload hash. ## Repository layout ```text miniprogram/ Native WXML/WXSS/JavaScript page skeletons

4. Connect `cloudfunctions/employeeGateway/handler.js` to a persistent repository and CloudBase identity provider. 5. Configure collections so Mini Program clients cannot read or write employee, payroll, signature, attendance or audit data directly. 6. Compile and preview in WeChat Developer Tools, then verify privacy disclosures before submission. The included cloud gateway is deliberately not deployable without operator-owned identity and storage wiring. This prevents a demo identity model from being mistaken for production authentication. ## Architecture ```text Native Mini Program

│ action + payload ▼ Cloud gateway ── verified platform identity │ ├─ employee access and authorization rules ├─ attendance / payroll / form services └─ MES connector ── idempotency key + payload hash + receipt ``` The client never submits the trusted platform subject identifier. A production adapter must derive it from the verified CloudBase execution context. ## MES integration model This repository provides the boundary pattern; an operator supplies the adapter for its own MES. | Direction | Typical records | Owner | | --- | --- | --- |

已知限制

项目不包含真实数据，不是可直接上线的完整MES，需要企业自行接入身份、权限、数据库等基础设施。

查看 README 依据

- deployable keys, tokens and environment files; - real employee, organization, payroll, attendance, signature and location data; - direct client access to privileged collections; - automatic background location collection; - a production-ready account, RBAC, database or retention implementation. Before production use, define data minimization, retention, deletion, export, incident response and user notice requirements. Add server-side authorization on every route, encrypted storage, audit retention, rate limits, backups and monitoring. ## Optional Feishu boundary

项目还可以维护经过审核的员工档案，向本人发送工资单并记录确认结果；基于 MES 已确认的生产事件，在产品、工艺、设备、班次和质量条件可比时分析不同工艺效率，辅助培训、排班和岗位匹配。效率数据只应作为管理者的决策支持，不能单独决定调岗、薪资或去留。正式系统应提供人工复核、记录纠正与申诉机制，并排除与工作无关或受保护的个人属性。 示例数据全部为虚构数据。项目重点演示员工准入、本人考勤、工资确认、动态表单和 MES 回执的安全边界，不包含任何真实企业的小程序标识、云环境、员工、工资、考勤、签名或部署资料。 项目不是可直接上线的完整 MES。正式使用前必须接入企业自己的身份、权限、数据库、审计、加密、备份、数据保留和隐私告知制度。 ## License MIT. See [LICENSE](LICENSE).