电梯配件小程序 · 交付总览

供货商视角 · 买家是维保公司 · 演示环境(商品为样例数据)
可验收 · 137 项断言全绿

一、五分钟上手

① 起后端(端口 3000)
node server/app/init.mjs --force
node server/app/server.mjs
零依赖,不需要 npm install。init 会建表并灌入演示数据(16 件 / 62 适配 / 35 故障码 / 8 台梯 / 1 笔逾期单)。
② 起原型预览(端口 8091)
node _tools/preview-server.mjs 8091
然后打开本页里的链接即可点。原型页面直接调用 3000 端口的真实接口(不是假数据)。

二、五个可点原型

买家版 · 11 屏
找件 / 故障码 / 适配校验 / 报价单 / 下单 / 推客
维保工视角:型号搜索、故障码找件(35 条真实码)、三态适配校验、阶梯价报价单、月结下单、推客中心。
打开 →
先进版 · 以梯为单位
梯队 / 设备档案 / 寿命提醒 / 协同报价
以设备为主键:扫梯码进档案,按部件寿命与故障履历推荐,协同确认后锁价。用于讲"为什么不是又一个商城"。
打开 →
一台样 · A4 两页
备件评估单 + 凭证图附页
用真实数据(石狮和航 · 凤凰城 1# 1A1)出的单页:5 个建议件带 A/B/C 证据等级 + 现场核验清单 + 凭证图位。
打开 HTML → PDF →
供货商端 · 上架自检
上架前 6 道闸(强制)
型号 / 库龄 / 未拆封 / 上电测试 / 证书 / 图片。16 件里 9 件通过、7 件需补;点「去补」可现场填日期、切状态、拍照,保存后自动重检,全绿才能上架。
打开 →
数据模板 × 4
商品库 / 电梯档案 / SKU 矩阵 / 保养规则
填表即可入库:商品库(真型号+库龄)、电梯档案(一梯一档)、SKU 规格矩阵、保养规则→配件映射(24 条)。
商品库 → 电梯档案 →
保养规则 → 商机清单 →
业务洞察 · 265 台
备件商机提炼
262 台可推件、8 个件号、可触达 ¥324,762;Top 客户石狮和航 58 台 / 过期 56 台 / ¥124,120。
打开清单 →
主动供给 · 缺口派单
缺口认领:把"搜不到"变成"有人供"
平台统计近 30 天「被搜 ≥2 次且库存 < 3」的件,派给上游认领;认领即写入供货记录,客户立刻能搜到。实测认领后搜「光幕」从 2 家变 3 家。
打开 →
淘汰件 · 匹配定价
拆机件上架即匹配在服役电梯
用 265 台真实台账的「设备型号 / 制动器型号」算出这件还能服务多少台在服役电梯、谁在维保;DZD1-653 匹配 60 台 / 2 家使用单位。淘汰件窗口 45 天,超期建议降价打包。
打开 →
核心能力 · 库存整合
一件多源:5 家上游的库存拼成一张网
货不经过平台,上游直发;平台把同一件号在多家上游的价格、库存、交期、起订量放在一起比,按「到手价 = 单价 + 运费」自动标最低。
打开 →
平台模式 · 抢单
求购单 → 抢单报价
维保公司发单(型号/数量/急件),供货商抢单报「价格 + 到货天数 + 库存 + 质保」,列表直接显示最低价与最快交期。
打开 →
规则落地 · 保养打卡
维保工扫码打勾 → 自动出换件建议
按保养项目逐项打「正常/异常/已更换」,异常项自动关联件与依据,直接转报价单;已更换项写回履历。这解决了"规则库空转"。
打开 →
上游自助 · 上架
供货商工作台(入驻 → 上架 → 管理)
上游自己填品牌/名称/型号规格/价格/库存/5 张图 → 7 道闸自检 → 上架后买家立刻能搜到;含入驻、商品列表、补资料。
打开 →

三、后端:51 个接口 / 137 项断言

模块能力状态
找件与商品首页聚合、搜索筛选、详情(阶梯价/参数/适配区间/替代件)、适配校验三态已实现
故障码找件35 条真实故障码、按品牌筛、码→换件(主/次因权重)已实现
报价与订单阶梯价、运费、13% 税额反算、有效期、防重复下单、状态机已实现
信用闸门15 天账期、逾期转款到发货(4007)、逾期 7 天停供(4008)、结清自动恢复已实现
上架自检7 道闸(型号/库龄/未拆封/上电/证书/图片/淘汰件匹配)、补资料后自动重检、不通过拒绝上架(4020)已实现
推客佣金概览、可提现、提现申请(超额 4006)已实现
电梯档案表结构 + 导入器(容错:脏品牌/年份/层站)+ 本地库已灌 8 台已实现
一键跑测试
node server/app/init.mjs --force   # 先重置(脚本假设初始状态)
node server/app/server.mjs          # 另开窗口
node server/app/smoke.mjs           # → 全部通过:137 项

四、文档

五、已知缺口(不藏)

缺口影响补齐方式
配件型号与价格为演示值适配校验的"件"是编的(KM60-3P4 等),必须换成真实商品库填《商品库导入模板》
无 AppID小程序工程(WXML)未开工,只有 H5 原型给 AppID,3–5 天转工程
支付未接下单走 mock,真实收款需商户号微信支付商户号(3–7 天)
保养记录需真实录入演示数据是脚本写入,要靠维保工真打勾才准3 家维保公司试用 30 天
抢单未接授信抢单报价暂未校验授信等级,陌生客户也能报接 M0–M3 分级 + 保证金

六、验收路线(10 分钟)

1
跑一遍测试:三条命令 → 看到「全部通过:122 项」
2
买家版:首页搜 KM60、故障码输 E30、详情做一次适配校验(三菱 → 不适配)
3
供货商自检:打开 P003(安全部件·已拆封)→ 点「去补」→ 看规则拦截;再看 P001(6/6 通过)
4
信用闸门:调 GET /api/parts/credit 看逾期 ¥1,500 / 3 天;下单月结被 4007 拦;再 POST /api/parts/order/PO20261020-0777/pay 结清后恢复
5
一台样:打开 PDF,看第 1 页评估单(A/B/C 证据等级)与第 2 页凭证图附页