Files
FastapiAdmin/frontend/app/.agent/rules/tech-stack.md
T
zhangtao 5c29d22aa5 feat: 初始化前端项目基础结构
- 添加项目配置文件(tsconfig, eslint, prettier等)
- 实现基础路由和页面布局
- 添加全局状态管理和API请求封装
- 集成UI组件库和主题系统
- 添加文档网站和示例页面
- 配置CI/CD和工作流
2026-05-01 00:47:48 +08:00

1.4 KiB

description, globs, alwaysApply
description globs alwaysApply
核心技术栈、架构和代码规范 src/store/**/*, src/api/**/*, src/router/**/*, src/pages/**/*, pages.config.ts, alova.config.ts false

技术栈与架构

🏗️ 架构概览

本项目采用分层架构:

  • 表现层: src/pages (视图) + src/components (UI 逻辑)
  • 状态层: src/store (Pinia)
  • 数据层: src/api (Alova.js)

📦 状态管理 (Pinia)

  • : Pinia
  • 持久化: 使用 src/store/persist.ts 进行本地存储。
  • 模式: 详见 pinia-store-generator skill。
  • 规则: 始终使用 defineStore 并遵循 use{Name}Store 的命名规范。
  • Skill: 使用 pinia-store-generator 快速创建新的 store。

🌐 API 层 (Alova.js)

  • : Alova.js
  • 结构:
    • src/api/core: 拦截器和实例配置。
    • src/api/apiDefinitions.ts: 自动生成的 API 定义。
  • Mock: 支持在 src/api/mock 中编写 Mock 数据。
  • Skill: 使用 alova-api-module 创建新的 API 模块和 Mock 数据。

🛣️ 路由

  • : @wot-ui/router (API) + vite-plugin-uni-pages (文件系统路由)
  • 配置: pages.config.ts 控制 pages.json 的生成。
  • 导航: 使用 useRouter() 进行 push/replace/back 操作。
  • Skill: 参考 wot-router-usage 了解导航模式和守卫用法。
  • Skill: 使用 uni-page-generator 创建带路由配置的新页面。