fix

.cursor/rules/common/development-workflow.mdc

@@ -0,0 +1,151 @@
+---
+description: General development workflow and best practices
+---
+
+# 开发工作流规则
+
+## 🎯 当前优先级任务
+
+基于 [TASK_PROGRESS.md](mdc:TASK_PROGRESS.md)，当前高优先级任务：
+
+### 🔥 立即处理
+1. **完善照片更新和删除业务逻辑** - 后端CRUD完整性
+2. **完善分类更新和删除业务逻辑** - 后端CRUD完整性  
+3. **前端与后端API集成测试** - 端到端功能验证
+
+### 📋 本周目标
+- 实现完整的照片和分类CRUD操作
+- 前后端API集成调试
+- 用户认证流程实现
+
+## 🔄 开发流程规范
+
+### Git 工作流
+```bash
+# 功能开发
+git checkout -b feature/photo-update-api
+git add .
+git commit -m "feat: 实现照片更新API"
+git push origin feature/photo-update-api
+
+# 代码审查后合并
+git checkout main
+git merge feature/photo-update-api
+```
+
+### 提交信息规范
+```bash
+feat: 新功能
+fix: 修复bug
+docs: 文档更新
+style: 代码格式
+refactor: 重构
+test: 测试
+chore: 构建/工具
+```
+
+## 🧪 测试策略
+
+### 后端测试
+```bash
+# API 测试
+curl -X GET http://localhost:8888/api/v1/health
+curl -X POST http://localhost:8888/api/v1/auth/login \
+  -H "Content-Type: application/json" \
+  -d '{"username":"admin","password":"123456"}'
+
+# 功能测试
+make test
+```
+
+### 前端测试
+```bash
+# 启动开发服务器
+cd admin && bun run dev     # 管理后台:5173
+cd frontend && pnpm dev     # 用户界面:3000
+cd ui && pnpm dev          # 组件库:6006
+```
+
+## 🚀 部署流程
+
+### 开发环境
+```bash
+# 后端
+cd backend
+make run    # 端口:8888
+
+# 前端项目并行启动
+cd admin && bun run dev &
+cd frontend && pnpm dev &
+```
+
+### 生产环境准备
+1. 配置PostgreSQL数据库
+2. 更新CI/CD流程
+3. 配置反向代理
+4. 设置监控和日志
+
+## 📁 文件组织原则
+
+### 后端文件
+- 新Handler: `internal/handler/{module}/{action}Handler.go`
+- 新Logic: `internal/logic/{module}/{action}Logic.go`
+- 新API: `api/desc/{module}.api`
+
+### 前端文件
+- 新页面: `src/pages/{PageName}.tsx` 
+- 新组件: `src/components/{ComponentName}.tsx`
+- 新服务: `src/services/{serviceName}.ts`
+
+## 🔧 开发工具配置
+
+### VS Code 推荐插件
+- Go语言：`golang.go`
+- React：`ES7+ React/Redux/React-Native snippets`
+- Tailwind：`Tailwind CSS IntelliSense`
+- API测试：`REST Client`
+
+### 本地环境变量
+```bash
+# backend/.env
+DATABASE_URL="sqlite:photography.db"
+JWT_SECRET="your-secret-key"
+UPLOAD_PATH="./uploads"
+
+# frontend/.env.local
+NEXT_PUBLIC_API_URL="http://localhost:8888/api/v1"
+```
+
+## 🛠️ 故障排除
+
+### 常见问题
+1. **端口冲突**: 检查8888(后端)、3000(前端)、5173(管理后台)
+2. **依赖问题**: 删除node_modules重新安装
+3. **Go模块**: 运行`go mod tidy`清理依赖
+4. **API调用失败**: 检查CORS设置和认证token
+
+### 调试命令
+```bash
+# 检查服务状态
+lsof -i :8888
+netstat -tlnp | grep 8888
+
+# 查看日志
+tail -f backend/logs/photography.log
+```
+
+## 📊 进度跟踪
+
+### 完成标准
+- ✅ 代码通过测试
+- ✅ API接口可正常调用  
+- ✅ 前端界面功能正常
+- ✅ 更新TASK_PROGRESS.md状态
+
+### 每日更新
+在 [TASK_PROGRESS.md](mdc:TASK_PROGRESS.md) 记录：
+- 完成的任务
+- 遇到的问题
+- 明日计划
+
+保持项目进度透明化和可追踪性。