50 lines
4.2 KiB
Markdown
50 lines
4.2 KiB
Markdown
# 麦洛与社区、LMS 的协作边界
|
|
|
|
日期：2026-10-09。状态：用户已确认，D01 代码及正式设计已合入本地 main；未推送、更新安装版或部署服务。
|
|
|
|
## 产品职责
|
|
|
|
麦洛是创作和 AI 工具入口，支持普通项目、作品提交、视觉创作、机器人及智能体/项目咨询。社区 WS 承载课程原版、视频自学、任务作品关联、公开作品、活动和点数；机构 LMS 承载可选的课程采用和正式教学。
|
|
|
|
**麦洛客户端不体现课程。** 不增加课程目录、课次页面、课程任务上下文、learningOrigins、课程深链接、返回课次按钮或课程任务恢复。原详细设计中的这些客户端条款由后续用户指令取代，不是将来等待后端接口补齐的任务。
|
|
|
|
合作机构是否使用 LMS 不影响孩子使用麦洛。教培智念和恩野按普通合作机构规则参与；客户端不因此呈现机构身份或获得教学数据。
|
|
|
|
## 创作与成果
|
|
|
|
1. 孩子在社区或机构了解学习任务，然后在麦洛普通创作。
|
|
2. 已有作品上传/提交保持原构建、版本、重试、审核与公开交付规则。
|
|
3. 孩子回到社区网页，从本人已上传的固定编程版本中选择课程任务作品；关联失败只在社区恢复，不要求客户端再次构建或上传。
|
|
4. 是否公开由孩子另行发起。LMS 可引用当前公开的确切成果，提交由后端复核；麦洛不保存课程来源或替 LMS 确认作业完成。
|
|
|
|
普通项目、社区任务关联、作品公开和 LMS 作业提交是不同记录。课程关联不扩大私人内容访问，不证明能力掌握，也不把版本自动变成公开状态。
|
|
|
|
## 永久点数充值
|
|
|
|
家长为孩子购买点数时登录孩子账号。Sidebar 把当前认证账号的昵称/用户名传给 PointWallet，钱包明确显示充值对象。充值通过既有 Renderer → Main 固定 Host API → WS 账务接口，只提交产品及稳定请求身份，不提交另一个孩子 ID、价格或凭据。
|
|
|
|
是否允许充值由 WS 返回；旧服务端拒绝仍须显示不可充值。当前账号规则不改变家庭角色、共享钱包选择、另一付款方的隐私、云智能体创建者付款或 Plugin 个人付款。
|
|
|
|
订单冻结当前账号、金额和点数。结果不明先恢复原请求/订单，已有待支付或人工核对订单不能另建替代；服务端确认前不显示到账。账号切换后原响应不得回写新账号界面。
|
|
|
|
机构资助由 WS 运营按孩子人工发永久点数；客户端不维护机构额度、第二个钱包、周期重置或家长资金转移。充值也不授予课程观看资格。
|
|
|
|
## 工程落点与验证
|
|
|
|
| 落点 | 本次变化 |
|
|
| --- | --- |
|
|
| src/components/layout/Sidebar.tsx | 传当前认证账号的显示名 |
|
|
| src/components/account/PointWallet.tsx | 收款对象、家长登录孩子账号提示，保留资格及旧单恢复 |
|
|
| electron/api/routes/works-billing.ts | 拒绝提示不再要求切换为家长身份 |
|
|
| 既有 works-billing 服务/DTO | 认证和付款权威继续在 Main/WS；不增加课程或跨账号充值协议 |
|
|
|
|
源 281e6dc / 0d442ce 的 41 项定向单测、类型检查、相关 lint、Renderer/Main/preload 构建和 1 项 Electron 流程已通过；详见[实施任务](../30-worklog/tasks/20261009-makelore-product-implementation-eaa0ffa5.md)。本次只整合正式文档，应用和测试文件与源保持相同，不把文档检查算成重新运行这些测试。
|
|
|
|
先更新 WS 的当前账号充值资格，再发布配套客户端。实际支付提供方对孩子账号令牌的接受、真实到账及正式安装版仍需验收。代码与设计已完成本地主分支合并；没有付费请求、打包、安装、推送或部署。
|
|
|
|
## 配套权威
|
|
|
|
总体架构只在 WS 的 .project-docs/20-architecture/ecosystem-overview.md 维护；课程关联以 WS 的 community-product-design.md 和已确认 D05 修订为准；LMS 在自身 community-integration-design.md 维护采用、学生访问和公开成果契约。三仓分别维护本地职责，不复制整套课程状态或钱包。
|
|
|
|
旧 Learning 已退役；历史本地课程数据仍不读取、不迁移、不自动删除。现有老师 Agent 能力定义、普通创作和平台服务调用不因无课程边界被删除或改写。
|