---
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) 记录：
- 完成的任务
- 遇到的问题
- 明日计划

保持项目进度透明化和可追踪性。