达人带货与设备绑定
从达人把智脑家长端卖给家长,到家长进店购买设备、扫码绑定,
把达人、家长、门店与每一台设备的关系记录清楚。
整体业务场景
平台为达人小林创建一个机构,并在机构下开通一批家长端账号。小林向家长售卖智脑家长端,把对应的家长端账号交给家长使用,同时推荐家长到使用赵阳智脑的门店购买设备。家长到明亮眼镜店后,与门店互相扫码关联;购买设备后,登录智脑家长端,扫描设备上的专属二维码完成绑定。
绑定完成后,小林在自己机构的子席位管理中,就能看到这位家长关联了哪家门店、绑定了什么设备、设备唯一码是多少、什么时候绑定。平台可查询完整记录,达人和门店据此核对后续费用。
建立达人机构并开通家长端账号;导入设备与下放门店,生成设备码。
向家长销售智脑家长端,交付账号,推荐到门店选购设备。
门店与家长互扫,建立服务关系,关联视光档案。
在智脑内扫设备码,核对名称与设备唯一码,确认绑定。
串联账号来源、关联门店、设备唯一码和绑定时间。
达人查看、平台导出;需要时由家长或平台解绑。
图示为典型业务顺序。设备准备与账号开通可以同时进行;若家长先绑定设备、后关联门店,分别保留两次操作的时间和记录。
准备设备码、管理设备、查询记录、处理售后。
售卖智脑家长端并交付账号,查看名下家长的设备记录。
登录智脑、关联门店、绑定设备、管理自己的设备。
接待家长、销售设备、提供档案服务、核对业务记录。
用大白话再讲一遍:这件事是怎么跑起来的
不看系统、不看字段,只按日常做生意的顺序,把每一步谁来做、需要什么、做完得到什么讲清楚。
导入厂家设备表(唯一码、厂商、类型、名称、下放门店),生成每台设备专属二维码,印成设备贴纸。
为达人建一个机构,在机构下开通一批家长端账号。
向家长销售家长端,交付账号;推荐到使用赵阳智脑的门店检查服务、购买设备,领取达人专属活动基金抵扣购买费用。
家长与门店互扫关联。
门店获得服务资格,孩子的视光档案对门店可见。
门店现场或到家后,登录智脑家长端扫设备码,设备即与智脑绑定;再买其他设备可继续绑定,一台一条记录。若暂未扫码,达人可在端内督催家长尽快扫码,获得主任服务。
子席位列表点开家长:关联了哪家门店、什么设备、唯一码、绑定时间一目了然。
平台按门店、设备、设备唯一码和时间导出;达人和门店拿同一份清单核对业务。
门店把设备唯一码报给平台,平台核实后解绑。
在“我的设备”里自己解绑。
泳道流程图:四条泳道对应平台、达人、家长、门店,从上到下按时间顺序,箭头表示事情从谁手里交到谁手里。四色底对应各角色,整图可直接截取放进 PPT。
达人卖的是家长端,账号一直挂在达人机构下;
设备靠唯一码认人,谁扫就记到谁名下;
门店关系单独记,换店不换达人归属。
设备管理:让每台设备都有专属二维码
厂家提供这批设备的唯一码,以及每台设备下放到的门店,平台导入到智脑。每个唯一码对应一台实物设备和一个专属二维码,供后续打印、贴标与家长扫码。
设备要管理哪些信息
| 信息项 | 说明 | 示例 |
|---|---|---|
| 设备类型 | 设备的品类,用于分类和统计 | 护眼灯 |
| 设备厂商 | 设备的生产厂家 | 某某光学 |
| 设备名称 | 具体型号名称,家长扫码时看到的就是它 | 护眼灯 A 款 |
| 设备唯一码 | 每台设备一个,全局唯一;也是二维码图片名 | ZY000128 |
| 对应门店营业执照名称 | 这台设备下放到的门店。直接填机构管理中的机构名称——系统中登记的机构名称就是营业执照上的名称,无需另设字段 | 某某市明亮眼镜有限公司 |
虚构示例。门店一列按机构管理中的机构名称原样填写(机构名称即营业执照名称),与系统写法保持一致,避免简称或多种写法导致设备下放门店匹配不上。
厂家导入表:唯一码与门店对应
厂家按上面五项提供导入表,平台导入智脑。门店一列填写机构管理中的机构名称,系统据此把设备归到对应机构;每台设备下放给哪家门店,以这份表为准。
| 设备类型 | 设备厂商 | 设备名称 | 设备唯一码 | 对应门店营业执照名称 |
|---|---|---|---|---|
| 护眼灯 | 某某光学 | 护眼灯 A 款 | ZY000128 | 某某市明亮眼镜有限公司 |
| 护眼灯 | 某某光学 | 护眼灯 A 款 | ZY000129 | 某某市明亮眼镜有限公司 |
| 训练设备 | 某某光学 | 训练设备 B 款 | ZY000130 | 某某市康视力眼镜有限公司 |
虚构示例,用于说明五列内容的对应关系,不代表真实厂商、设备或门店;门店一列与机构管理中的机构名称保持一致。
- 导入时怎么校验
- 唯一码为空、重复、已存在,设备类型或厂商缺失,门店名称为空,逐行提示原因。门店名称与机构管理中的机构名称对不上时,单独列出待确认,由平台人工确认,不猜测归属。先预览检查结果,确认无误再导入,异常行修改后可重新上传。
- 导入后能看到什么
- 设备清单里每台设备都带着厂商、名称、唯一码和下放门店。支持按厂商、类型、门店查看设备数量,也支持按唯一码反查这台设备被下放到了哪家门店。
- 和家长绑定的门店怎么区分
- 表中是厂家下放门店,说明设备发到了哪家店;家长实际与哪家门店互扫、在哪次绑定时关联哪家门店,是实际服务门店,由家长操作产生。后台分开展示这两类门店,便于核对设备流向与实际绑定是否一致。
设备厂商与设备名称
核对校验结果
生成对应设备码
支持批量打包下载
- 设备清单怎么管
- 按设备类型、厂商、名称、唯一码、下放门店和绑定状态查询。点开一台设备,可以查看当前绑定家长及历史记录。设备清单全平台共用,唯一码不预先指定达人。
- 导入时检查什么
- 空编号、重复编号、已有编号逐项提示;保留前导零和原始大小写。厂商、类型缺失,以及门店名称与机构管理中的机构名称不一致时同样逐行提示。先预览检查结果,再确认导入,异常行可修改后重传。
- 标签怎么用
- 设备贴纸上清楚标注两个入口:“登录智脑”与“绑定设备”。设备码用于家长在智脑内识别并绑定对应的设备唯一码。
账号与门店:来源固定,服务关系清晰
达人在系统中就是一个机构。家长购买智脑家长端后,由平台在该机构下开通对应的家长端账号,并把账号交给家长使用。家长和门店互扫后,门店获得相应档案的服务关系,达人仍能在原机构下找到这位家长。
账号归属始终保留
建立服务与档案关系
- 初始状态
- 子席位开通在某个机构下,默认带着该机构的关联。后台将其标注为“初始机构默认”,清楚说明关系来源。
- 到店互扫后
- 展示实际关联的服务门店,相关视光档案按现有授权流程关联到该店。家长账号仍保留在最初的达人机构下。
- 后台如何区分
- 账号归属机构回答“是谁发出的账号”;当前关联门店回答“现在由哪家店服务”;设备绑定时关联门店记录当次设备绑定发生时的关系。
门店关联变化时保留历史。后台展示的是关联与扫码绑定事实,用于双方核对业务,不能仅凭当前服务门店倒推历史购买门店。
家长绑定:扫设备码,确认即可
家长使用购买家长端后拿到的账号登录,在智脑内扫描设备码。确认后即生成绑定记录,后台同步可见。家长看到的是设备名称和设备唯一码。一个家长可以绑定多台设备,每台分别记录。
扫描设备专属二维码
设备唯一码与当前关联门店
保存本次绑定时间
出现设备与唯一码记录
- 正常绑定
- 家长确认后完成绑定,无需门店再做一次购买确认。成功页展示设备名称、设备唯一码、绑定时间,并可进入设备详情。
- 增加另一台设备
- 扫描新的设备码,追加一条设备记录。原来已绑定的设备继续保留,各自有独立的状态和时间。
- 重复扫描同一台
- 如果已属于自己,提示“您已绑定这台设备”并打开原记录;如果已属于其他家长,提示联系原绑定人或平台处理。
- 扫码异常
- 无法识别、设备不存在或已停用时,给出明确原因与联系平台的入口;绑定失败不产生有效绑定记录。
后台查询:从家长查设备,从唯一码查历史
达人继续使用熟悉的子席位列表,按家长查看设备;平台则可以用设备唯一码反查当前家长和历次绑定。两种查询方式指向同一份记录。
设备、唯一码、状态与时间
或单个唯一码的完整历史
一行一条设备绑定记录
子席位列表:先看全貌
| 家长账号 | 账号归属机构 | 当前关联门店 | 有效设备 | 最近绑定唯一码 | 最近绑定时间 |
|---|---|---|---|---|---|
| 家长 001 | 达人小林机构 | 明亮眼镜店 扫码关联 | 2 台 | ZY000129 | 09-20 10:05 |
| 家长 002 | 达人小林机构 | 达人小林机构 初始机构默认 | 1 台 | ZY000130 | 09-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 |
以上为虚构示例,用于说明信息组织,不代表现有页面已完成开发。
- 导出包含什么
- 家长账号、账号归属机构、当前关联门店、绑定时关联门店、设备厂商、设备类型与名称、设备唯一码、设备下放门店、扫码时间、绑定时间、解绑时间、状态及解绑原因。
- 时间如何理解
- 门店关联、设备扫码、绑定确认、解绑各记各的时间。主列表突出设备绑定时间,详情和导出保留完整过程。
- 谁可以看
- 达人查看自己机构下的家长;平台查看与处理完整设备记录。门店按已获授权的服务关系查看相关信息,业务核对可使用授权导出的记录。
设备售后:家长自助,平台协助
退货、误绑或转让时,家长可以解除自己的设备绑定。遇到账号不可用等情况,家长或门店将设备唯一码和情况提供给平台,由平台核实后处理。
家长自助入口
我的设备 → 设备详情 → 解绑设备
家长核对设备与唯一码,选择原因,再次确认后解除本人绑定。
平台协助入口
设备管理 → 搜索设备唯一码 → 绑定记录 → 平台解绑
平台核对绑定对象及售后说明,填写处理原因后操作,并保留经办记录。
家长自行处理
平台协助处理
- 解绑后家长看到什么
- 设备标为“已解绑”,历史仍可查询;其他设备和账号归属不受影响。提示家长:解除绑定是设备关系变更,退款进度需向售后方确认。
- 再次绑定怎么处理
- 建议:正常设备解绑后恢复可绑定,新家长重新扫码产生新记录;停用、维修等受限设备由平台确认恢复后再使用。
- 换新或转让怎么记录
- 换新时结束旧设备绑定、登记原因,再绑定新设备的唯一码;转让时原家长解绑、新家长重新扫码。旧记录和新记录分别保留,便于追溯。
设备是否正常可重绑、换新前后记录的关联方式,纳入实施前确认。门店通过平台协助处理售后,设备解绑由家长本人或平台执行。
视光档案:展示正在服务的门店
家长和门店互扫关联后,在对应视光档案内展示门店 Logo、名称及现有展示信息。家长打开档案,就能清楚知道由哪家门店提供服务。
建立服务关系
对应的服务门店
展现在档案内容上方
复用现有门店展示样式

