MuseMVP

通过 config.ui.saas.layoutType 与 src/modules/layout 实现切换和扩展后台应用布局。

MuseMVP 在登录后的 SaaS 区域（/app/*）支持多种应用布局。布局选择由 config.ui.saas.layoutType 驱动。

布局入口

布局分发发生在：

该文件读取 config.ui.saas.layoutType，并映射到 src/modules/layout/* 下对应布局组件。映射表中不存在的值会静默回退到 default。

`layoutType` 值	组件	文件
`default`	`AppDefaultLayout`	`src/modules/layout/default/index.tsx`
`sidebar`	向后兼容别名，等价于 `default`	在 `src/app/(saas-page)/app/(account)/layout.tsx` 中映射

当前模板只内置 default 一种布局（sidebar 为向后兼容别名）；如需其他形态，请按下文「新增一个布局变体」自行扩展。

兼容说明

sidebar 仅用于历史兼容，新项目建议直接使用 default。

在 src/config/index.ts 中修改布局类型。目前有效值为 default（及其别名 sidebar）；自定义变体（如 zen）需按下文完成注册后才能生效。

// src/config/index.ts
ui: {
  saas: {
    layoutType: "default", // 或你注册的自定义变体，例如 "zen"
  },
}

可选值由 src/config/types.ts 中的 SaasLayoutType 约束。

访问 /app、/app/settings/*、/app/admin/*，确认导航与间距符合你的产品要求。

布局	特点
`default`	使用 shadcn sidebar 基础组件（`SidebarProvider`、`Sidebar`、可折叠行为），含个人菜单下拉，属于经典后台壳层

关键文件：

如果 default 不满足你需要的壳层形态，新增布局变体是官方支持的扩展方式。

新建目录，例如 src/modules/layout/zen/index.tsx，实现接收用户信息 props 的布局组件。

在 src/app/(saas-page)/app/(account)/layout.tsx 的映射表中注册新布局。注意：未注册的 layoutType 值会静默回退到 default。

扩展 src/config/types.ts 的 SaasLayoutType，并将 config.ui.saas.layoutType 设置为新值。

保证功能一致性

新布局必须保证账号/管理路由可达，同时保留退出登录与会话失效跳转等核心行为。