气站智能检查与追溯系统

一、立项背景和目标 一家注塑、焊接工艺的制造工厂，原本靠纸质单据和口头传达管理生产：工单靠喊、报工靠记、 库存靠记忆，数据对不上、进度看不见。目标是让现场工人用手机扫一下就能完成报工， 让管理层随时看到真实进度，把「接单 → 排产 → 生产报工 → 入库 → 调拨 → 发货」 整条链子收进一个系统。 二、系统构成 · 微信小程序：现场操作端（扫码报工、排产、调拨、模具管理） · 网页后台：管理决策端（账户、工单、看板、报表、车间大屏） 三、核心功能 1. 扫码报工（核心）：每个工单生成二维码，工人扫码后只填「本次生产总数 + 次品数」， 系统自动计算「本次新增 = 本次总数 − 上次累计」和「合格数 = 新增 − 次品」， 合格数自动入库，并按 BOM 自动扣减物料。 2. 工单管理：待生产 → 已排产 → 生产中 → 已完成 状态流转，首次报工自动转生产中， 支持批量下单、批量排产、批量完结。 3. 库存库位化：仓库 → 区 → 档 → 位置 四级树形结构，支持按库位调拨， 待处理数量标记，所有入库/调拨/报损/盘点均可退回并留痕。 4. 调拨流程：发起 → 仓管唯一确认 → 总仓减/发货仓加，超 30 分钟未确认自动提醒并每 30 分钟重复。 5. 模具台账：位置、维修状态、上机下机、关联产品与设备。 6. 权限体系：厂长 / 车间主管 / 仓库管理员 / 工人 / 送货员 五角色， 模块级 + 操作级双层权限控制。 7. 车间大屏：实时产量、合格率、工单进度，兼容老旧电视浏览器。 四、业务流程路径 厂长建工单 → 主管排产并绑定机台 → 工人扫码报工（自动入库 + 扣料） → 主管或厂长手动完结 → 仓管发起并确认调拨 → 发货仓发货

1. 基础聊天功能对标wechat，额外增加了团队功能。 2. 服务端golang+redis+mysql实现api业务通信，rust+redis+mongoDB实现im功能。 3. 客户端使用flutter框架配合本地sqlite数据库实现会话数据本地存储。 4. api通信使用签名和加密方式防止api盗用和破解。 5. im服务使用mqtt协议与客户端通信。 6. api与im使用gRPC协议通信。 7. 服务端使用docke方式可快速部署服务器

# 私域综合小程序（商城版） 按 `docs/` 契约开发。当前为 **合并部署**（`mall-boot` 单进程 8080），本地进程部署，**暂不用 Docker**。 ## 已完成 - P0 基座：`sql/`、`backend/`、`web-admin/`、`miniapp/`、`scripts/`、`deploy/` - P1 认证：微信登录（mock）、商家登录 RBAC、JWT - P2 商品域：C 端 M1~M4；商家端 B1~B17 + C1 上传；Web 轮播/分类/商品管理；写路径缓存失效 - M25 逆地理编码（未配置腾讯 key 时降级空结果，不阻断联调） - P3 交易闭环（模拟支付）：购物车/地址/券/预览/下单（M5~M14）；模拟支付 M19；订单列表/详情/取消/确认收货（M15~M18）；发货/备注/关单（B18~B22）；售后申请与审核（M20/M24、B23/B24）；经营看板（B25/B26）；超时关单与支付补偿定时任务 - 冒烟脚本：`scripts/smoke-p3.ps1`（交易闭环）；`scripts/smoke-member.ps1`（会员开通）；`scripts/smoke-exception.ps1`（库存不足/幂等/关单回补/超时关单/重复支付与回调）；`scripts/smoke-audit-ratelimit.ps1`（操作日志落库） ## 下一步（按 docs/08） - 真实微信支付 JSAPI + 回调验签/幂等 + 真实退款 APIv3（需商户资质） - P4 三端联调压测 / P5 上线；二期老年服务等扩展 ## 横切能力（近期完成） - 操作日志：B 端写接口 `@OpLog` → 表 `log_operation` - 限流：Redis `rate:ip` / `rate:user`（默认 500/5 QPS）+ 下单 1 次/秒；超限错误码 `1004` - 生产 Nginx/HTTPS：见 `deploy/README.md`；发布 `scripts/deploy-web.ps1`；验收 `scripts/check-prod-ready.ps1` ## 本地启动 敏感配置（JWT / DB / 微信）通过环境变量覆盖，见 `docs/07-开发环境与部署.md` 第 2 节；开发默认 `SPRING_PROFILES_ACTIVE=dev`。 ```powershell # 1) 确认 MySQL(root/123456) + Redis 已运行 # 2) 初始化库（首次，见 sql/README.md） mysql -uroot -p123456 --default-character-set=utf8mb4 -e "SOURCE d:/a-shuju

大量重复的图形界面操作和数据搬运只能人工做：每天定时截屏留证、批量点开同一个软件点同一串按钮、把手机里的文件倒到电脑上、把设备日志抓下来排查。这些活不难但耗人，做久了还容易点错。 本项目实现让程序替人操作电脑：截屏 → 定位目标 → 点击 → 再截屏验证，形成闭环；同时通过 ADB 无线调试打通手机，实现远程截屏、界面层级导出、双向文件传输和日志抓取，真正跨端。 大量重复的图形界面操作和数据搬运只能人工做：每天定时截屏留证、批量点开同一个软件点同一串按钮、把手机里的文件倒到电脑上、把设备日志抓下来排查。这些活不难但耗人，做久了还容易点错。 本项目实现让程序替人操作电脑：截屏 → 定位目标 → 点击 → 再截屏验证，形成闭环；同时通过 ADB 无线调试打通手机，实现远程截屏、界面层级导出、双向文件传输和日志抓取，真正跨端。

给领导或客户看数据时，Excel 发过去对方电脑上不一定装 Office，手机上更是打不开；用第三方图表库做出来的页面，一旦对方断网或者资源加载失败，整页就是空白。 本项目把 xlsx 一键转成单文件 HTML 报表：双击就能开、手机也能看、发给谁都不会掉样式。关键在于生成的 HTML 不引用任何外部资源，连图表都是用 SVG 手画的——所以一个文件就是全部内容，离线可用。 给领导或客户看数据时，Excel 发过去对方电脑上不一定装 Office，手机上更是打不开；用第三方图表库做出来的页面，一旦对方断网或者资源加载失败，整页就是空白。 本项目把 xlsx 一键转成单文件 HTML 报表：双击就能开、手机也能看、发给谁都不会掉样式。关键在于生成的 HTML 不引用任何外部资源，连图表都是用 SVG 手画的——所以一个文件就是全部内容，离线可用。