提交四仓工程架构索引
This commit is contained in:
zizi
parent
e50aa02b41
commit
9eacebb630
@ -1,7 +1,7 @@
|
||||
# New-Design（新设计）V2 文档大纲（入口）
|
||||
|
||||
- 版本：v5
|
||||
- 更新日期：2026-05-19
|
||||
- 版本：v6
|
||||
- 更新日期：2026-05-24
|
||||
- 目标读者：产品 / 架构 / 前端 / 后端 / 文档维护者
|
||||
- 阅读时间：10–20 分钟
|
||||
- 边界说明：本文件只负责导航、边界和归属，不重复解释概念；概念解释必须落在对应主文档中。
|
||||
@ -18,6 +18,24 @@
|
||||
- 术语统一：规范数据(Canonical) / 待审层(Shadow) / 作品(Work) / 章节(Chapter) / 文本块(Block) / 元结构定义(MetaSchema) 等，以 `架构-02-核心数据结构与双轨模型.md` 为准。
|
||||
- 临时改造文档只作为迁移依据；临时文档删除后，正式归属由 `产品-*`、`流程-*`、`架构-*`、`前端-*`、`后端-*` 和 `doc/dev/*` 承担，不成为长期单一事实源(Single Source of Truth, SSOT)。
|
||||
|
||||
## 工程仓库架构
|
||||
|
||||
阶段 7 以后，Muse 工程按四个仓库协作。仓库名是工程落地边界；业务概念、状态机、Schema 和 API 的单一事实源仍按本文档集的 owner 归属执行。
|
||||
|
||||
| 仓库 | 来源 / 形态 | 职责 | 主读文档 |
|
||||
|---|---|---|---|
|
||||
| `muse-cloud/` | fork `YunaiV/yudao-cloud` | 后端主仓；承接网关、system、infra、framework、任务、文件、权限等 Yudao 基础能力，并补 Muse 的 content、knowledge、ai、market、account 业务模块 | `后端-01`、`后端-02`、`后端-03`、`后端-04`、`后端-05` |
|
||||
| `muse-admin/` | fork `yudao-ui-admin-vben` | 管理端；承载 Admin Console 的系统治理、元结构、Prompt / Agent、全局知识、市场治理、用户、权限、审计和质量观察 | `产品-02B`、`流程-01A`、`流程-02A`、`前端-01`、`后端-05` |
|
||||
| `muse-studio/` | 自研用户端，推荐 Next.js / React | 普通用户创作端；承载我的作品、作品工作台、写作台、智能体工作台、知识库工作台、市场和个人中心 | `产品-02C`、`产品-02D`、`产品-02E`、`产品-02F`、`产品-02G`、`前端-01`、`前端-02`、`前端-03` |
|
||||
| `muse-design-docs/` | 当前 `design-docs/` 独立化后的设计文档仓 | 产品、架构、流程、前端、后端、专题和阶段计划的设计 SSOT；不承载运行时代码 | `00-文档大纲`、`内容映射表`、`临时-产品形态阶段化重设计计划` |
|
||||
|
||||
协作约束：
|
||||
|
||||
- `muse-admin/` 只调用 `/admin-api/**`，不承载普通用户写作台、候选接受或作品知识取舍。
|
||||
- `muse-studio/` 只调用 `/app-api/**`，不暴露系统 Prompt、底层 Pipeline、管理员审计或后台配置表。
|
||||
- `muse-cloud/` 内部按领域 owner 写事实；`/admin-api/**` 和 `/app-api/**` 只是入口不同，不表示两套领域事实。
|
||||
- `muse-design-docs/` 只定义目标设计和 owner 归属；实现仓的代码、迁移和测试必须反向对齐这里的正式文档，不能用实现便利反改产品语义。
|
||||
|
||||
## 角色视角导航
|
||||
|
||||
| 角色视角 | 先读 | 再读 | 边界 |
|
||||
|
||||
@ -46,7 +46,7 @@
|
||||
3. `后端-05` 中动态字段是否仍没有跨 owner 泛写接口。
|
||||
4. `专题-01`、`流程-02B` 和 `前端-02` 是否仍要求 Candidate Decision Envelope 硬闸门。
|
||||
5. `架构-01/02/04`、`后端-03/04/05`、`专题-03` 是否仍统一 SourceStatus / SourceEventType / SourceActionPolicy。
|
||||
6. 阶段 8 的 `00-文档大纲.md` 和 `内容映射表.md` 仍未在本次修复中更新，进入阶段 8 时需要统一刷新索引和 owner 映射。
|
||||
6. 阶段 8 已在 D-046 开始补 `00-文档大纲.md` 和 `内容映射表.md` 的四仓工程架构索引；后续仍需继续复核其他过期引用和 owner 映射。
|
||||
|
||||
## 5. 验证方式
|
||||
|
||||
@ -58,4 +58,3 @@
|
||||
4. 动态字段泛写入口扫描。
|
||||
5. SourceStatus / SourceEventType / SourceActionPolicy 旧口径扫描。
|
||||
6. 原型用户可见技术词扫描。
|
||||
|
||||
|
||||
@ -43,7 +43,7 @@
|
||||
| 阶段 5 | `design-docs/架构-01-系统全貌与边界上下文.md` / `design-docs/架构-02-核心数据结构与双轨模型.md` / `design-docs/架构-04-状态机与约束清单.md` | 承接产品与流程，调整有界上下文、核心模型、状态机和约束清单 | 已完成并提交 |
|
||||
| 阶段 6 | `design-docs/专题-*` | 按需要调整 AI 编排、质量门控、竞品取舍、正文建议接受等专题合同 | 已完成并提交 |
|
||||
| 阶段 7 | `design-docs/前端-*` / `design-docs/后端-*` | 承接产品、流程、架构结论，更新工程结构、Schema、API 和实现约束 | 整体一致性修复完成，待复核确认 |
|
||||
| 阶段 8 | `design-docs/00-文档大纲.md` / `design-docs/内容映射表.md` | 最后统一索引、文档 owner 和内容映射，清理过期引用 | 待开始 |
|
||||
| 阶段 8 | `design-docs/00-文档大纲.md` / `design-docs/内容映射表.md` | 最后统一索引、文档 owner 和内容映射，清理过期引用 | 已开始；四仓工程架构索引已补 |
|
||||
|
||||
阶段 2 当前基线状态：
|
||||
|
||||
@ -100,8 +100,8 @@
|
||||
| C-002 | 阶段 2.5~2.7 二轮复核 | `产品-02C` 局部冻结基线与 02F/02G 作品资产发布/使用需求 | 02F/02G 需要作品资产发布准备包和作品资产使用 owner，但当前不能跨阶段修改已冻结的 02C | 在 02F/02G 中标为后续阻断：02C 后续补齐 `work-publish-prep` 和作品资产使用预检前，作品资产不得提交发布、模板化、参考写入或进入 AI 上下文 | 待后续阶段承接 |
|
||||
| C-003 | 阶段 3 review | `产品-03` 初稿与前序安全/资产边界 | 子代理 review 发现外部知识 lineage、保护节点不可开放、handoff 生命周期、知识库类型、市场授权/安装/绑定状态、管理员分权等边界需要补强 | 阶段 3 只修 `产品-03`，不反改 02 系列；将确认为流程/架构必须承接的不变式 | 已修复并确认 |
|
||||
| C-004 | 阶段 4 review / 阶段 5 复核 | `产品-03` 与阶段 4 四分册 | 初次 review 认为 `产品-03` 中存在“已确认作品事实自动回滚”的旧口径残留；阶段 5 复核确认该短语位于“不能被解释为”列，不是旧口径 | 不需要跨阶段修改 `产品-03`；阶段 4 和阶段 5 均继续按“已确认事实不自动回滚，但受限来源不得继续进入新生成、新绑定、新导出许可范围或新的知识确认”处理 | 已复核，无需修改 |
|
||||
| C-005 | 阶段 7 准备 | 旧 `前端-*` / `后端-*` 与当前 Muse 工程口径 | 旧前端文档把管理员后台和用户端都写成 Next.js 同一前端；旧后端文档按 `muse-*` 自研模块化单体描述，未承接 Yudao Cloud fork、Vben Admin 管理后台和独立 `muse-studio` 用户端的工程基线 | 阶段 7 已按新工程口径重写前后端架构：后端以 `yudao-cloud/` fork 为底座，管理后台走 `yudao-ui-admin-vben/apps/web-antd`，用户端单独自研 `muse-studio`；阶段 8 索引文档未修改 | 已承接，待确认 |
|
||||
| C-006 | 阶段 7 整体 review 修复 | 已完成的产品、流程、架构、专题、前端、后端分册 | 多角度整体 review 发现 P0 跨文档冲突：MetaSchema logical owner 与物理落表混淆、Agent/Tool Grant/Runtime Permission 可被 AI runtime 自授权、Market handoff/precheck 抢目标 owner、Parse Job owner 冲突、动态字段泛写入口绕过事实 owner、SourceStatus/SourceEventType/Action Policy 命名不统一、Accept/Merge 缺 Candidate Decision Envelope 硬闸门、作品资产被提前写成可模板化/参考/进 AI 上下文 | 用户明确要求拆分独立任务并用子代理修复，因此本次作为 P0 一致性修复例外，打开受影响 owner 文档定点修复；阶段 8 索引仍未修改 | 已修复，待复核 |
|
||||
| C-005 | 阶段 7 准备 | 旧 `前端-*` / `后端-*` 与当前 Muse 工程口径 | 旧前端文档把管理员后台和用户端都写成 Next.js 同一前端；旧后端文档按 `muse-*` 自研模块化单体描述，未承接 Yudao Cloud fork、Vben Admin 管理后台和独立 `muse-studio` 用户端的工程基线 | 阶段 7 已按新工程口径重写前后端架构：后端以 `muse-cloud/` fork 为底座，管理后台走 `muse-admin/`，用户端单独自研 `muse-studio/`；阶段 8 已补四仓工程架构索引 | 已承接，待确认 |
|
||||
| C-006 | 阶段 7 整体 review 修复 | 已完成的产品、流程、架构、专题、前端、后端分册 | 多角度整体 review 发现 P0 跨文档冲突：MetaSchema logical owner 与物理落表混淆、Agent/Tool Grant/Runtime Permission 可被 AI runtime 自授权、Market handoff/precheck 抢目标 owner、Parse Job owner 冲突、动态字段泛写入口绕过事实 owner、SourceStatus/SourceEventType/Action Policy 命名不统一、Accept/Merge 缺 Candidate Decision Envelope 硬闸门、作品资产被提前写成可模板化/参考/进 AI 上下文 | 用户明确要求拆分独立任务并用子代理修复，因此本次作为 P0 一致性修复例外，打开受影响 owner 文档定点修复；阶段 8 已开始补索引，当前先补四仓工程架构 | 已修复，待复核 |
|
||||
|
||||
## 6. 决策记录
|
||||
|
||||
@ -148,10 +148,11 @@
|
||||
| D-039 | 2026-05-23 | 阶段 6 review | 子代理严格 review 发现阶段 6 专题仍有 P0/P1 闭合缺口：Accept 对 revoked/recalled/blocked/owner_missing 等正文来源未硬阻断；市场作品资产 feature gate 和 `workAssetUsePrecheckId` 缺失；离线质量评估缺私有内容边界；接口样例过细、幂等不足、`contentOverride` 可能洗白来源；AI 编排和质量门控的候选状态、风险合并、New-API 脱敏、Source Status Event 传播和 Writing Health owner 需要统一 | 进入阶段 6 定点修复；仍只改 `专题-01/02/03/04` 和本计划，不修改产品、流程、架构、前端或后端文档 |
|
||||
| D-040 | 2026-05-23 | 阶段 6 review 修复 | 按 review 结果修复专题文档：`专题-01` 收回到决策命令语义合同，补幂等、接受前置条件、作品资产预检、正文来源硬阻断、修改后合并 lineage 继承和失败矩阵；`专题-03` 补 Provisional Shadow Candidate、Tool Grant、Authorization Snapshot、检索结果合同、Candidate Decision Envelope、质量状态、New-API 脱敏和来源传播矩阵；`专题-04` 拆硬阻断/叙事关键/非关键维度，补决策优先级、离线评估私有内容边界、线上质量观测和下游承接；`专题-02` 去除旧实现态断言并改为目标取舍语言 | 阶段 6 review 修复完成，待复核确认；确认前不进入阶段 7 前端/后端文档 |
|
||||
| D-041 | 2026-05-23 | 阶段 6 -> 7 | 用户要求提交阶段 6 并进入下个阶段；`专题-01/02/03/04` 和阶段计划纳入已确认基线，阶段 7 准备处理前端/后端文档 | 阶段 7 只能承接阶段 1~6 已确认的产品、流程、架构和专题结论；索引与内容映射仍属于阶段 8，不在阶段 7 顺手修改 |
|
||||
| D-042 | 2026-05-23 | 阶段 7 工程基线 | 阶段 7 前后端工程口径调整为：后端使用 `YunaiV/yudao-cloud` fork，当前仓库 `yudao-cloud/` 后续可命名 `muse-cloud`；管理后台使用 `yudao-ui-admin-vben/apps/web-antd`，基于 Vue 3 + Vite + Ant Design Vue + TypeScript，接口走 `/admin-api/**`；用户端单独自研 `muse-studio`，建议 Next.js / React / TypeScript，接口走 `/app-api/**` | 阶段 7 重写 `前端-*` / `后端-*` 必须以此为工程基线；保留 `system/infra/ai/member/pay/bpm/report/mp` 等 Yudao 能力口径，已裁剪 `mall/crm/erp/mes/iot` 和空壳 `yudao-cloud/yudao-ui`；`mp` 明确保留 |
|
||||
| D-043 | 2026-05-23 | 阶段 7 初稿 | 按 D-042 重写阶段 7 前后端文档：前端拆为 Vben Admin 管理后台和独立 `muse-studio` 用户端；后端拆为 Yudao 原生模块复用和 Muse `content/knowledge/ai/market/account` 业务模块；API 改为 `/admin-api/**` 与 `/app-api/**`；Schema 改为 Yudao fork 下的模块级业务 Schema，`后端-04a` 降级为旧 SQL 历史快照且禁止执行 | 阶段 7 初稿已覆盖 `前端-01/02/03`、`后端-01/02/03/04/04a/05` 和本计划；确认前不进入阶段 8，不修改 `00-文档大纲.md` 与 `内容映射表.md` |
|
||||
| D-042 | 2026-05-23 | 阶段 7 工程基线 | 阶段 7 前后端工程口径调整为：后端主仓为 `muse-cloud/`，fork `YunaiV/yudao-cloud`；管理后台为 `muse-admin/`，fork `yudao-ui-admin-vben` 并使用 `apps/web-antd`，基于 Vue 3 + Vite + Ant Design Vue + TypeScript，接口走 `/admin-api/**`；用户端单独自研 `muse-studio/`，建议 Next.js / React / TypeScript，接口走 `/app-api/**`；设计文档后续可独立为 `muse-design-docs/` | 阶段 7 重写 `前端-*` / `后端-*` 必须以此为工程基线；保留 `system/infra/ai/member/pay/bpm/report/mp` 等 Yudao 能力口径，已裁剪 `mall/crm/erp/mes/iot` 和空壳 `yudao-ui`；`mp` 明确保留 |
|
||||
| D-043 | 2026-05-23 | 阶段 7 初稿 | 按 D-042 重写阶段 7 前后端文档：前端拆为 `muse-admin/` 管理后台和独立 `muse-studio/` 用户端；后端主仓 `muse-cloud/` 拆为 Yudao 原生模块复用和 Muse `content/knowledge/ai/market/account` 业务模块；API 改为 `/admin-api/**` 与 `/app-api/**`；Schema 改为 Yudao fork 下的模块级业务 Schema，`后端-04a` 降级为旧 SQL 历史快照且禁止执行 | 阶段 7 初稿已覆盖 `前端-01/02/03`、`后端-01/02/03/04/04a/05` 和本计划；确认前不进入阶段 8，不修改 `00-文档大纲.md` 与 `内容映射表.md` |
|
||||
| D-044 | 2026-05-23 | 阶段 7 review 修复 | 用户确认阶段 7 可拆分给 worker 并行修订；review 发现的 New-API owner、管理员私有内容边界、MetaSchema 投影兼容、planning owner API、用户知识库工作台依赖、Source/Authorization owner、保护节点注册表、handoff owner、Schema/API 缺口已按分册修复 | 阶段 7 review 修复已完成，待主代理复核和用户确认；阶段 8 索引与内容映射继续保持未修改，确认前不进入阶段 8 |
|
||||
| D-045 | 2026-05-24 | 阶段 7 整体一致性修复 | 用户要求对整体设计文档中“不对、不一致、不闭环”的内容拆成独立可修复任务并用子代理修复；本轮按架构 owner、后端 Schema/API、产品/原型、流程/专题、前端分册并行修复，并由主代理补齐残留：作品资产当前只允许阅读/收藏/授权记录；MetaSchema 逻辑 owner 固定为 Admin/Governance；Agent/Tool Grant/Runtime Permission 不能由 AI runtime 自授权；Market 只发起来源侧 handoff，目标 owner 自己创建和消费 precheck；Parse Job / Chapter Parse Result 归 AI Orchestration；动态字段无跨 owner 泛写接口；Accept/Merge 必须消费或重算 Candidate Decision Envelope；SourceStatus / SourceEventType / SourceActionPolicy 统一包含 delisted/read_only 语义 | 受影响的产品、流程、架构、专题、前端、后端文档已定点修复；阶段 8 索引和内容映射仍未开始；本轮修复待复核确认后再进入下一阶段 |
|
||||
| D-045 | 2026-05-24 | 阶段 7 整体一致性修复 | 用户要求对整体设计文档中“不对、不一致、不闭环”的内容拆成独立可修复任务并用子代理修复；本轮按架构 owner、后端 Schema/API、产品/原型、流程/专题、前端分册并行修复，并由主代理补齐残留：作品资产当前只允许阅读/收藏/授权记录；MetaSchema 逻辑 owner 固定为 Admin/Governance；Agent/Tool Grant/Runtime Permission 不能由 AI runtime 自授权；Market 只发起来源侧 handoff，目标 owner 自己创建和消费 precheck；Parse Job / Chapter Parse Result 归 AI Orchestration；动态字段无跨 owner 泛写接口；Accept/Merge 必须消费或重算 Candidate Decision Envelope；SourceStatus / SourceEventType / SourceActionPolicy 统一包含 delisted/read_only 语义 | 受影响的产品、流程、架构、专题、前端、后端文档已定点修复；阶段 8 在 D-046 开始补索引；本轮修复待复核确认后再进入更完整的阶段 8 清理 |
|
||||
| D-046 | 2026-05-24 | 阶段 8 工程仓库索引 | 用户确认开始补齐四仓工程架构索引；本次将 `muse-cloud/`、`muse-admin/`、`muse-studio/`、`muse-design-docs/` 写入 `00-文档大纲.md` 和 `内容映射表.md`，并同步 `前端-01`、`后端-02` 的仓库命名映射 | 阶段 8 仅刷新工程仓库索引和 owner 映射，不改产品功能边界、Schema、API 或状态机 |
|
||||
|
||||
## 7. 阶段交付格式
|
||||
|
||||
@ -166,8 +167,8 @@
|
||||
|
||||
## 8. 当前下一步
|
||||
|
||||
当前处于阶段 7 整体一致性修复完成、待复核确认：本轮已根据整体 review 修复产品、流程、架构、专题、前端和后端分册中的 P0 owner、事实写入、来源状态、作品资产 gate、handoff/precheck、动态字段、Accept/Merge 和 Parse owner 冲突；确认前仍不能视为阶段 7 已最终收口。
|
||||
当前处于阶段 8 工程仓库索引补齐：阶段 7 整体一致性修复已完成但仍待复核确认；本轮先把四仓工程架构写入入口索引和映射表，并同步前后端工程文档的目标仓库命名。
|
||||
|
||||
下一步是统一复核：P0 是否已清空，Yudao 原生模块复用边界、`account` 与 `member` 的后续物理落地决策、Schema 与 API 的 owner 闭合、Vben Admin 与 `muse-studio` 的入口边界、MetaSchema 与 Source/Authorization 横切模型落点、`后端-04a` 降级为历史 SQL 快照后是否需要在后续实现阶段重新生成模块 migration，以及阶段 8 的索引/映射文档是否需要统一刷新。
|
||||
下一步是统一复核：P0 是否已清空，Yudao 原生模块复用边界、`account` 与 `member` 的后续物理落地决策、Schema 与 API 的 owner 闭合、`muse-admin/` 与 `muse-studio/` 的入口边界、MetaSchema 与 Source/Authorization 横切模型落点、`后端-04a` 降级为历史 SQL 快照后是否需要在后续实现阶段重新生成模块 migration，以及阶段 8 的索引/映射文档是否还有其他过期引用需要清理。
|
||||
|
||||
阶段 8 的 `00-文档大纲.md` 与 `内容映射表.md` 仍作为最后统一索引阶段，不在阶段 7 顺手修改。
|
||||
阶段 8 已开始处理 `00-文档大纲.md` 与 `内容映射表.md`。本次只补四仓工程架构和仓库 owner 映射；其他索引、过期引用和内容映射清理仍需后续复核。
|
||||
|
||||
@ -1,7 +1,7 @@
|
||||
# 内容映射表（New-Design(新设计) V2）
|
||||
|
||||
- 版本：v5
|
||||
- 更新日期：2026-05-19
|
||||
- 版本：v6
|
||||
- 更新日期：2026-05-24
|
||||
- 目标读者：文档维护者/架构/前端/后端/产品
|
||||
- 阅读时间：10–15 分钟
|
||||
- 边界说明：本文件只做“内容归属与迁移策略”定义，不承载业务/架构细节；细节必须落到对应 V2 文档里，避免重复。
|
||||
@ -48,6 +48,17 @@
|
||||
- `doc/dev/01-总体路线图与阶段依赖.md`
|
||||
- `doc/dev/02-S0-基础设施补齐.md` 到 `doc/dev/09-验收口径与退出条件.md`
|
||||
|
||||
## 工程仓库归属
|
||||
|
||||
本节只定义仓库级归属，不替代各分册的产品、架构、Schema、API 或状态机定义。
|
||||
|
||||
| 仓库 | 内容归属 | 对应主文档 | 迁移 / 落地策略 |
|
||||
|---|---|---|---|
|
||||
| `muse-cloud/` | 后端主仓；fork `YunaiV/yudao-cloud`，承接 Yudao 平台能力和 Muse 业务模块 | `后端-01` / `后端-02` / `后端-03` / `后端-04` / `后端-05` | 以 `后端-02` 的模块 owner 和 `后端-05` 的 API 前缀为落地边界；旧 SQL 只能作为历史快照 |
|
||||
| `muse-admin/` | 管理端；fork `yudao-ui-admin-vben`，承接管理员控制台 | `产品-02B` / `流程-01A` / `流程-02A` / `前端-01` / `后端-05` | 只调用 `/admin-api/**`；复用 Vben 的菜单、权限、表格和表单体系，不复用用户端写作工作台 |
|
||||
| `muse-studio/` | 自研用户端；推荐 Next.js / React / TypeScript | `产品-02C` / `产品-02D` / `产品-02E` / `产品-02F` / `产品-02G` / `前端-01` / `前端-02` / `前端-03` | 只调用 `/app-api/**`；承载普通用户创作、资产、市场和个人中心，不复用 Vben 后台 layout |
|
||||
| `muse-design-docs/` | 当前 `design-docs/` 独立化后的产品与架构 SSOT | `00-文档大纲` / `内容映射表` / `临时-产品形态阶段化重设计计划` / 各正式分册 | 继续按阶段和 owner 管理设计；实现仓必须对齐这里的正式 owner，不用临时文档反向覆盖正式分册 |
|
||||
|
||||
## 新产品形态内容归属（正式文档）
|
||||
|
||||
说明：
|
||||
|
||||
@ -10,10 +10,10 @@
|
||||
|
||||
Muse 前端拆为两个项目，不能再用一套 Next.js 应用同时承载管理后台和用户端。
|
||||
|
||||
| 前端项目 | 定位 | 技术栈 | 接口前缀 |
|
||||
|---|---|---|---|
|
||||
| `yudao-ui-admin-vben/apps/web-antd` | 管理后台(Admin Console) | Vue 3 + Vite + Ant Design Vue + TypeScript | `/admin-api/**` |
|
||||
| `muse-studio` | 用户端创作产品(User Workspace / Agent Workspace / Knowledge Workspace / Marketplace / Personal Center) | 建议 Next.js / React / TypeScript | `/app-api/**` |
|
||||
| 目标仓库 | 来源 / 形态 | 定位 | 技术栈 | 接口前缀 |
|
||||
|---|---|---|---|---|
|
||||
| `muse-admin/` | fork `yudao-ui-admin-vben`，主应用路径 `apps/web-antd` | 管理后台(Admin Console) | Vue 3 + Vite + Ant Design Vue + TypeScript | `/admin-api/**` |
|
||||
| `muse-studio/` | 自研用户端 | 用户端创作产品(User Workspace / Agent Workspace / Knowledge Workspace / Marketplace / Personal Center) | 建议 Next.js / React / TypeScript | `/app-api/**` |
|
||||
|
||||
核心原则：
|
||||
|
||||
@ -37,7 +37,7 @@ Muse 前端拆为两个项目，不能再用一套 Next.js 应用同时承载管
|
||||
管理后台使用：
|
||||
|
||||
```text
|
||||
yudao-ui-admin-vben/
|
||||
muse-admin/ # fork yudao-ui-admin-vben
|
||||
apps/web-antd/
|
||||
```
|
||||
|
||||
@ -97,7 +97,7 @@ Vben Admin 的页面入口由后台菜单和权限点驱动。Muse 后续新增
|
||||
|
||||
## 3. 用户端：muse-studio
|
||||
|
||||
`muse-studio` 是普通用户使用的创作产品，不走 Vben。
|
||||
`muse-studio/` 是普通用户使用的创作产品，不走 Vben。
|
||||
|
||||
建议技术栈：
|
||||
|
||||
|
||||
@ -14,8 +14,8 @@
|
||||
|
||||
| 前端 | 使用者 | 目标 |
|
||||
|---|---|---|
|
||||
| `yudao-ui-admin-vben/apps/web-antd` | 管理员 | 配置 MetaSchema、字段、可见性、AI 上下文、导出、校验和版本 |
|
||||
| `muse-studio` | 普通用户 | 填写作品设定、章节大纲、世界设定、角色关系、文风检查和知识表单 |
|
||||
| `muse-admin/` | 管理员 | 配置 MetaSchema、字段、可见性、AI 上下文、导出、校验和版本 |
|
||||
| `muse-studio/` | 普通用户 | 填写作品设定、章节大纲、世界设定、角色关系、文风检查和知识表单 |
|
||||
|
||||
两端可以共享接口类型和字段渲染约定，但不能共享错误的用户语言。管理员可以看到系统术语，普通用户默认只看到创作语言。
|
||||
|
||||
|
||||
@ -8,10 +8,10 @@
|
||||
|
||||
## 1. 工程基线
|
||||
|
||||
Muse 后端使用 `YunaiV/yudao-cloud` 的 fork，当前仓库命名为：
|
||||
Muse 后端使用 `YunaiV/yudao-cloud` 的 fork，目标仓库命名为：
|
||||
|
||||
```text
|
||||
yudao-cloud/ # 后续可命名为 muse-cloud
|
||||
muse-cloud/ # fork YunaiV/yudao-cloud
|
||||
```
|
||||
|
||||
定位：Yudao Cloud 做后端微服务/单体聚合底座，先继承它的网关、权限、基础设施、配置、日志、文件、任务等平台能力，再补 Muse 自己的业务模块。
|
||||
|
||||
@ -1,7 +1,7 @@
|
||||
# 后端-05：统一 API(接口) 契约-v1
|
||||
|
||||
- 版本：v6
|
||||
- 更新日期：2026-05-23
|
||||
- 更新日期：2026-05-24
|
||||
- 目标读者：前端 / 后端 / 架构 / 测试
|
||||
- 阅读时间：35-55 分钟
|
||||
- 边界说明：本文件只定义 Muse 在 Yudao Cloud fork 上的 API 分组、资源语义、关键命令、错误模型与异步交互。底层表结构看 `后端-04`，状态机看 `架构-04`，关键流程看 `后端-03`。
|
||||
@ -12,8 +12,8 @@
|
||||
|
||||
| 入口 | 调用方 | 语义 |
|
||||
|---|---|---|
|
||||
| `/admin-api/**` | `yudao-ui-admin-vben/apps/web-antd` | 管理后台接口 |
|
||||
| `/app-api/**` | `muse-studio` | 普通用户端接口 |
|
||||
| `/admin-api/**` | `muse-admin/` | 管理后台接口 |
|
||||
| `/app-api/**` | `muse-studio/` | 普通用户端接口 |
|
||||
|
||||
Yudao 原生 `system/infra/member/pay/bpm/report/mp` 接口按 Yudao 约定保留，本文件不重复定义其全部内置接口。本文只定义 Muse 新增或二开的业务接口。
|
||||
|
||||
|
||||
Loading…
x
Reference in New Issue
Block a user