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
..
2025-07-08 23:52:09 +08:00
2025-07-08 23:52:09 +08:00
2025-07-09 09:29:33 +08:00
2025-07-08 14:06:30 +00:00
2025-07-09 09:54:37 +08:00
2025-07-09 09:27:55 +08:00

摄影作品集前端项目

这是一个基于Next.js 15的现代化摄影作品集网站支持动态数据获取和响应式设计。

技术栈

  • Next.js 15 - React框架
  • React 19 - 用户界面库
  • TypeScript - 类型安全
  • Tailwind CSS - 样式框架
  • shadcn/ui - UI组件库
  • TanStack Query - 数据获取和缓存
  • Axios - HTTP客户端

功能特性

  • 🖼️ 照片画廊展示
  • 📅 时间线视图
  • 🔍 分类筛选
  • 🎨 响应式设计
  • 🌙 主题切换支持
  • 📱 移动端优化
  • 🔄 数据缓存和同步
  • 🎯 TypeScript类型安全

开发环境设置

  1. 安装依赖:
npm install
  1. 配置环境变量: 复制 .env.local 文件并设置API地址

  2. 启动开发服务器:

npm run dev
  1. 构建生产版本:
npm run build

项目结构

frontend/
├── app/                    # Next.js应用目录
│   ├── layout.tsx         # 根布局
│   ├── page.tsx           # 主页
│   └── globals.css        # 全局样式
├── components/            # 组件目录
│   ├── providers/         # 上下文提供者
│   ├── ui/               # UI组件
│   └── ...               # 业务组件
├── lib/                  # 工具库
│   ├── api.ts            # API配置
│   ├── queries.ts        # 数据查询
│   └── utils.ts          # 工具函数
├── hooks/                # 自定义钩子
├── public/               # 静态资源
└── types/                # 类型定义

API接口

项目使用React Query进行数据管理支持以下API接口

  • GET /api/photos - 获取所有照片
  • GET /api/photos/:id - 获取单张照片
  • GET /api/categories - 获取分类列表
  • POST /api/photos - 添加照片
  • PUT /api/photos/:id - 更新照片
  • DELETE /api/photos/:id - 删除照片

开发命令

# 启动开发服务器
npm run dev

# 构建生产版本
npm run build

# 启动生产服务器
npm start

# 代码检查
npm run lint

# 类型检查
npm run type-check

部署

项目可以部署到Vercel、Netlify等平台。确保设置正确的环境变量。test change