学校/机构额度

页面40-org-bind.html · 学校/机构额度 · 验收见 ⑧ · 分工见 ⓪

阅读方式：每条先写界面上是什么，再写元素 ID 与接口。

展示顺序（按角色 · 章节号固定）

• 产品 / 老板：⓪ → ①～⑤ → ⑧
• 测试：⑧ → ①～⑤ → ⑦
• 研发：接口速查 → ①～⑤ → ⑥ → ⑦
• UI：①～⑤（图标路径在控件下）
• 数据 / 增长：⑨ → ⑥
• 多态页：③ 内分态 · ⑥⑦⑧⑨ 号不变

接口本页共 2 个 · GET /user/org · POST /user/org/bind · 完整见 ⑥

⓪ 本页做什么 · 分工速查

一句话：学生/合作方用户输入机构码绑定学校额度；绑定后 AI 能力优先消耗机构额度（与 B 端机构管理、用户 360°「机构绑定」只读区联动）。

• 产品 / 老板：⑧ · 每账号仅绑一家 · 不可自行解绑 · 与 G2 高校渠道「由学校统一开通」一致
• 测试：⑧ · 空码红框 · 无效码 Toast · 成功切已绑定态 · 重复绑定拦截
• UI：未绑定表单 + 已绑定摘要卡 · 贴底「确认绑定」
• 前端 / 后端：⑥ · 机构码校验 · 席位/停用态 · 后台 GET /admin/users/{id}/growth 同步展示
• 运营：绑定流程说明见 B 端 03-user-detail.html「增长与绑定 → 机构绑定」

① 顶栏 · 屏幕最上方

• 「←」返回 · btn_nav_back · fallback 11-settings.html · index 机模 data-embed-back="shell"
• 「学校/机构额度」 · page_title
• 「向学校或合作方索取机构码 · 绑定后使用机构额度」 · 灰字说明 · copy_org_bind_hint

② 未绑定态 · 表单（#unbound · panel_org_unbound）

• 「如何绑定」 · 三步有序列表 · list_org_bind_steps · 文案与 B 端运维说明逐字一致
• 「机构码」 · 单行输入 · input_org_code
  • 长度：1～32 字 · maxlength="32" · 提交前 trim · 转大写
  • 格式：字母数字与连字符 · 纯文本
  • 为空：点「确认绑定」→ is-invalid 红框 · 无羞辱 Toast · 不调 API
  • 非空提交后：成功 → Toast「绑定成功」· 切 panel_org_bound · 失败见 ⑥
• 「原型可试：ORG-SH-001 · ORG-BJ-006」 · 灰字 · copy_org_bind_demo_hint · 仅原型 · 正式上线隐藏或换运营文案

③ 已绑定态 · 摘要（#bound · panel_org_bound）

• 机构名称 · display_org_name · 响应 org.name
• 机构码 · 等宽 · display_org_code · org.code
• 「机构额度 X / Y」 · display_org_quota · org.quota_used / org.quota_total
• 「绑定时间：…」 · copy_org_bound_at · org.bound_at
• 「已绑定机构后不可自行更换…」 · copy_org_bound_note

④ 贴底 CTA（仅未绑定态）

• 「确认绑定」 · 橙色主按钮 · btn_bind_org · 已绑定态隐藏底栏

⑤ 入口 · 设置页

设置 11-settings.html · link_org_bind「学校/机构额度」→ 本页 · 详 ⑦

⑥ 机构绑定 · 本页共 2 个

说明：原型 _org-bind-mock.js · sessionStorage · 上线替换 · 清单 → dev-notes · 静态 mock → API

① GET /user/org · 进页 / 绑定成功后刷新

• 鉴权：需登录 · 401 → 登录页
• 响应 · 未绑：{ "bound": false, "org": null } · 已绑：org 含 code · name · bound_at · quota_used · quota_total
• 字段→控件：见 ②③ · 已绑隐藏 panel_org_unbound 与底栏

② POST /user/org/bind · 点 btn_bind_org

• body：{ "org_code": "ORG-SH-001" } · trim · 大写 · 1～32 字
• 成功：200 · 返回与 GET 相同结构 · Toast「绑定成功」
• 400：空码 · 无效码 · 机构已停用 · 席位已满
• 409：已绑定其他机构 · Toast「你已绑定机构，无需重复绑定」
• 后台联动：B 端 GET /admin/users/{id}/growth · org 字段与本响应一致 · 机构主数据 GET /admin/orgs

⑦ 入口 · 出口

• 入口：11-settings.html · link_org_bind · 我的 Tab → 设置
• 出口：← 返回设置 · 绑定成功停留本页已绑定态
• 后台只读：03-user-detail.html · Tab「增长与绑定」· 机构绑定区块

⑧ 怎么验收

1. 左右对照：设置页见「学校/机构额度」· 与本页 ② 文案一致
2. 未绑定：空码点绑定 → 输入框红框 · 无 Toast 骂人
3. 有效码：输入 ORG-SH-001 → Toast「绑定成功」→ 见机构名与额度 · 底栏消失
4. 无效码：乱码 → Toast「机构码无效…」+ 红框
5. 停用机构：试 ORG-WH-004 → Toast「该机构已停用…」
6. 滚到 ⑥：可见 GET/POST 专章 · 与 B 端 growth 联动说明
7. 跨端：绑定后打开 B 端用户详情「增长与绑定」（原型 mock 独立存储 · 上线同 API）

⑨ 分期与排期

• 原型 · _org-bind-mock.js · 演示码仅 file:// · ⑨ 不上屏 PRD 编号
• 正式上线 · 替换 ⑥ · 隐藏 copy_org_bind_demo_hint · 渠道深链自动带码为 P1 扩展
• 后台 · P1 机构管理 12-org-list.html · 1.0 验后台 · 无试点校