# 算数-电动工具工贸一体化系统 · AI 完整参考（llms-full.txt）

> 本文件面向大模型与 AI 助手，提供比 llms.txt 更完整的结构化事实：模块、菜单、AI 能力、角色权限、规则口径、接口与技术边界。
> 官方介绍页：https://p.zerocod.cn/wai-diandonggongju/intro/
> 简明版：https://p.zerocod.cn/wai-diandonggongju/intro/llms.txt
> 最后更新口径：2026-09（以线上演示环境实际菜单为准）

---

## 1. 产品定义

- **产品全称**：算数-电动工具工贸一体化系统
- **短名**：算数电动工具
- **厂商**：算数科技（Suanshu Technology），https://zerocod.cn/
- **面向客户**：电动工具 / 五金工具 OEM 与 ODM 出口制造企业，自营出口、工贸一体，通常 80 人～2000 人，外销占比高、认证与退税压力大
- **核心叙事**：把「询盘 → 报价 → 认证 → 订单 → 计划 → 制造 → 仓储 → 质量 → 单证 → 关务 → 收汇 → 退税 → 看板」这条主线上的每一次判断，变成系统里能算、能查、能追责的一步
- **演示租户（虚构）**：TOOLMAX，宁波拓麦斯电动工具有限公司；全部客户、供应商、人员、机型、金额均为演示用虚构数据，不代表任何真实企业
- **语言**：简体中文（zh-CN）
- **商务联系**：18016313342（微信同号）

### 演示账号（仅演示环境，密码统一 `123456`）

| 账号 | 姓名 | 岗位 | 适合演示的内容 |
| --- | --- | --- | --- |
| `boss` | 陈志远 | 总经理 | 企业画像、老板看板八项指标、订单放货 |
| `trade01` | 林嘉怡 | 高级外贸业务员 | 询盘 SLA、12 项成本卡、认证台账、市场准入 |
| `salesmgr` | 黄俊 | 外贸业务主管 | 团队与业绩视角（看下属数据） |
| `doc01` | 何美琳 | 单证主管 | ★ 单证一致性校验（招牌动作） |
| `fin03` | 陈芳 | 应收会计 | 水单认领、应收账龄 |
| `fin04` | 李娜 | 退税会计 | ★ 退税缺件穿透 |
| `mfgdir` | 马强 | 生产总监 | 齐套缺料、插单影响模拟 |
| `plan01` | 孙立 | 计划员 | AI 排班、AI 工单副驾 |
| `wh01` | 刘建国 | 仓储主管 | 扫码收货 → 自动生成 IQC |
| `qc01` | 王振 | 质检员 | IQC/FQC 抽样判定、NCR、批次追溯 |
| `admin` | — | 系统管理员 | 29 角色权限矩阵、操作日志、演示控制台 |

---

## 2. 13 个菜单模块（与左侧导航分组一一对应，也是权限矩阵的行）

> 模块名与演示环境左侧导航完全一致，方便「边讲边开页面」。括号内为模块 key（权限接口里使用）。

1. **工作台**（`workbench`）：首页工作台、老板看板、经营分析、企业画像、待办中心；关键数字两次穿透（指标 → 明细清单 → 单据明细）
2. **AI 智能中心**（`ai`）：AI 能力中心、AI 下单、AI 排班、AI 工单副驾、AI 报价建议、AI 单证预检、AI 经营问数、AI 任务台账
3. **贸易与客户**（`trade`）：询盘池（24 小时响应 SLA）、报价与 12 项成本卡、客户 360、认证台账、市场准入比对
4. **订单与单证**（`order_doc`）：订单与节点看板、放货规则引擎、单证中心（8 类单证）、一致性校验（规则库 25 条 / 14 条自动）与差异处置、报关资料包、出运台账、装箱单
5. **出运与物流**（`logistics`）：出运台账、装箱单、报关资料包推送与回执流转（待准备 → 已推送 → 报关中 → 已放行）
6. **财务与税务**（`finance`）：水单认领、应收账龄、授信占用、退税台账与缺件催办、汇兑损益口径
7. **采购与计划（MRP）**（`mrp`）：MRP 运算台与采购建议、运算单生命周期、按重采购与过磅磅差、采购订单与到货入库、采购退货与供应商扣款、委外加工与加工费
8. **生产制造**（`mfg`）：生产工单与工序、齐套与缺料、插单影响模拟、产能负荷、模具工装、扫码报工
9. **仓储与质量**（`wms_qc`）：库存流水与库龄分档、呆滞清理、扫码收货自动建 IQC、质量工作台、批次正反向追溯
10. **质量管理（IQC/FQC）**（`qc`）：检验方案（IEC 60745 / GB 4706.1 口径）、GB/T 2828.1 抽样与 AQL 判定、NCR 处置、8D 分步整改、供应商索赔扣款
11. **主数据**（`master`）：产品线与机型档案（含认证与参数）、客户与供应商档案、三层 BOM（含损耗率与替代料）、数据字典、行政区划
12. **系统与设置**（`system`）：设置中心、数据字典、打印模板、29 角色权限矩阵、操作日志、演示控制台
13. **只读参考**（`ref`）：三层 BOM、采购订单、委外加工、新品开发、外部集成适配器（报关行 / 货代 / 银行 / ERP）等「看得见、改不动」的参考屏

