赵阳智脑 · 业务方案
业务沟通稿 / V0.4

达人带货与设备绑定

从达人把智脑家长端卖给家长,到家长进店购买设备、扫码绑定,
把达人、家长、门店与每一台设备的关系记录清楚。

2026 年 9 月 20 日 · 用于业务沟通与方案评审阅读顺序:业务全景 → 功能模块 → 完成标准
01

整体业务场景

平台为达人小林创建一个机构,并在机构下开通一批家长端账号。小林向家长售卖智脑家长端,把对应的家长端账号交给家长使用,同时推荐家长到使用赵阳智脑的门店购买设备。家长到明亮眼镜店后,与门店互相扫码关联;购买设备后,登录智脑家长端,扫描设备上的专属二维码完成绑定。

绑定完成后,小林在自己机构的子席位管理中,就能看到这位家长关联了哪家门店、绑定了什么设备、设备唯一码是多少、什么时候绑定。平台可查询完整记录,达人和门店据此核对后续费用。

总流程 / 从设备准备到记录核对
1平台准备

建立达人机构并开通家长端账号;导入设备与下放门店,生成设备码。

2达人售卖家长端

向家长销售智脑家长端,交付账号,推荐到门店选购设备。

3家长到店关联

门店与家长互扫,建立服务关系,关联视光档案。

4家长扫码绑定

在智脑内扫设备码,核对名称与设备唯一码,确认绑定。

5后台形成记录

串联账号来源、关联门店、设备唯一码和绑定时间。

6查询与后续服务

达人查看、平台导出;需要时由家长或平台解绑。

图示为典型业务顺序。设备准备与账号开通可以同时进行;若家长先绑定设备、后关联门店,分别保留两次操作的时间和记录。

平台

准备设备码、管理设备、查询记录、处理售后。

达人

售卖智脑家长端并交付账号,查看名下家长的设备记录。

家长

登录智脑、关联门店、绑定设备、管理自己的设备。

门店

接待家长、销售设备、提供档案服务、核对业务记录。

贯穿全流程的一条规则:家长账号始终归最初开通它的达人机构;后续关联其他门店,只改变服务关系。
01+

用大白话再讲一遍:这件事是怎么跑起来的

不看系统、不看字段,只按日常做生意的顺序,把每一步谁来做、需要什么、做完得到什么讲清楚。

大白话流程 / 一步一步照着走
第 1 步 · 平台把设备准备出来

厂家把每台设备的厂商、类型、名称、设备唯一码,以及这台设备下放给哪家门店(营业执照名称)给我们,我们导入系统,生成每台设备专属的二维码,下载下来印成设备贴纸。

做完得到:每台设备一个码,扫码就能认出是哪一台、哪个厂家的什么设备、下放给哪家门店。
第 2 步 · 平台给达人开好家长端账号

平台为达人建一个机构,在这个机构下面开通一批家长端账号,账号交给达人。

做完得到:达人手里有一批可以卖给家长的账号。
第 3 步 · 达人把智脑家长端卖给家长

达人向家长销售智脑家长端,把对应的家长端账号交给家长,并建议家长到使用赵阳智脑的门店购买设备。

做完得到:家长手里有了一个可用的家长端账号。
第 4 步 · 家长与门店到店,互相扫一下

家长到门店后,双方互相扫码关联。门店拿到为这个家长提供服务的资格,孩子的视光档案也出现在该门店可查看范围内。

做完得到:家长和门店建立了服务关系。
第 5 步 · 家长把买到的设备绑到自己账号上

家长登录智脑家长端,扫描设备上的设备码,看到设备名称和设备唯一码,确认后就绑定完成。之后再买设备,可以继续扫,一台一条记录。

做完得到:这台设备归到这个家长名下,并记下了绑定时间。
第 6 步 · 达人打开后台,看看卖出去的家长买了什么

达人进入自己机构的子席位列表,点开这位家长,就能看到关联了哪家门店、绑定了什么设备、设备唯一码是多少、什么时候绑定的。

做完得到:达人知道自己带来的家长实际买了什么、在哪家店服务。
第 7 步 · 平台与门店导出记录,双方对账

平台可以按门店、设备、设备唯一码和时间导出记录,门店和达人拿着同一份清单核对业务。

做完得到:双方有据可查的核对清单。
需要时 · 家长或平台退货、换设备,就把设备解绑

家长可以在“我的设备”里自己解绑;遇到账号用不了或需要门店协助的情况,门店把设备唯一码报给平台,由平台核实后解绑。

