# 算数-电动工具工贸一体化系统（算数电动工具）

> 面向电动工具与五金工具 OEM / 出口制造企业的工贸一体化系统。把「询盘 → 报价 → 认证 → 订单 → 计划 → 制造 → 仓储 → 质量 → 单证 → 关务 → 收汇 → 退税 → 看板」这条主线上的每次判断，变成系统里能算、能查、能追责的一步。

- 产品全称：算数-电动工具工贸一体化系统
- 短名：算数电动工具
- 演示租户（虚构）：TOOLMAX · 宁波拓麦斯电动工具有限公司
- 演示账号（密码统一 `123456`）：boss / trade01 / salesmgr / doc01 / fin03 / fin04 / wh01 / qc01 / plan01 / mfgdir
- 语言：简体中文（zh-CN）
- 站点入口：https://p.zerocod.cn/wai-diandonggongju/

## 核心场景

- 报价 12 项成本卡：原材料、外购件、委外加工、直接人工、制造费用、包装材料、检测与认证摊销、国内运费、报关与单证费、海运费、保险、退税收益（减项）；自动汇总总成本、反推建议报价、算毛利率并与 12% 红线比对。
- 市场准入比对：按市场（欧洲/俄罗斯/中东/东南亚/国内）列出必备认证，与在售机型实际持证情况比对，输出缺口清单并可一键生成续证待办。
- 单证一致性校验：规则库 25 条（8 类单证 CI/PL/CD/BL/CO/FM/INS/POA），其中 14 条已纳入自动校验，生成后逐条给出通过/警告/阻断与差异明细（差异字段、单证值、来源值、差值）；其余规则在结果中标注「待人工复核」，不假装全部自动。
- 水单认领：未认领水单按汇款人、金额、币种、日期邻近度给出候选订单与匹配度，人工确认后认领核销。
- 退税缺件穿透：批次 → 缺件清单（缺件类型、涉及订单、责任方、责任人、剩余天数、状态）→ 一键催办。
- 齐套与缺料：按工单三层 BOM 算齐套率，列出缺料项与主责供应商、预计到货。
- 插单影响模拟：算出受影响工单、原交期 vs 影响后交期、产能占用变化与可承诺答复交期。
- 平板扫码报工与收货：扫码 → 选工序/填数量 → 提交；工单进度实时回写，不良自动登记，自动生成 IQC 检验单。
- 车间实时大屏：工单进度墙、当日产出与不良、实时报工流、班次与车间产出、异常滚动、设备状态，5 秒刷新。
- 批次正反向追溯：客诉 → 成品批次 → 工单 → 工序/操作工/设备 → 来料批次 → 供应商，并算出同批流向范围。
- 老板看板：八个数字 + 风险哨兵，任一数字两次穿透（指标 → 明细清单 → 单据明细）。
- 角色权限矩阵：29 个岗位角色统一配置三层授权 —— 数据范围（全部/本部门/仅本人）、字段可见性（成本、毛利、开户行等按角色脱敏）、菜单与操作权限（13 个菜单模块 × 查看/新增/修改/导出/审批 5 类动作，29 × 18 = 522 格）逐格开关，可按列全开全清、一键恢复岗位默认并导出 CSV；改完立即生效，某角色登录后左侧菜单与列表按钮随之变化。
- 13 个菜单模块（与左侧导航分组一一对应）：工作台、AI 智能中心、贸易与客户、订单与单证、出运与物流、财务与税务、采购与计划（MRP）、生产制造、仓储与质量、质量管理（IQC/FQC）、主数据、系统与设置、只读参考。

## AI 智能中心：12 项能力（10 项已上线 / 2 项规划中）

统一范式：喂料 → 分析（结论 + 置信度 + 推理步骤 + 依据原文）→ 挑坑（主动指出不确定与风险）→ 落库（人确认后生成单据/任务并写采纳留痕）。

| 能力 | 状态 | 闭环到哪张单 |
| --- | --- | --- |
| AI 下单（订单解析） | 已上线 | 外销订单 + 明细 + 11 个订单节点 |
| AI 报价建议 | 已上线 | 报价草稿 + 成本卡 + 审批任务 |
| AI 认证合规 | 已上线 | 续证任务 + 认证周期倒排 |
| AI 询盘意向打分 | 规划中 | 询盘优先级 + 跟进任务 |
| AI 排班（人机料排产） | 已上线 | 7 天排班计划 + 派工任务 |
| AI 工单副驾 | 已上线 | 工单排程 + 补料/异常待办（单张工单六个动作一次算全） |
| AI 交期承诺（CTP） | 规划中 | 回写订单承诺交期与排产节点 |
| AI 单证预检 | 已上线 | 校验差异 + 改单建议（预判最可能被拦的前 3 条） |
| AI 收汇认领 | 已上线 | 核销记录 + 授信更新 |
| AI 退税盯办 | 已上线 | 催办任务 + 升级提醒 |
| AI 质量（8D + 召回） | 已上线 | 8D 报告 + 召回任务 + 受影响订单清单 |
| AI 经营问数 | 已上线 | 日报 / 周报 / 待办 |

