Files
xujiang 9e381c783d
All checks were successful
Deploy Frontend / deploy (push) Successful in 2m38s
feat: 重构项目为模块化结构,拆分 CLAUDE.md 文档
## 📁 模块化重构

### 新增模块 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 工作时只需关注单个模块的文档,大幅提升处理效率!
2025-07-09 10:54:08 +08:00
..

部署文档

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

目录结构

  • 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

环境变量

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

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 (计划中)