多商家在线学习系统设计文档

版本：V1.1　日期：2026年9月16日　用途：产品方案与交互评审

01 系统定位与交付范围

平台向教育商家提供独立品牌的在线学习系统，并提供流量供应商、律所供应商的对接服务。商家选择是否申请服务。平台统一维护商家和供应商，查看各商家经营状况；商家管理本机构客户、学员、课程、订单和服务申请。

本次设计覆盖平台 PC、平台移动端、商家 PC、商家移动端、供应商 PC、供应商移动端六端。供应商端为独立正式角色，区分流量供应商和律所供应商。学员端仅定义商家专属入口及数据关联，不设计页面。

交付文件：index.html 为六端设计导航，prototype.html 为可点击原型；design.html 为可浏览和打印的设计文档；design.md 为可编辑源文档；screens 目录为六端关键页面 PNG。所有名称、金额、联系方式、进度均为演示数据。原型不连接真实账户、支付、短信、供应商或二维码服务。

当前方案假设

以下为可替换的产品假设，尚非已确认业务事实：商家自行收款，平台读取订单与退款结果，不统一代收或分账；供应商由平台录入并邀请登录，自行更新授权任务进度，平台协调监督；移动端采用响应式 H5，可用于后续小程序交互参考；机构学员账号按商家隔离。同一手机号可分别加入多家机构，但各机构之间不共享档案。

待确定：支付通道与结算主体、平台收费模式、线索是否收费及计费标准、律所服务费用与合同签署方式、移动端最终载体、不同岗位的数据范围、存量学员迁移规则。上述事项不阻碍本轮原型评审，但影响正式开发与验收范围。

02 产品架构

平台管理层 → 商家机构空间 → 商家专属访问入口或官方链接 → 商家学员与课程。

平台资源层包括流量供应商和律所供应商。供应商与商家的关系通过“服务申请”建立，不因供应商被录入而自动开通。线索必须通过已启用的合作关系分发；法律服务仅围绕商家授权的具体纠纷进行。

平台不是学员的选课门户。学员界面显示商家名称、Logo、课程和商家联系方式。不得设置平台商家广场、跨商家搜索或平台账号入口。实际交易主体、必要条款和服务主体应如实显示，品牌隐藏不能改变真实交易关系。

核心对象及关联

03 角色与权限

所有数据权限在服务端判定，不能仅靠菜单隐藏。平台经营看板以聚合数据为默认视图，联系人默认脱敏。导出、查看敏感材料、退款和入口重置应具备独立权限。

PC 与移动端使用同一账户和权限。移动端并不扩大权限。停用员工后立即失去访问能力，历史操作记录保留。

04 信息架构与页面清单

平台端

商家端

原型保留原有平台与商家页面，新增商家供应商详情与在线沟通，并扩展供应商资料和在线沟通。PC 与移动端均覆盖。关键详情使用详情弹层，移动端转为全屏面板。新增和申请使用表单弹层。复杂课节编辑、任意角色权限配置、支付、真实材料上传和正式报表为下一阶段细化功能，当前提供字段与规则，不伪装成已接入能力。

供应商端 PC 与移动端

供应商管理员由平台邀请激活，不开放匿名自注册。登录后直接进入所属供应商工作空间，账号类型由服务端核验。原型的身份下拉仅供评审切换，正式产品不允许任意切换未授权角色。

S01 协作工作台展示当前合作、待处理反馈和任务；S02 线索交付仅向流量供应商开放，填写客户称呼、联系方式、学习意向、授权来源和合作商家，平台审核去重后分发；S03 授权纠纷仅向律所开放，按工单与成员授权访问材料；S04 合作任务查看约定范围与执行情况；S05 资料页维护机构介绍、产品、成功案例、服务范围、联系人和审核状态；S06 消息中心仅通知本供应商任务；S07 在线沟通承接商家咨询与回复。