做完得到:这台设备可以重新绑定,原来的记录仍然查得到。
如果只记住三句话:
达人卖的是家长端,账号一直挂在达人机构下;
设备靠唯一码认人,谁扫就记到谁名下;
门店关系单独记,换店不换达人归属。
02

设备管理:让每台设备都有专属二维码

操作人:平台管理员入口:平台后台 → 设备管理

厂家提供这批设备的唯一码,以及每台设备下放到的门店,平台导入到智脑。每个唯一码对应一台实物设备和一个专属二维码,供后续打印、贴标与家长扫码。

设备要管理哪些信息

信息项说明示例
设备类型设备的品类,用于分类和统计护眼灯
设备厂商设备的生产厂家某某光学
设备名称具体型号名称,家长扫码时看到的就是它护眼灯 A 款
设备唯一码每台设备一个,全局唯一;也是二维码图片名ZY000128
对应门店营业执照名称这台设备下放到的门店,用营业执照上的全称某某市明亮眼镜有限公司

虚构示例。营业执照名称用全称,避免简称重名或同名不同店造成下放门店认错。

厂家导入表:唯一码与门店对应

厂家按上面五项提供导入表,平台导入智脑。每台设备下放给哪家门店,以这份表为准。

设备类型设备厂商设备名称设备唯一码对应门店营业执照名称
护眼灯某某光学护眼灯 A 款ZY000128某某市明亮眼镜有限公司
护眼灯某某光学护眼灯 A 款ZY000129某某市明亮眼镜有限公司
训练设备某某光学训练设备 B 款ZY000130某某市康视力眼镜有限公司

虚构示例,用于说明五列内容的对应关系,不代表真实厂商、设备或门店。

导入时怎么校验
唯一码为空、重复、已存在,设备类型或厂商缺失,营业执照名称为空,逐行提示原因。营业执照名称在系统里匹配不到对应机构时,单独列出待确认,不猜测归属。先预览检查结果,确认无误再导入,异常行修改后可重新上传。
导入后能看到什么
设备清单里每台设备都带着厂商、名称、唯一码和下放门店。支持按厂商、类型、门店查看设备数量,也支持按唯一码反查这台设备被下放到了哪家门店。
和家长绑定的门店怎么区分
表中是厂家下放门店,说明设备发到了哪家店;家长实际与哪家门店互扫、在哪次绑定时关联哪家门店,是实际服务门店,由家长操作产生。后台分开展示这两类门店,便于核对设备流向与实际绑定是否一致。
设备准备流程
建立设备设置设备类型
设备厂商与设备名称
导入对应表上传厂家五列对应表
核对校验结果
生成二维码每个有效唯一码
生成对应设备码
下载与贴标按唯一码命名图片
支持批量打包下载
示例:护眼灯 / 某某光学 / 护眼灯 A 款 → 设备唯一码:ZY000128 → 下放门店:某某市明亮眼镜有限公司 → 二维码图片:ZY000128.png
设备清单怎么管
按设备类型、厂商、名称、唯一码、下放门店和绑定状态查询。点开一台设备,可以查看当前绑定家长及历史记录。设备清单全平台共用,唯一码不预先指定达人。
导入时检查什么
空编号、重复编号、已有编号逐项提示;保留前导零和原始大小写。厂商、类型缺失,以及营业执照名称匹配不到机构时同样逐行提示。先预览检查结果,再确认导入,异常行可修改后重传。
标签怎么用
设备贴纸上清楚标注两个入口:“登录智脑”与“绑定设备”。设备码用于家长在智脑内识别并绑定对应的设备唯一码。
03

账号与门店:来源固定,服务关系清晰

操作人:平台、达人、家长与门店入口:机构子席位管理 / 现有双向扫码入口

达人在系统中就是一个机构。家长购买智脑家长端后,由平台在该机构下开通对应的家长端账号,并把账号交给家长使用。家长和门店互扫后,门店获得相应档案的服务关系,达人仍能在原机构下找到这位家长。

账号来源与服务门店的关系
达人小林机构最初开通账号的机构
家长 001仍在小林机构的子席位列表中
家长 001同一个账号,继续使用
明亮眼镜店服务家长,查看获授权档案
初始状态
子席位开通在某个机构下,默认带着该机构的关联。后台将其标注为“初始机构默认”,清楚说明关系来源。
到店互扫后
展示实际关联的服务门店,相关视光档案按现有授权流程关联到该店。家长账号仍保留在最初的达人机构下。
后台如何区分
账号归属机构回答“是谁发出的账号”;当前关联门店回答“现在由哪家店服务”;设备绑定时关联门店记录当次设备绑定发生时的关系。

