了解项目

技术栈

项目架构

MvpFast 使用 路由组 (Route Groups) 分离两套独立的布局系统：

src/app/
├── (fumadocs)/           # 文档/博客（Fumadocs UI 布局）
│   ├── docs/             # /docs/*
│   └── blog/             # /blog/*
│
├── (main)/               # 主应用（自定义布局）
│   ├── [local]/          # 国际化路由 /zh/* 和 /en/*
│   │   ├── page.tsx      # 首页 Landing Page
│   │   ├── auth/         # 登录 / 注册
│   │   ├── dashboard/    # 后台管理（RBAC 保护）
│   │   └── pay/          # 支付页面
│   └── api/              # API 路由
│       ├── admin/        # 管理员接口（需鉴权）
│       ├── user/         # 用户接口（需登录）
│       └── wx/           # 微信登录 + 微信支付

路由组名称 (fumadocs) 和 (main) 不会出现在 URL 中。

根布局

主应用的根布局位于 src/app/(main)/layout.tsx，包含以下功能：

• 国际化 SEO — 通过 next-intl 的 getTranslations 动态生成多语言 metadata
• Open Graph / Twitter Card — 自动生成社交分享信息
• JSON-LD 结构化数据 — <GlobalJsonLd /> 组件输出搜索引擎结构化数据
• 主题控制 — 强制亮色主题，通过 DaisyUI 的 data-theme 切换
• 全局 Provider — SessionProvider (认证)、ReduxProvider (状态)、ThemeProviders (主题)
• Google Analytics — 通过独立组件按需加载，不阻塞渲染

核心目录

认证与权限

系统使用 RBAC (基于角色的访问控制)，定义在 src/lib/rbac.ts：

• admin — 全部权限 (用户管理、订单、系统配置等)
• user — 基础权限 (个人信息、AI 对话、自己的订单等)

权限在三层生效：

1. 中间件层 (src/middleware.ts) — 根据路由自动拦截未授权访问
2. API 层 — requireAdmin() 或 requirePermission() 鉴权
3. 页面层 — hasPermission() 控制 UI 显示

配置管理

MvpFast 采用 代码配置 + 数据库配置 双层模式：