供应商不能自行将合作设为生效或取消商家授权。律所提交处理结果进入待商家确认，最终关闭由商家确认或平台按约定协调。商家撤回授权后，后续文件访问立即受限，历史服务记录保留。供应商被停用后关闭其登录，平台负责转接未结束任务，不自动删除合作数据。

供应商端提供 PC 与移动适配的 7 个页面，包括工作台、线索交付、授权纠纷、合作任务、在线沟通、供应商资料与消息中心，以及流量和律所两种任务范围。正式材料上传、细粒度成员分配、合同签署和计费不在本轮演示中。

05 关键业务流程

商家开通与专属入口

平台录入商家 → 保存待启用 → 完善联系人与机构资料 → 平台启用 → 商家管理员接受邀请 → 配置品牌和上架课程 → 生成机构固定入口 → 下载二维码 → 学员扫码或点击官方链接进入该机构。

商家名称必填，长度 2 至 40 字；联系人、联系手机号必填；地区和经营类别必填。相同联系电话并不能直接判定同一机构，重复录入时按机构标识提示复核。启用后不自动生成课程或创建真实支付账户。

机构状态：待启用 → 正常 → 暂停招生 → 停用。暂停招生阻止新购买但保留已购学习；停用时使用机构品牌的服务说明页，并提供处理存量权益的业务入口。停用前显示存量学员、有效订单和在办服务影响，输入原因并确认。

供应商录入与商家申请

平台录入供应商 → 校验必填资料 → 上架可见 → 商家浏览 → 主动申请并授权必要信息 → 平台受理 → 协调供应商 → 确认合作范围 → 服务中 → 完成或终止。

供应商状态与商家合作状态分开：供应商下架只阻止新申请，既有合作进入运营处理，不自动标记完成。服务申请状态：待受理、待补充、对接中、服务中、已完成、已拒绝、已取消。待受理可取消；进入服务中后通过终止流程处理。每次退回、拒绝和终止记录原因。

流量线索分发与转化

供应商交付或平台人工录入 → 校验联系方式与授权来源 → 同机构内去重 → 选择已开通合作的商家 → 平台推送 → 商家接收或退回 → 分配员工 → 跟进 → 成交关联学员和订单。

线索状态：待分发 → 待接收 → 待跟进 → 跟进中 → 已建档 → 已转化，另有无效分支。已建档表示关联机构学员；已转化必须有成功支付订单。退回需要原因并回到平台待处理池，原分发记录保留。不能直接覆盖归属以消除历史。每条线索同一时刻只归属于一个商家；多机构分发必须另行确认授权与计费规则。

建议默认 24 小时未接收触发运营提醒，可配置，不自动判定无效。转学员时先在本机构内匹配手机号，找到已有学员则关联；未找到则创建。转学员不代表付款，不自动增加收入或授予课程。

课程发布与购买学习关联

课程草稿 → 填写封面、名称、分类、讲师、价格、有效期和课节 → 预览 → 发布 → 学员购买 → 支付成功且校验通过 → 发放学习权益。

课程状态：草稿、已上架、已下架。下架停止新售卖但不撤回已购权益。课程更新保留订单购买时的价格与课程快照；删除已有订单的课程不可用，改为归档。移动端可修改上下架状态，完整课节编排与批量上传放在 PC。

订单与退款

订单交易状态和售后状态分开。交易状态为待支付、已支付、已关闭；售后为无售后、退款处理中、部分退款、全额退款、退款失败。退款审批成功不等于退款到账，必须以支付渠道结果更新。

商家发起或处理退款 → 校验可退金额 → 记录原因 → 有权限者审批 → 渠道执行 → 回调更新订单与权益 → 写入审计。待支付订单不能退款；累计退款不得超过实付；重复回调不重复执行。全额退款后的权益处理按协议配置，默认关闭关联权益；部分退款不能默认撤销全部课程。

本原型仅演示退款申请，不实际审批或执行资金操作。