门店关联变化时保留历史。后台展示的是关联与扫码绑定事实,用于双方核对业务,不能仅凭当前服务门店倒推历史购买门店。

04

家长绑定:扫设备码,确认即可

操作人:家长建议入口:智脑家长端 → 我的设备 → 绑定设备

家长使用购买家长端后拿到的账号登录,在智脑内扫描设备码。确认后即生成绑定记录,后台同步可见。家长看到的是设备名称和设备唯一码。一个家长可以绑定多台设备,每台分别记录。

家长扫码与后台记录流程
扫码进入“绑定设备”
扫描设备专属二维码
确认信息查看设备名称、厂商
设备唯一码与当前关联门店
绑定成功设备加入“我的设备”
保存本次绑定时间
后台同步达人名下对应子席位
出现设备与唯一码记录
正常绑定
家长确认后完成绑定,无需门店再做一次购买确认。成功页展示设备名称、设备唯一码、绑定时间,并可进入设备详情。
增加另一台设备
扫描新的设备码,追加一条设备记录。原来已绑定的设备继续保留,各自有独立的状态和时间。
重复扫描同一台
如果已属于自己,提示“您已绑定这台设备”并打开原记录;如果已属于其他家长,提示联系原绑定人或平台处理。
扫码异常
无法识别、设备不存在或已停用时,给出明确原因与联系平台的入口;绑定失败不产生有效绑定记录。
一次绑定,记录清楚七件事:家长账号、账号归属机构、绑定时关联门店、设备厂商、设备名称、设备唯一码、绑定时间。
05

后台查询:从家长查设备,从唯一码查历史

达人入口:自己的机构 → 子席位管理平台入口:设备管理 / 子席位管理

达人继续使用熟悉的子席位列表,按家长查看设备;平台则可以用设备唯一码反查当前家长和历次绑定。两种查询方式指向同一份记录。

查询与导出流程
筛选记录家长、门店、厂商
设备、唯一码、状态与时间
查看明细家长名下全部设备
或单个唯一码的完整历史
导出核对按当前筛选导出
一行一条设备绑定记录

子席位列表:先看全貌

家长账号账号归属机构当前关联门店有效设备最近绑定唯一码最近绑定时间
家长 001达人小林机构明亮眼镜店
扫码关联
2 台ZY00012909-20 10:05
家长 002达人小林机构达人小林机构
初始机构默认
1 台ZY00013009-20 11:12

设备明细:逐台看清楚

设备名称厂商设备唯一码绑定时关联门店绑定时间当前状态解绑时间
护眼灯 A 款某某光学ZY000128明亮眼镜店09-19 15:30已绑定—
训练设备 B 款某某光学ZY000129明亮眼镜店09-20 10:05已绑定—
护眼灯 A 款某某光学ZY000100明亮眼镜店09-10 09:20已解绑09-18 16:20

以上为虚构示例,用于说明信息组织,不代表现有页面已完成开发。

导出包含什么
家长账号、账号归属机构、当前关联门店、绑定时关联门店、设备厂商、设备类型与名称、设备唯一码、设备下放门店、扫码时间、绑定时间、解绑时间、状态及解绑原因。
时间如何理解
门店关联、设备扫码、绑定确认、解绑各记各的时间。主列表突出设备绑定时间,详情和导出保留完整过程。
谁可以看
达人查看自己机构下的家长;平台查看与处理完整设备记录。门店按已获授权的服务关系查看相关信息,业务核对可使用授权导出的记录。
06

设备售后:家长自助,平台协助

退货、误绑或转让时,家长可以解除自己的设备绑定。遇到账号不可用等情况,家长或门店将设备唯一码和情况提供给平台,由平台核实后处理。

家长自助入口

我的设备 → 设备详情 → 解绑设备

家长核对设备与唯一码,选择原因,再次确认后解除本人绑定。

平台协助入口

设备管理 → 搜索设备唯一码 → 绑定记录 → 平台解绑

平台核对绑定对象及售后说明,填写处理原因后操作,并保留经办记录。

解绑处理流程 / 两个入口,同一份历史

家长自行处理

打开自己的设备详情,核对设备唯一码
选择原因,确认解绑
结束该设备与当前账号的绑定

平台协助处理

