# 部署文档

本目录包含摄影作品集项目的部署相关文档。

## 目录结构

- `caddy-setup.md` - Caddy Web 服务器配置指南
- `Caddyfile` - Caddy 配置文件
- `fix-caddy-permissions.sh` - Caddy 权限修复脚本
- `environments.md` - 环境配置说明（计划中）
- `vercel-deployment.md` - Vercel 部署指南（计划中）
- `docker-deployment.md` - Docker 部署指南（计划中）
- `ci-cd.md` - CI/CD 配置说明（计划中）
- `monitoring.md` - 监控和日志配置（计划中）
- `backup.md` - 备份策略（计划中）

## 部署准备

在部署前，请确保完成以下步骤：

1. 代码检查: `make lint`
2. 类型检查: `make type-check`
3. 构建测试: `make build`
4. 完整部署准备: `make deploy-prep`

## 环境变量

确保在部署环境中配置以下环境变量：

```bash
NEXT_PUBLIC_API_URL=your-api-url
```

## 当前部署方案

### Caddy + Static Files
- **前端**: 静态文件部署到 `~/www/photography/`
- **Web 服务器**: Caddy (自动 HTTPS)
- **域名**: https://photography.iriver.top
- **CI/CD**: Gitea Actions 自动部署

### 快速部署命令
```bash
# 1. 推送代码触发自动部署
git push origin main

# 2. 配置 Web 服务器（仅首次）
scp docs/deployment/Caddyfile user@server:/etc/caddy/Caddyfile
scp docs/deployment/fix-caddy-permissions.sh user@server:~/
ssh user@server './fix-caddy-permissions.sh && sudo systemctl reload caddy'
```

## 支持的部署平台

- ✅ **Caddy + Static Files** (当前使用)
- 📋 Vercel (计划中)
- 📋 Netlify (计划中)
- 📋 Docker (计划中)