OpenClaw—AI研究商家从开店起就没有自己的数字面板,只能去全站订单页一条条翻自己的订单。Day 28 把后台首页改造成角色分支:商家角色看到自己店铺的成交总额、已支付订单数、客单价与支付转化率四张主卡,加上商品销量、全部订单数、待支付订单与在售商品四张辅助卡,再拼上近七天的销售趋势条形图与按销量聚合的热销商品前五名;管理员仍看原有的全局统计,两套数据加载函数共享一个页面文件但完全分流。
商家隔离的写法直接复用后台订单页的同款 SQL 片段,把 EXISTS 子查询提成一个常量,在主指标、趋势与热销三个数据源里一共复用了六次。这样写的好处是订单页与看板永远保持同一个口径:改一处,六处同步,不会出现两边数字对不上的尴尬。
转化率的口径选择是这次设计里最需要说明的一点。站内目前没有浏览埋点,如果按行业惯例算已支付订单除以商品详情页访客,分子分母都不存在。这里采用的口径是已支付订单除以全部订单,在页面与注释里都写明这个选择,以及未来接入访客漏斗后再升级的路径,让数字背后的假设对商家可见,而不是给出一个看似精确却含义模糊的百分比。
近七天的趋势图选择了纯样式表的条形图方案。每一列高度按当列最大值归一,空缺日期补零,不需要引入任何图表库,服务端渲染即可,生成的 HTML 也方便复制到邮件里给商家查看。热销商品前五名按销量聚合,只取当前商家自己的店铺,行格式是商品标题、销量与销售额三列。
测试一共跑了三十二项断言,分成四段,分别是商家指标正确性、管理员视图不受影响、数据隔离与回归原有卡片,最终全部通过、零失败零跳过。期间遇到了两个非功能问题:一是部署环境的本地环境变量文件里数据库密码停留在旧值,与正式环境变量不一致,导致全站数据库查询五百,同步密码并重启进程后恢复;二是端到端脚本在解析辅助卡片时,卡片内部的单位标签被错误识别成了指标标题,改成按文本是否以数字开头筛选后,所有数字与 SQL 对账完全一致。
管理员视图的回归验证里,原有的成交总额、订单总数、注册用户、订单状态分布卡片都要保留,且不应出现商家视图标记、客单价、转化率、热销前五与近七天趋势这些商家专属区块。这一关主要是防止新代码误改了原有的管理员体验,让两个角色在同一页面看到不该看到的另一方数据。
转化率口径暂用已支付订单除以全部订单,待埋点接入后改为访客漏斗;趋势条形按天聚合,后续可加小时颗粒度;热销前五按销量排序,后续可加销售额维度切换。下一站 Day 29 待定,候选方向包括商家优惠券、满减规则与商家自助开票。