用途:为 Nuxt 4 + Vue 3 + Nuxt UI 应用提供基础架构参考,适用于启动新项目、理解项目结构或进行架构决策,核心是领域驱动、类型安全、组合式优先,并强调关注点分离。
主要能力:提供架构哲学说明(philosophy.md,含基础原则、关注点分离、各模式适用时机);项目结构说明(structure.md,含目录布局、命名约定、文件组织,面向 admin / SaaS 应用形态);营销站点结构说明(marketing-site-shape.md,说明以页面为中心的结构、不应使用的 models/repositories/features、用于客户端与服务端校验的 shared/utils/、仅客户端插件处理 DOM 效果、以及何时保持扁平结构)。
技术栈:框架为 Nuxt 4(SPA 模式,禁用 SSR);UI 为 Vue 3 Composition API;组件为 Nuxt UI v4 + Tailwind CSS 4;状态使用 ref/useState 的组合式函数;HTTP 为基于 Sanctum/ofetch 的自定义 fetch;认证为 Laravel Sanctum(nuxt-auth-sanctum);实时通信为 Laravel Echo(nuxt-laravel-echo)。
标准目录:app/ 下包含 components/(按类型分 Tables/、Forms/、Modals/)、composables/、constants/(channels.ts、events.ts、permissions.ts)、enums/(带行为的 TypeScript 枚举)、features/(领域模块,含 queries/、mutations/、actions/)、models/(领域模型类)、pages/(基于文件的路由)、repositories/(数据访问层)、types/(TypeScript 定义)、values/(值对象)。
模式流向:Component → Action → Mutation → Repository → API,Query 负责响应式数据获取;Action 编排业务逻辑,Mutation 处理纯 API 调用,Query 提供响应式数据,Repository 抽象 API 访问。
限制:资料未提供安装命令、版本兼容细节、收费或价格信息,也未给出完整代码示例;实际采用前需结合项目情况确认。