All checks were successful
Deploy Frontend / deploy (push) Successful in 2m38s
## 📁 模块化重构 ### 新增模块 CLAUDE.md - `frontend/CLAUDE.md` - 前端开发指导 (Next.js, React, TypeScript) - `docs/deployment/CLAUDE.md` - 部署配置指导 (Caddy, 服务器配置) - `.gitea/workflows/CLAUDE.md` - CI/CD 流程指导 (Gitea Actions) ### 根目录 CLAUDE.md 优化 - 重构为项目概览和模块导航 - 提供模块选择指导 - 减少单个文件的上下文长度 ### 自动化机制 - 创建 `scripts/update-claude-docs.sh` 自动更新脚本 - 集成到 pre-commit hooks 中 - 文件变更时自动更新对应模块的 CLAUDE.md ## 🎯 优化效果 ### 上下文优化 - 每个模块独立的 CLAUDE.md 文件 - 大幅减少单次处理的上下文长度 - 提高 Claude 处理效率和准确性 ### 开发体验 - 根据工作内容选择对应模块 - 模块化的文档更聚焦和专业 - 自动维护文档时间戳 ### 项目结构 ``` photography/ ├── CLAUDE.md # 项目概览和模块导航 ├── frontend/CLAUDE.md # 前端开发指导 ├── docs/deployment/CLAUDE.md # 部署配置指导 ├── .gitea/workflows/CLAUDE.md # CI/CD 流程指导 └── scripts/update-claude-docs.sh # 自动更新脚本 ``` 现在 Claude 工作时只需关注单个模块的文档,大幅提升处理效率!
部署文档
本目录包含摄影作品集项目的部署相关文档。
目录结构
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- 备份策略(计划中)
部署准备
在部署前,请确保完成以下步骤:
- 代码检查:
make lint - 类型检查:
make type-check - 构建测试:
make build - 完整部署准备:
make deploy-prep
环境变量
确保在部署环境中配置以下环境变量:
NEXT_PUBLIC_API_URL=your-api-url
当前部署方案
Caddy + Static Files
- 前端: 静态文件部署到
~/www/photography/ - Web 服务器: Caddy (自动 HTTPS)
- 域名: https://photography.iriver.top
- CI/CD: Gitea Actions 自动部署
快速部署命令
# 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 (计划中)