48 lines
1.4 KiB
Markdown
48 lines
1.4 KiB
Markdown
---
|
||
name: cross-app-skeleton
|
||
description: 站点脚手架规范,项目结构/目录组织/模块划分
|
||
globs:
|
||
- "**/*.php"
|
||
- "**/*.ts"
|
||
---
|
||
|
||
## 项目结构
|
||
|
||
```
|
||
madong/
|
||
├── backend/ # PHP Webman 后端
|
||
│ ├── app/ # 应用代码
|
||
│ │ ├── adminapi/ # 管理后台 API
|
||
│ │ ├── api/ # 前台 API
|
||
│ │ ├── model/ # 模型
|
||
│ │ ├── dao/ # 数据访问
|
||
│ │ ├── service/ # 服务层
|
||
│ │ ├── enum/ # 枚举
|
||
│ │ └── command/ # 命令
|
||
│ ├── core/ # 核心基础设施
|
||
│ ├── config/ # 配置
|
||
│ ├── plugin/ # 插件
|
||
│ └── packages/ # 本地包
|
||
├── frontend/
|
||
│ ├── admin/ # 管理后台 (Vue 3 + Element Plus)
|
||
│ └── web/ # 前台网站 (Nuxt 4)
|
||
└── doc/ # 文档
|
||
```
|
||
|
||
## 模块分层
|
||
|
||
| 层级 | 目录 | 依赖 |
|
||
|------|------|------|
|
||
| Controller | `{app}/controller/` | Service |
|
||
| Validate | `{app}/validate/` | - |
|
||
| Service | `{app}/service/` | DAO |
|
||
| DAO | `{app}/dao/` | Model |
|
||
| Model | `{app}/model/` | - |
|
||
| Schema | `{app}/schema/` | - |
|
||
|
||
## 检查清单
|
||
|
||
- [ ] 目录结构是否符合项目规范
|
||
- [ ] 模块分层是否正确
|
||
- [ ] 依赖方向是否单向(Controller→Service→DAO→Model)
|