admin_web/apps/web-antd/.github/copilot-instructions.md

Project Guidelines

技术栈

• Vue 3 + TypeScript + Ant Design Vue + vxe-table 4.x + Vben Admin 5.x
• Pinia (setup store) + Vue Router 4 + Vite + pnpm monorepo
• 路径别名 #/* → ./src/*，不使用 @/

代码风格

• 所有组件使用 <script setup lang="ts">，禁止 Options API
• 类型导入使用 import type
• API 文件使用 namespace 模式定义请求/响应类型，函数名以 Api 结尾（如 getListApi）
• Store 使用 defineStore + setup 函数风格，命名 use[Feature]Store
• UI 文本使用中文

项目结构

src/api/core/       → API 接口（按资源分文件）
src/model/          → TypeScript 类型定义
src/store/          → Pinia Store
src/router/routes/  → 路由（core + modules/ 动态加载）
src/views/          → 页面（按功能模块分目录）
src/adapter/        → VxeTable / Form 适配器
src/component/      → 可复用业务组件

构建与运行

pnpm dev          # 启动开发服务器
pnpm build:antd   # 生产构建
pnpm typecheck    # TypeScript 类型检查

约定

• 新增页面流程：API → Model → Store（可选）→ Route → View
• 表格使用 useVbenVxeGrid，表单使用 useVbenForm，弹窗使用 useVbenModal
• API 代理：/api → http://localhost:5320/api
• 路由模块放在 src/router/routes/modules/，使用 import.meta.glob 自动加载