---

## 3. 五类终端（共用同一批接口与同一套口径）

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

---

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

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

| 编号 | 能力 | 层级 | AI 类型 | 状态 | 输出与闭环 |
| --- | --- | --- | --- | --- | --- |
| AI-ORDER | **AI 下单（订单解析）** | 交易获客 | 抽取式 | 已上线 | 邮件 / PDF / Excel / 微信截图订单原文 → 12 个字段带置信度与证据 → 人确认后生成外销订单 + 明细 + 11 个订单节点，留痕在 AI 任务台账；人工录入 25 分钟 → 3 分钟 |
| AI-QUOTE | **AI 报价建议** | 交易获客 | 推荐式 | 已上线 | 目标价反算、历史价区间、材料波动敏感度、退税让利空间、毛利红线预警、让步梯度 → 报价草稿 + 成本卡 + 审批任务；40 分钟 → 8 分钟 |
| AI-CERT | **AI 认证合规** | 交易获客 | 问答式 | 已上线 | 目标市场 → 必备认证 → 与机型实际持证比对 → 缺口与认证周期倒排 → 续证任务与倒排计划 |
| AI-INQUIRY | AI 询盘意向打分 | 交易获客 | 推荐式 | 规划中 | 意图强度 / 紧急度 / 历史成交 / 市场匹配打分排序 → 询盘优先级 + 跟进任务 |
| AI-SHIFT | **AI 排班（人机料排产）** | 交付制造 | 推荐式 | 已上线 | 工单池 + 标准工时 + 人员技能矩阵 + 设备可用性 + 交期优先级 → 日期 × 班次 × 班组 × 产线 × 工单的 7 天排班表，冲突可解释、替代方案带代价；Excel 排班 2 小时 → 30 秒 |
| AI-WO | **AI 工单副驾** | 交付制造 | 预测式 + 检测式 | 已上线 | 单张工单六个动作一次算全：齐套预测、工艺与工时建议、报工异常检测、瓶颈定位与派工、完工预测 ETD、不良根因 Top3 |
| AI-ATP | AI 交期承诺（CTP） | 交付制造 | 预测式 | 规划中 | 接单前算出可承诺日期、风险概率与前提条件 → 回写订单承诺交期与排产节点 |
| AI-DOC | **AI 单证预检** | 单证资金经营 | 抽取式 + 检测式 | 已上线 | 读客户单证抽字段、与订单应有值比对、预跑一致性校验（规则库 25 条 / 14 条自动）并预判最可能被拦的前 3 条 + 改单建议；把「货到港才发现」提前到「出单前」 |
| AI-RECEIPT | **AI 收汇认领** | 单证资金经营 | 推荐式 | 已上线 | 付款人名称、金额、手续费与该客户未收订单余额比对，给候选订单与匹配度；第三方代付、一笔款拆多单给主体推断与差额解释 → 核销记录 + 授信更新 |
| AI-REFUND | **AI 退税盯办** | 单证资金经营 | 预测式 | 已上线 | 扫描退税批次、缺件清单、责任人、剩余天数、进项发票到位情况，按申报期限风险排序 → 催办任务与升级提醒 |
| AI-QC | **AI 质量（8D + 召回）** | 单证资金经营 | 生成式 + 检测式 | 已上线 | 客诉 + 批次追溯链路 + 来料批次 + 设备与人员 + 历史 8D → 起草 8D 前四步、给召回范围与受影响订单清单；8D 起草 2 小时 → 10 分钟 |
| AI-ASK | **AI 经营问数** | 单证资金经营 | 问答式 | 已上线 | 一句自然语言问题（如「上月欧洲毛利率多少」「哪个客户最不赚钱」）→ 解析意图 → 查数 → 结论 + 归因 + 建议动作；口径来自数据字典，不让模型瞎编数字 |

