---
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