🚀 主要功能: - 完善后端API服务层,实现完整的CRUD操作 - 开发管理后台所有核心页面 (仪表板、照片、分类、标签、用户、设置) - 完成前后端完全集成,所有API接口正常对接 - 配置完整的CI/CD流水线,支持自动化部署 🎯 后端完善: - 实现PhotoService, CategoryService, TagService, UserService - 添加完整的API处理器和路由配置 - 支持Docker容器化部署 - 添加数据库迁移和健康检查 🎨 管理后台完成: - 仪表板: 实时统计数据展示 - 照片管理: 完整的CRUD操作,支持批量处理 - 分类管理: 树形结构展示和管理 - 标签管理: 颜色标签和统计信息 - 用户管理: 角色权限控制 - 系统设置: 多标签配置界面 - 添加pre-commit代码质量检查 🔧 部署配置: - Docker Compose完整配置 - 后端CI/CD流水线 (Docker部署) - 管理后台CI/CD流水线 (静态文件部署) - 前端CI/CD流水线优化 - 自动化脚本: 部署、备份、监控 - 完整的部署文档和运维指南 ✅ 集成完成: - 所有API接口正常连接 - 认证系统完整集成 - 数据获取和状态管理 - 错误处理和用户反馈 - 响应式设计优化
项目脚本
本目录包含项目维护和自动化脚本。
脚本说明
update-claude-docs.sh
用途: 自动更新各模块的 CLAUDE.md 文档时间戳
功能:
- 检测项目文件变更
- 自动更新相关模块的 CLAUDE.md 最后更新时间
- 验证所有 CLAUDE.md 文件完整性
使用方法:
# 手动运行
./scripts/update-claude-docs.sh
# 自动运行 (通过 pre-commit hooks)
git commit -m "update: 修改前端组件" # 自动触发
触发条件:
frontend/目录变更 → 更新frontend/CLAUDE.mddocs/deployment/目录变更 → 更新docs/deployment/CLAUDE.md.gitea/workflows/目录变更 → 更新.gitea/workflows/CLAUDE.mdCLAUDE.md变更 → 更新根目录时间戳
自动化集成
Pre-commit Hooks
脚本已集成到 pre-commit hooks 中,会在以下情况自动运行:
- 提交涉及模块文件变更时
- 自动更新时间戳并包含在本次提交中
配置文件
- lint-staged.config.js - 配置自动触发规则
- package.json - 项目脚本配置
最佳实践
开发流程
- 正常开发和修改文件
- 使用
git add添加变更 - 使用
git commit提交(自动触发脚本) - 脚本自动更新相关 CLAUDE.md 文档
- 时间戳更新会包含在提交中
手动维护
如果需要手动更新文档:
# 运行脚本
./scripts/update-claude-docs.sh
# 提交更新
git add .
git commit -m "docs: 更新 CLAUDE.md 文档"
扩展计划
未来功能
- 自动生成模块依赖图
- 检查 CLAUDE.md 文档格式
- 自动同步配置变更
- 生成变更日志