纠纷与律所协作

商家创建纠纷 → 关联学员与订单或填写无订单原因 → 填写事实和诉求 → 选择已合作律所或先申请对接 → 明确材料授权范围 → 平台协调 → 律所处理进展 → 商家确认处理结果 → 关闭或重新打开。

工单状态：待受理、待补充、处理中、待确认、已关闭。平台仅协调，不自动判断责任或承诺胜诉。附件采用按工单授权的访问权限和有效期；下载、查看、撤回均留记录。通知不得附带完整身份证号、支付凭证或纠纷正文。原型不接收真实法律材料。

06 商家二维码与品牌隔离

“唯一入口”定义为每个商家拥有一个当前有效的机构入口地址。二维码编码此地址，官方链接直接展示同一地址，两者属于同一入口的不同访问形式。学员可扫码或点击链接；受保护的课程和个人资料仍须登录校验。

入口示意为 /entry/{opaque_token}。opaque_token 为不可预测随机标识，服务端解析 merchant_id。不要把顺序商家 ID、手机号或学员资料写入二维码。学员后续登录、选课、支付、学习始终带入并校验机构上下文，篡改地址不能跨机构取数。

二维码在打印和传播期间保持稳定；品牌和课程更新不改变二维码。重置入口需要二次确认并说明旧二维码和旧链接同时失效的影响，记录操作者、原因和时间。旧二维码与旧链接显示该机构“入口已更新，请联系机构获取新二维码”，不跳转平台或其他机构。

无入口参数、无效码、被停用入口均不得展示平台机构列表。用户扫码另一机构时提示即将进入的新机构名称，重新建立当前机构会话；旧机构订单和档案不混入新机构。

官方链接支持主动复制与转发，与二维码共享不可预测入口标识。复制成功显示明确反馈；浏览器禁止自动复制时选择链接并提示手动复制，不误报成功。品牌或课程调整不改变地址；重置后二维码与链接共同更新。示例使用 learn.example.com 占位，正式域名、证书和机构分享标题需在上线前配置。

07 页面交互规范

平台经营总览

顶部日期范围与商家筛选影响全部指标与趋势，显示更新时间。指标为正常商家数、实付总额、去重付费学员、待处理服务。趋势提供金额坐标、日期坐标和无数据状态。点击经营排行中的商家进入详情，详情显示该商家指标而非全平台数字。

列表与详情

PC 使用左侧导航、顶部身份区、页标题、搜索筛选、表格、分页。主操作在页标题右侧。移动端使用单列卡片，每条先显示名称、状态、核心指标和主操作，避免横向表格。行内“查看”打开详情；详情包含对象基本信息、关联数据和时间线。

搜索覆盖当前页面关键字段，和状态筛选共同生效。结果为空显示“没有符合条件的记录”并允许清除筛选；没有任何业务数据时显示引导创建入口。加载失败保留筛选条件并提供重试。无权限时显示范围说明，不以空列表冒充没有数据。

表单

必填字段有标记并提供就地错误。提交时禁用重复点击；成功返回详情或列表并显示反馈；失败保留已填内容。取消未保存内容需要提醒。平台录入商家与供应商分别使用明确表单，不合并为抽象“资源录入”。

服务申请显示服务对象、类型、当前机构、联系人、需求和信息授权。重复未结束申请被阻止。二维码重置、机构停用、员工停用、课程下架、退款等影响较大的操作都展示具体对象和影响。

移动端导航

平台底部：总览、商家、服务、更多；商家底部：工作台、服务、沟通、更多；供应商底部：工作台、资料、沟通、更多。客户与学员仍可通过更多或工作台进入。更多面板提供全部页面入口。底部点击目标至少 44px，高频动作固定在详情底部；表单全屏，操作区避开安全区。PC 核心表格最小阅读宽度约 1100px；移动端在 390px 宽度下不横向溢出。