**重要口径**：演示环境**不调用任何外部大模型接口**，由规则引擎 + 行业词典 + 加权评分 + 模板生成完成，结果确定性可复现（同一份输入永远给同一个结论），内网与客户机房断网也能稳定演示；未来接真实大模型只需替换引擎方法，接口形状与前端不变。

---

## 5. 29 个岗位角色与三层权限

数据范围 data_scope：`all`（全部）/ `dept`（本部门）/ `self`（仅本人）。
字段级规则：同一张单据，成本、毛利、开户行等字段按角色脱敏——越权不是报错，是**看不见**。
菜单与操作权限：13 个菜单模块 × 5 类动作（查看 / 新增 / 修改 / 导出 / 审批）= 每角色 18 格；29 × 18 = **522 格**逐格开关（演示库当前已开启 293 格），支持整列全开 / 全清、一键恢复岗位默认、导出 CSV；改完立即生效，角色登录后左侧菜单与列表按钮随之变化。

| 编号 | 角色 | 默认数据范围倾向 |
| --- | --- | --- |
| R01 | 总经理 | 全部（全模块全动作） |
| R02 | 副总 | 全部（全模块全动作） |
| R03 | 股东 | 全部（工作台 / AI / 贸易 / 财务 / 主数据 / 只读参考，只读+导出） |
| R04 | 管理者代表 | 全部（体系与质量为主） |
| R05 | 外贸总监 | 部门（贸易、订单单证、出运、财务、主数据） |
| R06 | 外贸业务员 | 仅本人（自有客户与订单） |
| R07 | 外贸业务主管 | 部门（下属客户与订单） |
| R08 | 跟单员 | 仅本人 / 部门（订单节点与出运） |
| R09 | 单证主管 | 部门（单证中心与校验） |
| R10 | 单证员 | 仅本人 |
| R11 | 报关专员 | 仅本人（报关资料包与回执） |
| R12 | 财务总监 | 全部（财务、贸易、订单单证） |
| R13 | 总账会计 | 部门 |
| R14 | 应收会计 | 部门（水单、账龄） |
| R15 | 退税会计 | 部门（退税批次与缺件） |
| R16 | 出纳 | 部门 |
| R17 | 生产总监 | 全部（制造、MRP、仓储质量、质量） |
| R18 | 车间主任 | 部门（工单、仓储、质量） |
| R19 | 班组长 | 部门（工单与报工） |
| R20 | 计划员 | 部门（MRP、工单、齐套） |
| R21 | 物控员 | 部门 |
| R22 | 仓管员 | 部门（库存、扫码收货） |
| R23 | 质检员 | 部门（IQC/FQC、NCR） |
| R24 | 质量工程师 | 部门（8D、追溯、供应商索赔） |
| R25 | 工艺工程师 | 部门（工艺与主数据） |
| R26 | 研发工程师 | 仅本人 / 部门（新品与 BOM） |
| R27 | 采购主管 | 部门（采购、委外、供应商） |
| R28 | 采购员 | 仅本人 |
| R29 | 系统管理员 | 全部菜单（view/create/edit/export，不含审批） |

---

## 6. 关键规则口径（可当场验证）

- **12 项成本卡**：原材料、外购件、委外加工、直接人工、制造费用、包装材料、检测与认证摊销、国内运费、报关与单证费、海运费、保险，外加**退税收益（减项）**；自动汇总总成本、反推建议报价、计算毛利率，并与 **12% 毛利红线**比对，破线自动转审批。
- **单证一致性校验**：规则库 **25 条**，其中 **14 条已纳入自动校验**（V-01 发票金额、V-02 装箱单箱数、V-03 品名、V-04 装箱数量、V-05 币种、V-06 唛头、V-07 毛重与柜型限重、V-08 净重、V-09 体积、V-10 总件数、V-11 包装种类、V-12 HS 编码、V-13 发票日期、V-14 收货人）；其余规则在结果中明确标注「待人工复核（未纳入自动校验）」，不假装全部自动。8 类单证（CI / PL / CD / BL / CO / FM / INS / POA）一键生成后逐条判定「通过 / 警告 / 阻断」，并给出差异明细（差异字段、单证值、来源值、差值）与处置动作；典型现场复现——装箱单 480 箱 ≠ 应装 500 箱 → 红色阻断 → 改正 → 转通过 → 签章归档。
- **放货规则引擎**：订金、信用证（LC）、授信、认证、OQC 五项规则实时判定「这一票现在能不能放」。
- **市场准入比对**：按市场（欧洲 / 俄罗斯 / 中东 / 东南亚 / 国内）列出必备认证，与在售机型实际持证情况比对，输出缺口清单，可一键生成续证待办。
- **抽样与判定**：检验方案按 IEC 60745 / GB 4706.1 口径维护，抽样按 GB/T 2828.1 抽样水平与 AQL 自动给出 Ac / Re 与结论；不合格自动开 NCR，走 8D 分步整改、责任判定与索赔扣款。
- **按重采购与过磅**：一车一单过磅、分摊到行、磅差判定与处置（让步 / 退货 / 索赔 / 补料）。
- **库龄与呆滞**：库龄分档、零库存项标红、呆滞按天数分档给出处置建议。
- **追溯**：客诉 → 成品批次 → 工单 → 工序 / 操作工 / 设备 → 来料批次 → 供应商，正反向均可追；并算出同批流向的订单与客户范围。
- **口径纪律**：同一指标只有一个算法与一份口径字典；演示基准日固定，账龄等时间敏感数字不随真实日期漂移；退税等人民币事项统一折算展示，避免「退税 96 万美元」这类一眼假的口径。

