37 lines
1.1 KiB
Plaintext
37 lines
1.1 KiB
Plaintext
---
|
||
alwaysApply: true
|
||
---
|
||
|
||
# Photography Portfolio 项目结构指南
|
||
|
||
## 🏗️ 项目架构概览
|
||
|
||
这是一个全栈摄影作品集项目，采用微服务架构：
|
||
|
||
### 后端服务 (`backend/`)
|
||
- **框架**: go-zero v1.8.0
|
||
- **主要入口**: [cmd/api/main.go](mdc:backend/cmd/api/main.go)
|
||
- **配置文件**: [etc/photography-api.yaml](mdc:backend/etc/photography-api.yaml)
|
||
- **API 定义**: [api/desc/](mdc:backend/api/desc/) 目录下的 `.api` 文件
|
||
|
||
### 前端项目
|
||
- **管理后台**: [admin/](mdc:admin/) - React + TypeScript + Vite
|
||
- **用户界面**: [frontend/](mdc:frontend/) - Next.js + TypeScript
|
||
- **UI 组件库**: [ui/](mdc:ui/) - 共享组件
|
||
|
||
### 核心目录结构
|
||
- `backend/internal/handler/` - HTTP 处理器
|
||
- `backend/internal/logic/` - 业务逻辑层
|
||
- `backend/internal/model/` - 数据模型
|
||
- `backend/pkg/` - 共享工具包
|
||
- `docs/` - 项目文档
|
||
- `scripts/` - 部署和维护脚本
|
||
|
||
## 📋 开发状态
|
||
参考 [TASK_PROGRESS.md](mdc:TASK_PROGRESS.md) 了解当前开发进度和优先级任务。
|
||
|
||
## 🔧 依赖管理
|
||
- 后端：Go modules (`go.mod`)
|
||
- 前端：pnpm (推荐) / bun
|
||
- 管理后台：bun
|