给达人建一个机构
平台创建“达人小林机构”,在它下面开家长子席位,再由达人发给家长。
沿用现有机构和子席位,新增设备扫码绑定。
让每个账号、每台设备、每次门店关联,都有记录可查。
不增加一套“达人管理”。继续用现有机构与子席位功能。
平台创建“达人小林机构”,在它下面开家长子席位,再由达人发给家长。
家长到“明亮眼镜店”,双方互扫关联,相关视光档案出现在该店授权范围内。
扫设备贴纸上的设备码,绑定 SN:ZY000128。一个家长还能继续绑定其他设备。
仍在“达人小林机构”的子席位里,看到这个家长、关联门店、设备和 SN。
有机构才能开子席位。没有后续互绑时,保留系统原有默认关联,不另造“无归属账号”。
后台分别写“账号归属机构”和“当前关联门店”。默认关联标“初始机构默认”,互绑后标“扫码关联”。
达人机构只是借用机构功能,不意味着该达人机构就是一家实体销售门店。默认关联不当作已核实的购机凭证;首版记录绑定事实,供双方对账。
设备库跨机构共用,设备不提前指定给某个达人。
继续用来进入智脑,沿用原有登录逻辑。原品牌码、已有子席位功能不受影响。
仅用于在智脑家长端绑定这台设备。标签同时印两个码,并明确写“登录智脑”“绑定设备”,避免扫错。
本次不需要理解或对接厂家数据上报编号。第一版只按厂家提供的 SN 建设备清单、生成设备码、记录家长绑定。
不需要门店再次确认购买。家长能绑多台,新设备不会覆盖旧设备。
提示“您已绑定”,展示原记录,不重复增加一台设备。
继续扫新设备的码,追加到“我的设备”,每台都有自己的绑定时间。
提示先由原家长解绑,或联系平台协助。不显示对方隐私,不允许直接抢绑。
建议设备详情同时保留“绑定时关联门店”和“当前关联门店”。先扫设备、后互绑时,后台能看到后续关联变化,历史时间不被抹掉;这不自动证明设备就在新门店购买。
账号不挪地方。就在初始达人机构的子席位管理里看设备和门店。
图中展示的是常见业务顺序;先绑定设备后互绑门店也要保留两个动作各自的时间与记录。
| 家长账号 | 账号归属机构 | 当前关联门店 | 有效设备 | 最近 SN | 最近绑定时间 |
|---|---|---|---|---|---|
| 家长 001 | 达人小林机构 | 明亮眼镜店 扫码关联 | 2 台 | ZY000129 | 09-20 10:05 |
| 家长 002 | 达人小林机构 | 达人小林机构 初始机构默认 | 1 台 | ZY000130 | 09-20 11:12 |
虚构数据,用于沟通字段,不代表已实现页面或实际用户。
| 设备 | SN | 绑定时关联门店 | 绑定时间 | 状态 |
|---|---|---|---|---|
| 护眼灯 A 款 | ZY000128 | 明亮眼镜店 | 09-19 15:30 | 已绑定 |
| 训练设备 B 款 | ZY000129 | 明亮眼镜店 | 09-20 10:05 | 已绑定 |
| 护眼灯 A 款 | ZY000100 | 明亮眼镜店 | 09-10 09:20 | 已解绑 · 可看历史 |
支持按家长账号、门店、设备名称、SN、状态和时间查找;列表显示摘要,详情看全部设备,不把多个 SN 挤成一团。
一行一条设备绑定记录,带账号归属、关联门店、SN、绑定/解绑时间与状态。不导出密码,不做自动计佣。
家长自己处理最方便;遇到账号不可用、误绑等问题,由平台兜底。
先显示设备名称、SN,再二次确认。仅能解绑自己当前绑定的设备,不能替别人解绑。
门店反馈 SN 给平台。平台先核对当前绑定对象与处理原因,再执行解绑并留下经办记录。
“解绑后,该设备将不再关联此账号;历史记录会保留。解绑不代表退款已完成,也不会改变您的账号归属。”
“您正在解除 SN ××× 与家长账号 ××× 的绑定。请核对售后信息并填写原因。”不能只凭一个 SN 就不核验直接操作。
正常解绑后是否立即允许重绑为本稿建议;若设备在维修、报废或风控停用状态,应先由平台恢复可用。退货、换新、转让可以记录原因,但不在本轮定佣金处理规则。
不是重新设计品牌页,而是把现有门店头图能力用到已互绑的视光档案里。

