docs(product): integrate implemented community and teaching boundaries

2026-10-09 15:44:37 +08:00
1 parent 0d442ce576
commit 12af6aed5d
@@ -0,0 +1,49 @@
+# 麦洛与社区、LMS 的协作边界
+
+日期：2026-10-09。状态：用户已确认，本地 D01 代码及正式设计在独立集成分支对齐；未更新安装版或部署服务。
+
+## 产品职责
+
+麦洛是创作和 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 能力定义、普通创作和平台服务调用不因无课程边界被删除或改写。
@@ -14,6 +14,8 @@ Renderer 自由输入／空输入框上方已发布快捷提示（历史缺字

 ## Permanent wallet and recharge

+家长登录孩子账号 → Sidebar 将当前账号显示名传给 PointWallet → 核对收款对象后按服务端资格充值。课程观看和任务作品关联只在社区网页完成，不向客户端传课程上下文；参见[协作边界](community-collaboration.md)。
+
 账号菜单 / PointWallet → `src/lib/works-billing.ts` → Main 固定 `/api/works/billing/*` 路由 → Works Square 账务 API。Main 持有认证与账号绑定，通过 `shared/works-billing.ts` 的公开 DTO 投影余额、产品、订单及流水；充值沿用 Renderer capability，Renderer 不传付款人、价格、Token 或任意上游地址。账号切换后 Main 与账号绑定的 UI 丢弃迟到结果，打开菜单和窗口 focus 刷新当前账号。

 本人点数与 AI 编程已选付款来源分开呈现。`shared_available` 为布尔值时只向 Renderer 提供另一付款方的可用性，精确余额置空；为 `null` 时保留本人规范字符串余额，即使 `family_shared=true` 且来源为 `self` / `shared_group`。充值资格来自服务端，不能用旧会员管理权限或共享标记推算。云智能体创建者付款与 Plugin 个人付款不受 AI 编程来源选择改变。
@@ -1,5 +1,9 @@
 # Module Map

+## Community Collaboration · 2026-10-09
+
+社区协作只调整 src/components/account/PointWallet.tsx、Sidebar.tsx 的当前账号展示与 electron/api/routes/works-billing.ts 的拒绝提示，沿用原账务传输；不新增课程模块。具体设计见[协作边界](community-collaboration.md)。
+
 ## Source Layout

 | Path | Responsibility | Owner Notes |
@@ -1,5 +1,9 @@
 # System Overview

+## Community Collaboration · 2026-10-09
+
+当前跨产品职责见[社区协作与充值边界](community-collaboration.md)：本地 D01 已实现当前登录账号充值和收款对象展示；家长使用孩子账号。课程目录、任务与进度留在 WS/LMS，麦洛不新增课程 UI、上下文、learningOrigins 或深链接。普通创作、发布、Main 认证和既有云端咨询保持。
+
 老师咨询沿用 Main-owned Yuxi 事件与项目聊天 SSE。`cloud-runner` 分离主线程 `reasoning_content`（兼容已保留的 `additional_reasoning_content`）增量和当前消息的回答原文预览；service 用 `previewTeacherReply` 从未完成结构化回复投影正文，最终仍由完整解析确认。新消息／工具续接替换正文预览，问题级独立 `reasoning` 字段继续累积，终态初次读取也消费保留事件。Renderer 分开展示思考和 Markdown 正文，运行时展开思考、终态收起，快捷回复只在完成后可见。取消／失败保留片段与原文；思考随轮保存但不进入模型上下文或带回正文，子线程只推进游标。无新增服务端协议或模型配置，未返回思考的模型仍正常输出正文。

 咨询输入区从当前老师发布定义的 `shortcuts` 按序渲染展示文案，并通过已有普通提问路径发送实际提示词；不附加旧 suggestions 意图。明确的空列表隐藏入口，缺字段/null 保留旧入口。多项长文案在限定高度内滚动，正在回答时不可点击；目录更新不替换项目聊天或草稿，同一未确认提问重试保留请求身份。详见[老师决定](../10-decisions/ADR-2026-09-22-coding-teacher.md)。