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 工作时只需关注单个模块的文档,大幅提升处理效率!
摄影作品集前端项目
这是一个基于Next.js 15的现代化摄影作品集网站,支持动态数据获取和响应式设计。
技术栈
- Next.js 15 - React框架
- React 19 - 用户界面库
- TypeScript - 类型安全
- Tailwind CSS - 样式框架
- shadcn/ui - UI组件库
- TanStack Query - 数据获取和缓存
- Axios - HTTP客户端
功能特性
- 🖼️ 照片画廊展示
- 📅 时间线视图
- 🔍 分类筛选
- 🎨 响应式设计
- 🌙 主题切换支持
- 📱 移动端优化
- 🔄 数据缓存和同步
- 🎯 TypeScript类型安全
开发环境设置
- 安装依赖:
npm install
-
配置环境变量: 复制
.env.local文件并设置API地址 -
启动开发服务器:
npm run dev
- 构建生产版本:
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