复用这类现有门店展示区。截图只用于说明功能位置与样式方向,不新造一套门店装修配置,也不要求改品牌头图。
复用该门店现有展示配置
门店与家长关联后展示。未配置门店名时显示机构名称;没 Logo 不显示破图。
结构说明图,不是上线效果稿。橙色虚线表示本次新增展示区域。
尚未互绑实际门店时,不新增一个冒充实体门店的展示区;继续原来的显示。若一个账号下多个孩子关联不同门店,按具体档案展示,不能全家一律取“最近绑定门店”。
先把“能绑定、能查清、能解绑、能导出”做完整。
导入能校验,设备能查到,二维码能逐个下载和打包。
家长能扫,达人能查,门店信息准确,SN 和时间可导出。
自助与平台解绑都留历史;门店头图按档案显示;旧功能回归。
正式开发前按项目流程立项并分配 Phase。本稿不自行定 Phase 号,也不代表已经启动开发。
大方向已清楚,不再反复讨论“达人是什么”或“要不要自动打款”。
建议当前门店随互绑更新,设备绑定时的关联保持原样,并显示后续变化。需要人工修正历史门店时由平台留痕处理,不默默倒推销售门店。
建议正常设备解绑后即可重绑;停用/维修设备仍受限制。同 SN 的新旧记录各自保存,是否再次计佣不在本版自动处理。
正常单门店不增加操作;确有多个门店时,建议设备绑定确认页让家长从已关联门店中选本次门店,档案头图则按各档案自己的门店展示。
继续待定。本版只记录解绑/重新绑定及原因,不计算应收、不作退款完成标记、不自动新增或扣减佣金。
先把人、店、设备和时间记清楚。
让双方有据可查,再谈钱如何计算。
业务沟通读到上面即可。源码、边界和验证依据放在这里,不打断主线。
沿用上轮实际检索的固定代码提交 2040a3196672800beca23a6abcee515e55717bad,本轮补查机构与门店展示取值。本轮未 fetch,不声称实时最新;只读,不改业务代码。下面是静态证据,不等于真实数据库、浏览器业务流程或上线验收已经通过。
| 维度 | 证据路径 / 行号 | 对方案的影响 |
|---|---|---|
| 1. 家长席位 | app/models/user.py:58–62,121–154 | 机构关联与 parent 子席位已有字段;业务含义由本轮定案说明,不能宣称永久归属保护已实现。 |
| 2. 机构实体 | app/models/organization.py:11,20,26 | 复用机构、机构名称和门店昵称;达人就是该实体的一种业务用法。 |
| 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 | 现有设备数据/类型不直接等于本次 SN 资产绑定。保留旧数据链路。 |
| 6. 设备管理接口 | app/api/admin_devices.py:17,49–110 | 现有类型接口有管理员守门;资产与 SN 清单需新增或确认可复用实现。 |
| 7. 设备查询 | app/services/device_service.py:76,88–101 | 手机号设备数据查询不是本次新绑定依据;首版不做厂家数据对接。 |
| 8. 二维码 | app/api/qr.py:23–35 | 可生成 QR PNG;身份校验、设备唯一关联须由业务服务处理。 |
| 9. 品牌码 | app/api/brand_code_public.py:22,41–44web/app/h5/brand-scan/page.tsx:10,69 | 激活链路存在,新增设备码不能覆盖或误触原流程。 |
| 10. 列表与时间 | app/api/admin_brand_code.py:180–234app/models/user.py:80–107 | 当前门店汇总不是每台设备的历史归属;现有登录设备、微信时间不得借作实体设备字段。 |
| 11. 门店展示 | app/api/h5_store_card.py:188–224,242,326 | Logo 与品牌头图用不同字段;名称可用昵称回退机构名称。本轮补 grep 有命中,未确认全部前端组件调用链。 |
| 12. 迁移与测试 | migrations/versions/phase48a_001_brand_code.pytests/integration/test_brand_code_claim.pytests/integration/test_refractive_visibility_service_org.py | 现有迁移/测试文件可作回归入口;不代表已执行或已检查实际数据库状态。 |
技术实现须保证:SN 唯一、一台设备同一时刻一个有效绑定、重复请求不重复写入、家长只能解绑本人设备、平台操作留痕、达人与门店范围隔离、档案可见性不扩散。随机设备码能防枚举但不能防止贴纸被拍照复制,扫码不自动构成付款凭证。
上线前仍须:正式立项,最新 test 独立功能分支/worktree,真实 PG + 真实服务 + 真机扫码验证,实施前后贴源码/库/接口/页面证据,按正式发版流程执行。不触碰主仓预存脏文件。
已确认:达人借用机构;账号最终归初始机构;设备跨机构、SN 由厂家提供、一码一 SN、文件名对应 SN;一账号多设备;扫码不用门店二次确认;家长自助和平台协助解绑;首版范围;品牌头图不变,档案增加现有门店展示。
建议:按钮具体位置、确认文案、解除关系后的重绑节奏、多门店时选择方式、绑定时门店和当前门店的两列展示、异常设备的停用处理。佣金规则继续待定。本文是沟通方案,不是软件功能已完成的宣告。