现有功能截图,作为门店展示区域的样式参考。
- 名称与图片的显示
- 优先展示门店 Logo 和门店名称;名称未配置时显示机构名称。没有 Logo 时正常显示名称,避免空白占位或破图。
- 不同档案的门店
- 按具体档案对应的服务门店展示。家长名下多个孩子关联不同门店时,各档案分别取自己的门店。
完成后的业务效果
用同一个家长账号,从达人售出家长端、家长到店、扫码绑定到查询与解绑走一遍,就能验证整条业务流程是否完整。
- 平台导入厂家提供的设备对应表后,每台设备的唯一码都能对上下放门店,并下载与唯一码一一对应的设备二维码。
- 达人售出家长端后开通的家长账号,在关联其他门店后,仍可在原机构子席位列表中找到。
- 家长扫码确认后,设备出现在“我的设备”,达人后台同步显示名称、厂商、设备唯一码与绑定时间。
- 家长绑定第二台设备时,第一台继续保留;重复扫码不会重复增加设备。
- 平台和达人能按权限查询、展开明细、导出对应记录,信息能够相互核对。
- 家长自助解绑、平台协助解绑后,设备状态及时更新,完整历史仍可追溯。
- 已互绑门店的视光档案展示对应门店信息,名称和图片缺省时仍正常显示。
达人查得清来源,门店对得上记录,
家长管得好设备,平台追得回每一次变化。
实施与核验说明
业务正文到此结束。下面集中保留待确认细节、技术设计方向与已有源码证据,供实施人员查阅。
A. 实施前需要确认的少量细节
- 先绑定设备、后关联门店:建议当前门店随关系更新,设备绑定时门店保留原快照;需要修正历史归因时由平台注明原因,禁止静默改写。
- 同一账号存在多个服务门店:建议绑定确认页仅在确有多个关联门店时让家长选择本次关联门店;单门店自动带出,来源机构保持不变。
- 正常解绑后的重绑:建议立即释放,受限设备需先恢复可用。解除绑定、退款状态和费用处理分别表达。
- 换新记录:建议保留新旧设备的关联标记,便于售后查询;退货、换新、二手转让的计佣口径继续待定。
- 二维码图片名称:使用设备唯一码加 .png。出现文件系统不允许的字符或仅大小写不同导致重名时,导入预检列明冲突并人工确认,不自行改编号。
- 门店匹配口径:机构管理中的“机构名称”就是营业执照名称,因此厂家提供的门店一列直接按系统里已有的机构名称匹配,不需要新增字段,也不需要另建名称映射。导入时按机构名称精确匹配(忽略首尾空格与全半角差异);出现同一门店多种写法或对不上时列待确认,由平台人工确认归属,不自动猜测。
B. 数据、权限与实现方向
以下是拟议实现方向,不是已经完成开发的字段或接口。开发前需要对当时最新基线重新核验,并按项目要求立项。
- 设备主数据:设备类型、设备厂商、设备名称、设备唯一码(全局唯一)、二维码凭证、状态、导入批次。独立于现有设备上报数据。
- 下放归属:导入时保存厂家提供的门店名称,按机构名称(
organization.name)匹配系统机构后形成设备下放归属。无需新增字段:机构管理中的“机构名称”即为营业执照名称,app/models/organization.py:20的name就是匹配键;org_code:17(唯一可空、旧字段兼容)与store_nickname:26仅作辅助展示,不参与匹配。匹配时忽略首尾空格与全半角差异,匹配不到时列待确认,不猜测归属。 - 绑定历史:家长子席位与设备建立独立关系;一个家长可以拥有多条有效关系,一个设备同时只能有一个有效绑定。事务、唯一约束和重复请求幂等需要共同保证。
- 机构关系:来源机构、当前服务门店和绑定时门店快照分开保存;门店互绑不能覆盖账号最初归属。跨机构查询必须明确授权范围。
- 扫码与鉴权:设备二维码使用不可猜测的业务凭证;登录后由服务端推导家长身份与权限。扫描识别和绑定确认分开处理,二维码本身不是购买证明。
- 时间与审计:设备扫码、确认绑定、门店互绑、解绑分别留痕;保存操作者、原因和关联记录。微信绑定时间与登录终端标识不可复用为实物设备信息。
- 查询与导出:使用同一数据口径,区分有效设备与历史绑定。分批处理全量结果,校验租户权限与导出字段,防止跨机构泄漏。
- 售后:家长只操作本人有效绑定;平台凭权限与核验结果处理;设备状态与绑定状态分别管理。历史记录不可直接覆盖删除。
- 门店展示:按具体档案的服务门店解析现有 Logo、门店名与机构名,补齐缺省逻辑,沿用现有展示组件。
C. 12 维源码证据索引与核验边界
沿用前轮在云机实际检索的固定提交 2040a3196672800beca23a6abcee515e55717bad,不是本轮实时最新代码。本次仅重排文档,没有重新执行业务代码核验,也没有执行真实数据库或业务验收。静态源码证据不能替代运行结果。
| 维度 | 既有证据路径 / 行号 | 核验用途 |
|---|---|---|
| 1. 家长席位 | app/models/user.py:58–62,121–154 | 机构关联与家长子席位字段;永久来源保护仍需实现核查。 |
| 2. 机构实体与匹配字段 | app/models/organization.py:11,17,20,26web/app/(dashboard)/admin/orgs/page.tsx:381-383,1183 | 机构、org_code:17(唯一可空、旧字段兼容)、name:20、store_nickname:26。机构管理页面“机构名称”为必填项(page.tsx:381 名称输入框、:1183 列表列),取值即营业执照名称,故设备下放门店直接按 name 匹配,无需新增字段。 |
| 3. 服务门店 | app/models/flywheel.py:52–54,71–83 | 家长、来源机构与档案服务门店的区别。 |
| 4. 互绑流程 | app/api/refractive_records.py:167–194app/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–44web/app/h5/brand-scan/page.tsx:10,69 | 原扫码入口与新增设备入口的兼容回归。 |
| 10. 门店展示 | app/api/parent_account.pyapp/api/h5_store_card.pyapp/models/organization.py | 前轮已补查门店展示取值;本项为文件级索引,不虚构行号。 |
| 11. 子席位后台 | app/api/admin_seats.pyweb/app/(dashboard)/admin/orgs/[id]/seats/page.tsx | 列表、权限、导出的复用入口;需最新基线复核。 |
| 12. 迁移与测试 | migrations/versions/tests/ | 前轮已定向检索,运行验证未完成;索引不代表测试通过。 |
D. 实施顺序与真实验收要求
- 设备基础:设备类型与厂商、设备清单、唯一码与门店对应表导入校验、下放门店匹配、一码一设备、标签下载及资产查询。
- 主链路:家长登录扫码、多设备绑定、账号来源保护、服务门店展示与后台同步。
- 完整闭环:查询导出、家长及平台解绑、历史查询、档案门店展示和异常场景。
- 真实验证:真实 PG、真实服务与真实浏览器验证并贴证据。重点覆盖重复唯一码、门店名称与机构名称写法不一致而匹配不到、并发抢绑、跨机构越权、重复扫码、先设备后门店、多档案不同门店、导出完整性及两类解绑。
- 受控交付:独立工作区和功能分支;提交后经功能分支 MR、CI、独立合规评审与自动合并进入 test,等待部署并完成真实验收后报告结果。自动交付尚未补齐的环节须如实标明,不以 MR 创建代替发布完成。
当前交付物仅为方案文档。本轮未修改业务代码,未执行业务发布。