Web_Template_Vue3_Dev/AI-Coding/01-Directory-Map.md

01. 仓库地图（Directory Map）

目标：让 AI 快速定位“要复用的能力”在哪个目录、入口是什么、依赖闭包有哪些。

src/（应用主代码）

• src/main.ts：应用入口；决定 mock/pwa 与各子系统初始化顺序
• src/App.vue：根组件；包含生产环境禁调试逻辑（disable-devtool）
• src/router/：路由与权限控制（重点：index.ts、permissions）
• src/store/：Pinia 初始化与业务 store 模块
• src/i18n/：国际化初始化、语言获取与翻译辅助
• src/api/：按域拆分 API 调用函数（示例：src/api/router.ts）
• src/utils/：通用工具与基础能力（时间格式化、树结构转换、UUID 等）
• src/views/：业务页面集合（通常与路由对应）
• src/icon/：图标加载（由 library/index.ts 里的 import '@/icon' 引入）
• src/config/：运行时/构建期配置聚合导出（vue.config.js 会 require('./src/config')）

library/（模板基础库）

• library/index.ts：setupVab(app) 的实现：
  • 全局样式：library/styles/vab.scss
  • 图标注册：vab-icons + @element-plus/icons-vue
  • 背景样式：library/styles/background/*.scss
  • 插件加载：library/plugins/**/*.ts 并 app.use()
• library/build/：构建期扩展（webpack chain、vue plugins）

library/plugins/（全局插件）

• vab.ts：全局注入（gp）与事件总线（$pub/$sub/$unsub）
• directive.ts：指令（v-permissions）
• errorLog.ts：全局错误捕获（app.config.errorHandler）
• support.ts：构建信息输出/依赖检查

library/components/（可复用 UI 组件库）

• Vab* 前缀：约定为基础组件/布局子组件（菜单、tabs、header、breadcrumb 等）
• VabTheme：主题系统入口（主题抽屉/设置面板），依赖 $pub/$sub 与 settings store

library/layouts/（布局体系）

• library/layouts/index.vue：主 Layout 入口（路由壳）
• library/layouts/VabLayout*：多套布局可选（垂直/横向/综合/浮动/分栏等）

mock/（开发期 Mock）

• mock/index.js：devServer 中间件；读取并注册 mock/controller/*
• mock/controller/*.js：每个文件导出路由数组（url/type/response）

types/（类型声明）

• types/*.d.ts：路由/store/theme/vab 等声明，配合 /# 别名使用