演示环境不调用任何外部大模型接口（规则引擎 + 行业词典 + 加权评分 + 模板生成），结果确定性可复现；未来接真实大模型只需替换引擎方法。

## 交付形态

| 端 | 说明 | 地址 |
| --- | --- | --- |
| PC 管理端 | 40+ 屏业务工作台，含演示控制台与一键复位 | /wai-diandonggongju/web/ |
| 平板扫码端 | 扫码报工、扫码收货（大按钮、三步内完成） | /wai-diandonggongju/mobile/ |
| 车间大屏 | 生产实时看板，5 秒刷新 | /wai-diandonggongju/screen/workshop.html |
| 老板看板 | 经营驾驶舱，两次穿透到单据 | /wai-diandonggongju/screen/boss.html |
| 产品介绍页 | 对外门户（本页同级） | /wai-diandonggongju/intro/ |

## 技术与口径

- 后端：PHP 8.3 + SQLite（PDO）+ 自研轻量内核（路由、JWT 鉴权、演示只读保护、操作审计、通用 CRUD 与专用控制器）；零 Composer 运行时依赖。
- 前端：Vue 3 免构建 SPA + ECharts + xlsx，全部本地资源，不依赖外部 CDN，断网可完整演示。
- 数据：48 组数据字典（共 275 个字典项，全系统共用口径）、三层 BOM、25 条单证校验规则（14 条自动）、12 项成本项、放货规则、15 幕演示剧本、一键复位（≤30 秒）与局部复位。
- 边界：不做 5 层 BOM 展开与复杂 MRP、不替换财务核算、不做实时强一致、不接真实外部系统写入、不做支付与多租户计费。
- Mock 适配器：报关行、货代、银行、ERP 按真实接口形状实现，请求响应落库、状态可流转。

## 主要接口（演示态）

- `GET /wai-diandonggongju/index.php/api/v1/demo/health` — 演示钩子自检与企业体量数字
- `GET /wai-diandonggongju/index.php/api/v1/bi/public-summary` — 对外可公开的经营摘要（只有 5 个总量数字与品牌名，无需登录）
- `GET /wai-diandonggongju/index.php/api/v1/bi/boss` — 老板看板指标与风险哨兵（**需登录**；大屏用 `?t=<token>` 交接令牌）
- `GET /wai-diandonggongju/index.php/api/v1/bi/analysis` — 市场 / 客户 / 机型 / 业务员多维分析（**需登录**）
- `GET /wai-diandonggongju/index.php/api/v1/bi/drill/{key}` — 指标 → 业务明细（**需登录**）
- `GET /wai-diandonggongju/index.php/api/v1/mfg/workshop-board` — 车间大屏实时数据
- `GET /wai-diandonggongju/index.php/api/v1/scan/board` — 平板端可扫工单与物料
- `GET /wai-diandonggongju/index.php/api/v1/scan/lookup?code=` — 条码解析（工单 / 物料）
- `POST /wai-diandonggongju/index.php/api/v1/work-reports` — 扫码报工
- `POST /wai-diandonggongju/index.php/api/v1/receives` — 扫码收货
- `GET /wai-diandonggongju/index.php/api/v1/auth/perms` — 当前登录用户的菜单与操作权限（前端据此裁菜单、裁按钮）
- `GET /wai-diandonggongju/index.php/api/v1/auth/role-matrix` — 29 个角色 + 数据范围 + 字段规则 + 菜单/操作权限矩阵
- `POST /wai-diandonggongju/index.php/api/v1/sys/role-perm`（单格）/ `sys/role-perm/bulk`（整列）/ `sys/role-perm/reset`（恢复岗位默认）
- `GET /wai-diandonggongju/index.php/api/v1/sys/role-perm/export` — 权限矩阵导出数据（前端落成 CSV）
- 返回体统一：`{"code":0,"message":"success","data":{...}}`（`code` 非 0 即错误）

## 说明

- 演示数据为虚构：品牌 TOOLMAX、宁波拓麦斯电动工具有限公司以及全部客户、供应商、人员均不代表任何真实企业。
- 演示态开启只读保护：仅招牌动作（录询盘、重算成本、认领水单、扫码报工、扫码收货、开待办、单证校验、8D 推进、插单生效、导出登记）可写，其余写请求返回可读提示，界面不白屏。
- 本文件路径：`/wai-diandonggongju/intro/llms.txt`（简明版）；完整参考：`/wai-diandonggongju/intro/llms-full.txt`；智能体索引：`/wai-diandonggongju/intro/ai.txt`；爬虫声明：`/wai-diandonggongju/intro/robots.txt`；站点地图：`/wai-diandonggongju/intro/sitemap.xml`；整站 AI 简明索引：`/wai-diandonggongju/llms.txt`。