项目代码结构总览
本项目采用了 Monorepo 架构,主要分为 apps、packages、internal、scripts 等多个目录,便于前后端、工具库、配置等模块化管理。
目录结构树
text
.
├── apps # 应用层,包含前端与后端 mock 服务
│ ├── web-antd # 前端主应用(Vue3 + Ant Design)
│ │ └── src # 前端源码目录
│ │ ├── views # 页面视图模块
│ │ ├── store # 状态管理
│ │ ├── router # 路由配置
│ │ ├── api # 前端接口封装
│ │ ├── layouts # 页面布局
│ │ ├── locales # 多语言
│ │ └── ...
│ └── backend-mock # 后端 mock 服务(API 模拟)
│ ├── api # mock API 目录
│ ├── routes # 路由定义
│ ├── utils # 工具函数
│ └── ...
├── packages # 业务与工具包,复用性强
│ ├── @core # 核心包(如 UI 组件、基础库等)
│ ├── constants # 常量定义
│ ├── effects # 副作用相关
│ ├── icons # 图标库
│ ├── locales # 多语言包
│ ├── preferences # 偏好设置
│ ├── stores # 状态管理
│ ├── styles # 样式包
│ ├── types # 类型定义
│ └── utils # 工具函数
├── internal # 内部配置与工具
│ ├── lint-configs # 代码规范相关配置
│ ├── node-utils # Node 工具
│ ├── tailwind-config # TailwindCSS 配置
│ ├── tsconfig # TS 配置
│ └── vite-config # Vite 配置
├── playground # 实验/测试用例
├── scripts # 自动化脚本
├── README.md # 项目说明
└── ... # 其他配置文件主要目录说明
- apps/:存放实际运行的应用(如前端、后端 mock),每个子目录为一个独立应用。
- packages/:存放可复用的业务包、工具包、类型、样式、图标等,便于多项目共享。
- internal/:存放内部使用的配置、工具、规范等,不直接对外暴露。
- playground/:用于新特性、组件、功能的实验和测试。
- scripts/:自动化脚本,如构建、部署、清理等。
- README.md:项目说明文档。
典型前端应用结构(apps/web-antd/src)
text
src
├── api # 接口封装
├── adapter # 适配器
├── layouts # 页面布局
├── locales # 多语言
├── router # 路由
├── store # 状态管理
├── views # 页面视图
└── ...- views/:按业务模块划分页面,如 dashboard、system、auth、lowcode 等。
- api/:接口请求与数据交互。
- store/:Pinia/Vuex 状态管理。
- router/:路由配置。
- locales/:本地化多语言。
- layouts/:页面布局组件。
如需详细了解每个子模块,请查阅对应目录下的 README 或源码注释。