收到家长或门店反馈的设备唯一码与说明
核实绑定对象,填写处理原因
执行解绑,记录经办人员
原绑定记录保留:原家长、关联门店、绑定时间、解绑时间、原因和操作者。
解绑后家长看到什么
设备标为“已解绑”,历史仍可查询;其他设备和账号归属不受影响。提示家长:解除绑定是设备关系变更,退款进度需向售后方确认。
再次绑定怎么处理
建议:正常设备解绑后恢复可绑定,新家长重新扫码产生新记录;停用、维修等受限设备由平台确认恢复后再使用。
换新或转让怎么记录
换新时结束旧设备绑定、登记原因,再绑定新设备的唯一码;转让时原家长解绑、新家长重新扫码。旧记录和新记录分别保留,便于追溯。

设备是否正常可重绑、换新前后记录的关联方式,纳入实施前确认。门店通过平台协助处理售后,设备解绑由家长本人或平台执行。

07

视光档案:展示正在服务的门店

展示位置:家长端 → 视光档案内部内容来源:对应门店已有展示配置

家长和门店互扫关联后,在对应视光档案内展示门店 Logo、名称及现有展示信息。家长打开档案,就能清楚知道由哪家门店提供服务。

门店信息展示流程
互扫建立关联家长与门店
建立服务关系
确定档案门店读取这份视光档案
对应的服务门店
展示门店信息使用已有 Logo 与名称
展现在档案内容上方

复用现有门店展示样式

现有门店展示区参考:门店Logo、名称与介绍

现有功能截图,作为门店展示区域的样式参考。

视光档案内的信息顺序 / 结构示意
当前服务门店名称门店已有介绍与展示信息
孩子档案信息 → 检查记录 → 视光档案详情
名称与图片的显示
优先展示门店 Logo 和门店名称;名称未配置时显示机构名称。没有 Logo 时正常显示名称,避免空白占位或破图。
不同档案的门店
按具体档案对应的服务门店展示。家长名下多个孩子关联不同门店时,各档案分别取自己的门店。
08

完成后的业务效果

用同一个家长账号,从达人售出家长端、家长到店、扫码绑定到查询与解绑走一遍,就能验证整条业务流程是否完整。

  1. 平台导入厂家提供的设备对应表后,每台设备的唯一码都能对上下放门店,并下载与唯一码一一对应的设备二维码。
  2. 达人售出家长端后开通的家长账号,在关联其他门店后,仍可在原机构子席位列表中找到。
  3. 家长扫码确认后,设备出现在“我的设备”,达人后台同步显示名称、厂商、设备唯一码与绑定时间。
  4. 家长绑定第二台设备时,第一台继续保留;重复扫码不会重复增加设备。
  5. 平台和达人能按权限查询、展开明细、导出对应记录,信息能够相互核对。
  6. 家长自助解绑、平台协助解绑后,设备状态及时更新,完整历史仍可追溯。
  7. 已互绑门店的视光档案展示对应门店信息,名称和图片缺省时仍正常显示。

达人查得清来源,门店对得上记录,
家长管得好设备,平台追得回每一次变化。

附录

实施与核验说明

业务正文到此结束。下面集中保留待确认细节、技术设计方向与已有源码证据,供实施人员查阅。

A. 实施前需要确认的少量细节
  1. 先绑定设备、后关联门店:建议当前门店随关系更新,设备绑定时门店保留原快照;需要修正历史归因时由平台注明原因,禁止静默改写。
  2. 同一账号存在多个服务门店:建议绑定确认页仅在确有多个关联门店时让家长选择本次关联门店;单门店自动带出,来源机构保持不变。
  3. 正常解绑后的重绑:建议立即释放,受限设备需先恢复可用。解除绑定、退款状态和费用处理分别表达。
  4. 换新记录:建议保留新旧设备的关联标记,便于售后查询;退货、换新、二手转让的计佣口径继续待定。
  5. 二维码图片名称:使用设备唯一码加 .png。出现文件系统不允许的字符或仅大小写不同导致重名时,导入预检列明冲突并人工确认,不自行改编号。
  6. 门店匹配口径:厂家提供的是门店营业执照全称。需先补齐机构侧的营业执照名称字段或建立名称到机构的映射;同一门店出现多种写法时以营业执照全称为准,匹配不到时列待确认。
B. 数据、权限与实现方向