08 数据指标口径

平台跨商家汇总不能直接称为自然人去重学员。金额币种暂按人民币元；数据库使用整数分或定点数。生产报表导出必须记录筛选条件、时区、生成时间与权限范围。原型中的趋势是演示值，不能用作实际经营判断。

09 视觉系统

沿用学员首页清爽、蓝色主操作的方向。管理端采用深蓝文字、白色卡片、浅灰蓝背景，降低营销海报的干扰。平台使用深色导航和蓝色标记；商家使用机构名及绿色辅助标记，保持两个工作空间可识别。

颜色：主色 #2864EB，正文 #172B4D，辅助文字 #68788F，背景 #F4F7FB，边框 #E5EAF2，成功 #16836B，警示 #B7791F，异常 #CF4D59。状态同时使用文字，不只靠颜色区分。

PC 标题 26px，正文 14px，表格 13 至 14px；移动端标题 22px，正文 14 至 16px。卡片圆角 14px，主要间距采用 8px 倍数。主按钮使用实色，次操作用浅色或边框。数字指标包含单位。图标用于辅助识别，不代替操作文案。

键盘焦点可见，弹层提供关闭按钮与 Escape 关闭。正式实现应补充焦点锁定、屏幕阅读器标签和操作完成后的焦点恢复。长机构名称允许换行或在详情完整显示。

10 数据隔离与运行要求

所有商家业务表必须拥有商家归属；API、文件存储、导出、搜索索引、后台任务和缓存键都校验相同范围。平台聚合权限和商家操作权限分开，不采用前端传入 merchant_id 即可信的方式。

登录失效时保存安全的返回路径，重新登录后再次检查权限。文件使用受控访问地址；员工退出或权限撤销后不得继续访问缓存下载。批量导出为异步任务并限有效期。支付回调、线索导入和服务状态更新具备幂等标识，避免重复订单、重复扣款和重复分发。

同一对象并发修改时提示版本变化，不能悄悄覆盖他人跟进。重要写入拥有创建时间、更新时间、操作者和操作版本。删除采用归档或逻辑删除，涉及订单、权益和审计的数据不直接物理删除。

性能目标待团队评估：主要列表默认分页 20 条，移动端加载 10 至 20 条；总览聚合允许短时间缓存并标明更新时间；超大范围报表异步生成。附件大小、类型、存储地区、保留期限与具体服务协议在开发前确认。

11 验收场景

1. 平台新建商家后，商家列表出现该对象，未启用前不能招生；启用生成正确机构上下文。

2. 商家 A 登录后修改 URL、请求参数或导出任务 ID 均不能读取商家 B 的客户、订单、课程和附件。

3. 没有开通供应商合作的商家不接收该供应商线索；拒绝申请保留原因。

4. 同一线索重复提交不重复分发；退回后历史归属和理由仍可查。

5. 商家转学员匹配本机构手机号，不能误关联其他商家；未付款不产生付费指标。

6. 课程下架后不能新购买，已有有效权益继续学习。

7. 支付重复回调只发放一次权益；退款失败不显示退款完成。

8. 入口轮换后旧二维码与旧链接同时失效，新码和新链接只进入当前机构；不显示平台或其他商家的入口。

9. 无权限员工无法查看纠纷附件；变更授权后旧访问地址按规则失效。

10. 390px 移动界面无横向溢出，底部导航不遮挡末条内容；所有关键操作有结果反馈。

11. 搜索无结果、列表加载失败、服务重复申请、表单缺少字段均有明确反馈。

12. 平台跨商家实付汇总和商家同口径报表可对账；统计界面标明日期和更新时间。

12 实施顺序与评审边界

第一阶段完成商家开通、权限隔离、课程订单学员、机构入口、基本经营数据，使商家能独立经营。

第二阶段完成供应商录入、商家自愿申请、线索分发接收跟进、纠纷工单和协作进度，形成平台资源服务闭环。

