ai门店 · 三端系统使用手册
三个文件分别是什么、怎么上传、教练和总后台各自怎么用、出问题怎么办
1 · 三个文件，一句话看懂
整个系统就三个网页文件，各管一段：客户做自测 → 教练跟进 → 总后台管人管线索。三个都在同一台主机上，文件名不能改（改了链接就失效）。
| 文件 | 线上地址 | 谁在用 | 干什么 |
|---|---|---|---|
tool.html |
aiora-shop.com/tool.html |
客户 | 做三步经营自测（病因 → 现状 → 处方），拿到诊断报告；末尾填门店信息提交留资 |
coach-workbench.html |
aiora-shop.com/coach-workbench.html |
教练 | 登录后复制自己的专属链接、查看名下客户线索、写备注、导出诊断长图 |
coach-admin.html |
aiora-shop.com/coach-admin.html |
总后台 | 开通教练账号、改教练号、停用教练、查看全部线索并指派归属 |
?ref=教练号 的链接 → 发给客户 → 客户在 tool.html 做完提交 → 线索自动挂到这位教练名下 → 教练在工作站看到线索 → 总后台可查看与调整归属。
2 · 怎么上传（每次改动都要做）
改完文件后，用 FTP / WinSCP 传到主机 wwwroot 根目录，同名覆盖。传完在浏览器按 Ctrl+F5 强制刷新。
要传到主机的（5 个）
| 文件 | 说明 |
|---|---|
tool.html | 工具包页面 |
coach-workbench.html | 教练工作站 |
coach-admin.html | 总后台 |
favicon.ico | 浏览器标签页小图标 |
favicon-192.png | 高分屏图标 |
- 文件名必须是英文，中文名 FTP 会乱码。
- 别改文件名，线上链接是按文件名走的。
- 这主机对不存在的文件也返回 200（空内容）—— 判断"传上去没有"要看文件大小，别只看状态码。
不用传主机的
3 · 教练怎么用
三个页面分别有什么
| 标签 | 能做什么 |
|---|---|
| 我的线索 | 客户提交的自检报告与门店信息；可写我的备注（只有自己看得到）、可删除自己的线索 |
| 我的工具 | 复制自己的专属链接（含教练号）；下方会显示这个工具归属于谁 |
| 我的设置 | 改显示名称、改工作区域（会显示在归属行上）、改密码、填企业微信号 |
4 · 总后台怎么用
用 master 账号登录 coach-admin.html，三个标签页各管一件事。
认证室 · 开通新教练
| 填什么 | 说明 |
|---|---|
| 教练邮箱 | 他的登录账号。必须是真邮箱（要用它登录） |
| 初始密码 | 至少 6 位，你定，开通后发给他，他可自行修改 |
| 显示名称 | 如「组长小林」 |
| 工作区域 | 选填。如「深圳龙岗」，会显示在归属行 |
| 教练号 | 选填。留空自动生成 8 位；填了就用你填的（4–16 位字母数字） |
开通成功后，下方出现一张结果卡片：邮箱、教练号、初始密码、教练专属链接，三个按钮——复制账号密码、复制教练链接、再开一个。卡片会存在本机，刷新不丢。
教练库 · 管人
- 每张卡显示：显示名、教练号、开通时间、名下线索数、获客链接
- 改号：链接旁的「改号」按钮可换教练号（4–16 位字母数字）。⚠️ 改号后旧链接立即失效，但已有线索归属不受影响
- 停用 / 恢复：停用后该教练无法登录工作站
- 总后台标注：仅内部可见，教练本人看不到
线索库 · 管线索
- 看全部线索：客户原文、门店信息、归属教练、提交时间
- 指派归属：无归属的线索可手动指给某位教练（同一手机号的会一并归属）
- 改派已有归属的教练会有护栏提示（需教练团队投票决定）
- 可写内部标注、可删除
5 · 归属规则（最关键的一条）
客户从带 ?ref=34149D49 这样的链接提交，线索才会自动记到这位教练名下。
如果客户用了不带 ref 的链接（比如你直接把 tool.html 甩给他），这条线索会变成「未归属」——教练看不到，只能你在总后台手动指派。
教练专属链接的格式是：
https://aiora-shop.com/aiora-out/toolkit.html?ref=34149D49每个教练的 ref 就是他的教练号，在总后台「教练库」或他的工作站「我的工具」页都能看到。
6 · 常见问题
链接在微信里打开，标题下面显示的是网址，不是我的介绍
原因：微信对已分享过的链接会缓存抓取结果（标题、描述、缩略图一起缓存），改网页也不会让它重新抓。
解法：分享时在链接后面加个没意义的参数，比如 ?ref=34149D49&t=2，微信会当成新页面重新抓，标题、描述、缩略图立刻齐全。
换图也一样：不要删掉参数，把 t=2 改成 t=3 即可。
页面上没有缩略图 / 图标
检查两点：①favicon.ico 与 favicon-192.png 有没有传到 wwwroot 根目录；②传完按 Ctrl+F5 强刷（浏览器会缓存图标）。
微信转发卡片里的缩略图是另一套地址（OBS 上的图），和浏览器图标不是同一个文件。
教练登录后说"还没有开通教练权限"
说明 coaches 表里没有他那行。在总后台「教练库」里查一下有没有他的卡片；没有的话重新开一次号。
总后台点「开通账号」报错
提示需要部署 Edge Function → 去 Supabase Dashboard → Edge Functions → create-coach → 粘贴代码 → Deploy updates（约 1 分钟，一次性的）。
提示 401 / Invalid JWT → 页面没更新到最新版本，重新传一次 coach-admin.html 并 Ctrl+F5。
提示该邮箱已注册 → 这个邮箱之前开过号。可能是上次已经开成功了（去教练库确认），要重开得先在 Supabase 后台 Authentication → Users 删掉该用户。
教练忘了密码
在 Supabase 后台 → Authentication → Users → 找到该用户 → 重设密码 → 让他用新密码登录，登录后在「我的设置」里自己再改一次。
客户提交后教练看不到线索
按顺序排查：①客户用的链接带没带 ?ref=（不带就是未归属）②总后台线索库里看这条是不是"未归属"，是的话指派给该教练③教练账号是不是被停用了。
总后台的某个按钮点了没反应
先看页面顶部有没有红色报错条（本系统任何脚本报错都会显式显示，不会静默空白）。若显示的是"缺少 master 的 XXX 策略"，去 Supabase SQL Editor 跑对应的 .sql 文件补策略。
7 · 要改东西，找谁 / 改哪
| 你想改 | 改哪儿 |
|---|---|
| 工具包的问题、题目、报告文案 | tool.html |
| 教练工作站的界面、字段 | coach-workbench.html |
| 总后台的功能、按钮 | coach-admin.html |
| 开通教练的后端逻辑 | supabase/functions/create-coach/index.ts → Dashboard 部署 |
| 数据库表、权限策略 | 对应 .sql → Supabase SQL Editor 跑一次 |
| 转发卡片的标题、副标题、缩略图 | 三个 HTML 里的 og:title / og:description / og:image（改完记得换参数破缓存） |
| 浏览器标签页图标 | favicon.ico / favicon-192.png |
教练＝一种职业（对外身份：零售4.0门店经营教练）；组长＝爱门店项目里的职位。两者是上下两层，不是笔误。当前这套工作站的教练头衔显示为「ai门店商修教练」。
ai门店 · 三端系统使用手册 v1.0 2026-10-21 · 本手册为单文件网页，可直接打印或转发