以下是拟议实现方向,不是已经完成开发的字段或接口。开发前需要对当时最新基线重新核验,并按项目要求立项。

  • 设备主数据:设备类型、设备厂商、设备名称、设备唯一码(全局唯一)、二维码凭证、状态、导入批次。独立于现有设备上报数据。
  • 下放归属:导入时保存厂家提供的门店营业执照名称,匹配到系统机构后形成设备下放归属。当前机构表无营业执照名称字段:app/models/organization.py 仅有 org_code:17(唯一可空、旧字段兼容)、name:20、store_nickname:26,无 license/营业执照相关字段(已 grep 确认)。需新增门店营业执照名称字段或建立名称到机构的映射后再导入;匹配不到时列待确认,不猜测归属。
  • 绑定历史:家长子席位与设备建立独立关系;一个家长可以拥有多条有效关系,一个设备同时只能有一个有效绑定。事务、唯一约束和重复请求幂等需要共同保证。
  • 机构关系:来源机构、当前服务门店和绑定时门店快照分开保存;门店互绑不能覆盖账号最初归属。跨机构查询必须明确授权范围。
  • 扫码与鉴权:设备二维码使用不可猜测的业务凭证;登录后由服务端推导家长身份与权限。扫描识别和绑定确认分开处理,二维码本身不是购买证明。
  • 时间与审计:设备扫码、确认绑定、门店互绑、解绑分别留痕;保存操作者、原因和关联记录。微信绑定时间与登录终端标识不可复用为实物设备信息。
  • 查询与导出:使用同一数据口径,区分有效设备与历史绑定。分批处理全量结果,校验租户权限与导出字段,防止跨机构泄漏。
  • 售后:家长只操作本人有效绑定;平台凭权限与核验结果处理;设备状态与绑定状态分别管理。历史记录不可直接覆盖删除。
  • 门店展示:按具体档案的服务门店解析现有 Logo、门店名与机构名,补齐缺省逻辑,沿用现有展示组件。
C. 12 维源码证据索引与核验边界

沿用前轮在云机实际检索的固定提交 2040a3196672800beca23a6abcee515e55717bad,不是本轮实时最新代码。本次仅重排文档,没有重新执行业务代码核验,也没有执行真实数据库或业务验收。静态源码证据不能替代运行结果。

维度既有证据路径 / 行号核验用途
1. 家长席位app/models/user.py:58–62,121–154机构关联与家长子席位字段;永久来源保护仍需实现核查。
2. 机构实体与匹配字段app/models/organization.py:11,17,20,26机构、org_code:17(唯一可空)、name:20、store_nickname:26;无营业执照名称字段,需补充后才能按厂家提供的营业执照名称匹配下放门店。
3. 服务门店app/models/flywheel.py:52–54,71–83家长、来源机构与档案服务门店的区别。
4. 互绑流程app/api/refractive_records.py:167–194
app/services/brand_code_claim_service.py:3–12
同机构档案绑定与跨机构服务认领;完整双向入口仍需回归。
5. 设备模型app/models/device.py:16–33,41–67现有设备数据和类型与新增设备资产(类型、厂商、名称、唯一码)的边界。
6. 设备管理app/api/admin_devices.py:17,49–110现有类型接口及管理员鉴权。
7. 设备查询app/services/device_service.py:76,88–101现有手机号设备查询与新增绑定链路的区别。
8. 二维码app/api/qr.py:23–35通用二维码图片生成;设备身份仍需业务校验。
9. 现有扫码链路app/api/brand_code_public.py:22,41–44
web/app/h5/brand-scan/page.tsx:10,69
原扫码入口与新增设备入口的兼容回归。
10. 门店展示app/api/parent_account.py
app/api/h5_store_card.py
app/models/organization.py
前轮已补查门店展示取值;本项为文件级索引,不虚构行号。
11. 子席位后台app/api/admin_seats.py
web/app/(dashboard)/admin/orgs/[id]/seats/page.tsx
列表、权限、导出的复用入口;需最新基线复核。
12. 迁移与测试migrations/versions/
tests/
前轮已定向检索,运行验证未完成;索引不代表测试通过。
D. 实施顺序与真实验收要求
  1. 设备基础:设备类型与厂商、设备清单、唯一码与门店对应表导入校验、下放门店匹配、一码一设备、标签下载及资产查询。
  2. 主链路:家长登录扫码、多设备绑定、账号来源保护、服务门店展示与后台同步。
  3. 完整闭环:查询导出、家长及平台解绑、历史查询、档案门店展示和异常场景。
  4. 真实验证:真实 PG、真实服务与真实浏览器验证并贴证据。重点覆盖重复唯一码、营业执照名称匹配不到门店、并发抢绑、跨机构越权、重复扫码、先设备后门店、多档案不同门店、导出完整性及两类解绑。
  5. 受控交付:独立工作区和功能分支;提交后经功能分支 MR、CI、独立合规评审与自动合并进入 test,等待部署并完成真实验收后报告结果。自动交付尚未补齐的环节须如实标明,不以 MR 创建代替发布完成。

当前交付物仅为方案文档。本轮未修改业务代码,未执行业务发布。