第三阶段细化供应商协作权限、报表导出、自动提醒、批量操作和可配置权限；如确认平台代收分账，需要另行增加结算域。

本轮可直接评审业务边界、导航结构、页面布局和关键交互。正式开发前需确认待定商业规则，并细化接口、支付方案、课节编辑器、附件策略与运营制度。可点击原型是本地演示，不是已实现的生产系统。

13 V1.1 供应商公开主页与内容管理

本版本将供应商协作升级为独立供应商端。PC 侧侧栏管理任务、公开资料和会话；移动端强调资料维护、咨询回复和任务处理。流量供应商仍只能访问自己的线索交付；律所仍只能访问已授权工单。公开主页向已登录商家展示，不向学员暴露。

资料字段

机构名称和供应商类型由平台建立。供应商可编辑一句话介绍、机构介绍、服务范围、服务特点、业务联系人、工作时间；后续可增加机构 Logo、资质和团队展示。文字保持可编辑、可预览、可退回修改。

产品字段包括产品名称、摘要、适用机构、详细介绍、交付流程、费用方式。默认采用按方案报价，不将咨询页面设计为即时购买或自动扣费。案例字段包括标题、摘要、客户背景、服务方案和项目结果；提交时确认授权与脱敏，不将匿名案例的结果描述为所有客户都可获得的承诺。

版本发布流程

编辑资料或新增产品、案例 → 保存草稿 → 提交平台审核 → 通过并发布或退回修改。草稿与已发布版本分离，审核期间商家仍看到旧版本。再次编辑会把当前版本恢复为草稿，需重新提交；每次审核按提交快照处理，避免未审内容公开。

平台在供应商详情检查介绍、产品与案例，可通过并发布或填写退回原因。提交完成显示待审核状态；重复提交受阻止。审核通过后更新公开主页与市场卡片，历史会话引用保留发送时的产品或案例标题，不改写已发送消息。

商家浏览流程

服务市场卡片展示供应商类型、定位、服务范围、产品数、案例数与主推产品。卡片提供查看详情和在线咨询两个入口。详情页使用机构介绍、产品介绍、成功案例三个标签，右侧为咨询区，移动端转为单列。

产品详情显示具体服务内容、适用机构、费用方式与交付步骤，可直接咨询该产品。案例详情显示背景、方案和结果，可咨询相关服务。合作申请保持独立，聊天不自动申请合作、不产生付款、不授权学员档案。

14 双方即时沟通 IM

会话与权限

会话主键为 merchant_id 与 supplier_id 的组合，一对机构在本版本只拥有一个主会话。会话成员分别来自该商家和该供应商的授权客服或管理员。会话建立前，商家只能向当前已上架且可咨询的供应商发起咨询；供应商回复后不自动获得商家全量客户与订单权限。

平台不是默认会话参与方。仅在投诉处理且具备明确授权与审计的情况下按制度介入。正式系统必须在列表、消息历史、发送接口、实时订阅、附件和搜索中验证会话成员关系。

PC 与移动端交互

PC 采用会话列表加聊天面板两栏。列表展示机构名、最后一条消息、时间与未读数；聊天区显示当前对方、消息记录、引用内容与输入区。移动端拆为会话列表与独立聊天页；点击返回进入列表，进入聊天时隐藏底部导航，输入区留在聊天页底部并适配键盘与安全区。

从产品或案例详情发起咨询，会生成可编辑的消息草稿和引用卡片。用户点击发送后才成为正式消息，页面跳转本身不自动发送。切换会话保存各自草稿，避免将甲供应商内容误发给乙供应商。再次打开会话定位最近消息，正式系统支持向上分页加载历史记录。

消息状态与异常

文本消息要求非空且不超过1000字，默认点击发送，回车用于换行。状态定义为发送中、已发送、对方已读、发送失败。服务器确认接收后才显示已发送，接收方实际打开会话并读取后确认已读；不能将网络连接成功当作消息已读。

