Skip to content

项目代码结构总览

本项目采用了 Monorepo 架构,主要分为 appspackagesinternalscripts 等多个目录,便于前后端、工具库、配置等模块化管理。

目录结构树

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 或源码注释。