Fantastic-admin 是一个基于 Vue 3 的后台管理框架。
- 框架: Vue 3.6 + TypeScript + Vite 8
- UI 组件: Element Plus（默认，可替换） + Reka UI + UnoCSS（原子化 CSS）
- 状态管理: Pinia + pinia-plugin-persistedstate
- 路由: Vue Router 5
- 包管理器: pnpm（必须使用 pnpm，禁止使用 npm/yarn）
- HTTP: Axios
- Mock: vite-plugin-fake-server
采用 pnpm monorepo 架构：
├── apps/
│ └── <app>/ # 应用
│ └── src/
│ ├── api/ # API 请求模块
│ ├── assets/ # 静态资源
│ ├── components/ # 全局业务组件
│ ├── composables/ # 组合式函数
│ ├── layouts/ # 布局组件
│ ├── router/ # 路由配置
│ ├── slots/ # 插槽组件
│ ├── store/ # Pinia store
│ ├── types/ # TypeScript 类型定义
│ ├── ui/ # 框架内建 UI 组件（本地）
│ ├── utils/ # 工具函数
│ └── views/ # 页面视图
├── packages/
│ ├── components/ # 框架内建 UI 组件库（子包，跨应用共享）
│ ├── settings/ # 框架设置（子包，跨应用共享）
│ └── themes/ # 主题配置（子包，跨应用共享）
├── scripts/ # 工程脚本
└── pnpm-workspace.yaml # monorepo workspace 配置
pnpm dev # 启动开发服务器
pnpm build # 构建
pnpm lint # 运行全量 lint（tsc + eslint + stylelint）- 使用
<script setup lang="ts">语法 - 样式优先使用 UnoCSS 原子类，复杂样式用 SCSS
- 组件命名使用 PascalCase，文件名与组件名一致
- API 模块放在
apps/<app>/src/api/modules/，按业务模块拆分 - Store 模块放在
apps/<app>/src/store/modules/，使用 Pinia composition API 风格 - 路由配置在
apps/<app>/src/router/，meta 属性可借助 fa-route-generator skill
- 框架内建组件在
packages/components/子包中，优先使用内建组件而非第三方组件或自定义实现 - 在任何情况下都请勿直接修改内建组件，确定修改前需要和用户进行确认
- Mock 数据使用
vite-plugin-fake-server，文件放在apps/<app>/src/api/modules/对应模块旁 - 代码提交前会自动运行 lint-staged，确保代码符合规范
- Node.js 版本要求以根目录下
package.json中定义的为准
在使用任何 fa-* 系列技能时，如果用户针对同一功能点已经要求修改 3 次及以上仍未达到预期（例如连续说"不对"、"再改改"、"还是不行"），必须触发 fa-feedback 技能，询问用户是否将问题反馈给框架作者。