银河毛制 · 商家码查验系统
需求整理 V2 · 2026-11-16 · 官网延伸的公开查验入口
客户目前没有查验系统,本项目从零新建。对标 OEKO-TEX 官网的公开查验入口,但功能大幅简化——首期只交付「一码一页 + 后台维护 + 官网入口」的最小可用版本,不做独立建站,而是在现有官网延伸一个固定入口。
一、核心链路:四步走完,不进登录页
整个链路只有一条单向路径,没有分支、没有回环:官网固定链接 /verify 进入查验页 → 终端客户输入商家码(示例 10001)→ 系统校验编码是否有效 → 通过后跳转到该商家的专属展示页。
两个硬约束需要写进合同或验收标准,避免后续被当成可选项:无需登录、无需扫码;展示页是终点,不再做二次跳转链接。
四步验证链路:入口、输入、校验、展示,单向无回环。
二、范围边界:首期做什么,明确不做什么
需求收敛的关键不在于列清楚要做什么,而在于把不做什么写死。以下六项在本次需求中明确排除,后续客户若提出,应作为二期单独立项:
产品级信息(SKU / 规格 / 批次)、防伪判定(只验证码是否在库有效,不承诺真伪结论)、扫码溯源、证书校验、多语言,以及 OEKO-TEX 证书编号接入。
这个边界很重要。客户容易把「查验」理解成「防伪 + 溯源 + 证书」的合集,实际首期只是一个信息展示页。如果在报价阶段不把这条线划清,交付时必然产生争议。
左:首期三项交付;右:六项明确不做。
三、页面展示内容
展示页字段控制在四项:商家编码持有者名称、所在地区(如「广东佛山xxxx」)、品牌信息、产品系列(文字罗列,可配客户系列床垫照片)。
纯展示,不设交互。移动端优先——终端客户绝大多数是在手机上扫开或点开链接,桌面端适配即可,不必做响应式优先级反转。
四、后台与数据模型
一个商家码对应一条独立商家档案。编码规则暂定 5 位数字、从 10001 起,初期商家少可直接固定录入,商家增多时持续新增。
档案字段设计如下表。其中两个字段值得单独说明:状态与违规标记必须分开。「停用」表示该码不再对外展示,「标红」表示页面仍然可访问但需要提示异常——两者语义不同,合并成一个字段会导致前台判断逻辑混乱。
档案字段:商家码(唯一)、名称、介绍、联系方式、地址、官网、LOGO、产品图(多张)、状态(启用/停用)、违规标记(布尔 + 原因)。支持新增、修改、停用,且内容与状态必须随时可改。
五、技术实现
在 Odoo 内完成,不引出独立系统。分四层:在 Odoo 建「商家档案」自定义模型承载数据;暴露一个查询接口,输入商家码校验有效性后返回商家信息;查验页面挂到官网 /verify;前台查询页按客户品牌色与 Logo 做视觉设计。
选择在 Odoo 内实现而非单独建站,主要考虑是客户后续要自己维护档案,复用 Odoo 的后台与权限体系成本最低。
六、前置依赖(阻塞项)
三项依赖未完成前,功能可以开发,但无法上线验收,这一点需要在报价阶段就向客户说明:
服务器——官网、Odoo、查验功能均由客户自有服务器承载,需先完成采购。站点主次——以国内站 enkevcn.com 为主,国外站 enkev.com 属总部,仅作设计参考。数据迁移——官网数据需先从原合作企业服务器迁出,迁移完成后再推进改版与查验链接上线。
七、待确认清单
六项需要客户明确,其中前两项直接决定工作量,建议优先锁定:
编码规则——位数与前缀,是否与厂家内部客户编号一致,直接决定数据模型主键与校验逻辑。页面字段——固定展示字段范围,是否需要 LOGO 与产品图,决定前端页面工作量。域名归属——查验链接挂客户官网还是我方域名代挂。维护方式——客户自行维护还是我方代维护,是否需要培训与操作手册。标红规则——「违规标红」的具体判定条件与页面呈现方式。数量与商务——商家数量上限、续费安排、正式合同。
八、当前进展
11 月 9 日下午已召开线上需求会「银河毛制官网改版 + 商家码查验系统产品沟通」,大花、黄硕、李明阳等共 5 人参加。李明阳已确认查验逻辑与页面形态,需求边界基本收敛为「输入编码 → 纯信息展示」。
下一步:待确认清单落定后即可出报价与工期方案。建议先锁定编码规则与页面字段两项,其余并行确认。
文档版本 V2.0|整理:富兰克林|2026-11-16|来源:网站及查询链接沟通群讨论 + 需求描述终稿 V2 + 11-09 线上需求会