发送请求带客户端唯一消息标识，重试复用标识，断线恢复后按服务器消息序号补齐，避免重复或乱序。发送失败保留原文和重试入口。未读按会话成员的最后已读序号计算，多端同步，通知预览默认只显示必要摘要。

当前原型支持双方身份切换后的文本收发、未读提示、已读反馈、引用卡片、草稿保存和离线失败重试演示。数据只保存在本浏览器，不连接真实服务器，也不向真实商家或供应商发送任何消息。跨标签同步依赖浏览器允许同源本地存储；最可靠的评审方式是在同一个原型页面切换身份。

后续扩展边界

图片、文件、语音、撤回、会话转接和搜索为后续扩展，当前不显示伪装成可用的发送按钮。纠纷敏感材料通过带权限的工单附件交换；聊天可引用工单，不默认开放全部材料。供应商停用后历史会话只读，显示联系平台的处理说明；成员退出后立即失去会话访问权。

15 V1.1 官方链接与新增验收

机构访问入口页面同时展示二维码与只读的官方访问链接，并提供复制按钮。点击复制只改变剪贴板，不自动向外发送。链接直接进入本机构，不跳平台商家列表；访问者进入后的所有课程、订单、登录和支付仍绑定当前商家。正式二维码图片必须编码页面展示的同一个完整链接。

重置入口弹窗明确说明旧二维码和旧链接同时失效，新版本同时更新两种展示，保留学员账号和已购权益。下载入口说明同时包含版本与链接；正式上线以二维码PNG下载替换占位演示，并配置必要分享标题与机构Logo。

新增验收场景

1. 供应商修改机构介绍、增加产品或案例后保存草稿，商家侧暂不变化；平台通过审核后同步更新。

2. 被退回资料显示原因，修改重提后仍保留旧公开版本，未审核字段不会泄露。

3. 商家从供应商卡片进入详情，可分别查看产品和案例；从指定产品咨询时保留正确供应商和引用标题。

4. 仅打开咨询页不发送消息；空白消息被阻止；每个会话独立保留未发送草稿。

5. 商家发送的消息仅对应供应商可见；供应商回复后，商家同一会话可见，不混入其他供应商会话。

6. 未读在对方未打开会话时保留，实际打开后同步为已读；离线失败可重试且不重复生成消息。

7. 390px移动布局可浏览详情、编辑资料和完成收发；聊天输入框与发送按钮不被底部导航遮挡。

8. 点击复制得到完整官方链接，复制失败不误报成功；重置后链接版本与二维码入口版本一致。

9. 通过官方链接与通过二维码进入同一机构，旧地址失效后不进入其他商家。

本轮交付保留原平台与商家页面，新增供应商六端导航、资料维护、公开主页、双方沟通与链接操作。生产级IM、域名和二维码服务仍须在正式开发阶段接入。

关键页面原型图

共28张。点击打开完整原图；交互请在六端原型中体验。移动长图将底部导航放在图末，实际页面中导航固定于屏幕底部，聊天页隐藏导航。

平台 PC 经营总览

平台 PC 供应商管理

平台移动 经营总览

商家 PC 工作台

商家 PC 服务市场

商家 PC 供应商主页

商家 PC 产品介绍

商家 PC 成功案例

商家 PC 在线沟通

商家 PC 二维码与官方链接

商家移动 工作台

商家移动 服务市场

商家移动 供应商主页

商家移动 产品介绍

商家移动 成功案例

商家移动 会话列表

商家移动 在线沟通

商家移动 二维码与链接

供应商 PC 工作台

供应商 PC 机构介绍

供应商 PC 产品管理

供应商 PC 案例管理

供应商 PC 在线沟通

供应商移动 工作台

供应商移动 机构介绍

供应商移动 产品管理

供应商移动 案例管理

供应商移动 在线沟通