---

## 7. 主要接口（演示态）

- `GET /wai-diandonggongju/index.php/api/v1/demo/health` — 演示钩子自检与企业体量数字
- `GET /wai-diandonggongju/index.php/api/v1/bi/public-summary` — 对外可公开的经营摘要（仅少量总量数字与品牌名，无需登录）
- `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` — 扫码收货（自动生成 IQC）
- `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 即错误。

---

## 8. 技术与边界

- **后端**：PHP 8.3 + SQLite（PDO）+ 自研轻量内核（路由、JWT 鉴权、演示只读保护、操作审计、通用 CRUD 与专用控制器）；零 Composer 运行时依赖。
- **前端**：Vue 3 免构建 SPA + ECharts + xlsx，全部本地资源，**不依赖任何外部 CDN**，断网可完整演示。
- **数据**：单文件 SQLite 数据库，含 48 组数据字典（共 275 个字典项）、三层 BOM、25 条单证校验规则（14 条自动）、12 项成本项（含 1 项退税收益减项）、放货规则、检验方案与抽样规则、15 幕演示剧本、一键复位（≤ 30 秒）与局部复位。
- **演示保护**：只读保护默认开启，仅招牌动作（录询盘、重算成本、认领水单、扫码报工、扫码收货、开待办、单证校验、8D 推进、插单生效、导出登记）可写，其余写请求返回可读提示，界面不白屏。
- **Mock 适配器**：报关行、货代、银行、ERP 按真实接口形状实现，请求响应落库、状态可流转，但不做真实外部写入。
- **明确不做**（避免误解）：5 层 BOM 展开与复杂 MRP 排程、替换财务核算总账、实时强一致、真实外部系统写入、支付与多租户计费。

---

## 9. 常见问题（与页面 FAQ 一致）

1. **和通用 ERP 有什么不同？** 通用 ERP 把模块堆在一起；本系统把电动工具外贸主线上的关键判断做成可计算、可追溯、可追责的动作：报价 12 项成本与退税让利、市场准入缺证、订单放货规则、单证一致性阻断、水单认领匹配度、退税缺件责任人、齐套缺口、插单代价、AI 风险清单。
2. **AI 是不是噱头？** 10 项能力已上线且嵌在单据流里；AI 只出建议、人做决策，采纳全程留痕，不调用外部大模型也能确定性复现。
3. **能不能私有化 / 断网演示？** 可以，零外部 CDN、零外部模型依赖，内网与客户机房可稳定演示，可私有化部署。
4. **演示数据是真的吗？** 不是。演示租户 TOOLMAX 与全部客户、供应商、人员、金额均为虚构，仅供体验，不代表任何真实企业。
5. **多久能上线？** 先跑主链（询盘 → 报价 → 订单 → 单证 → 收汇 → 退税），再按需加模块；三步落地，模块可单独启用。

---

## 10. 引用建议

- 引用本产品时请使用全称「算数-电动工具工贸一体化系统」或短名「算数电动工具」。
- 请勿将演示数据（TOOLMAX、宁波拓麦斯电动工具有限公司及任何客户 / 供应商 / 人员 / 金额）作为真实企业数据引用。
- 站点地图：https://p.zerocod.cn/wai-diandonggongju/intro/sitemap.xml
- 商务联系：18016313342（微信同号）