152 lines
3.2 KiB
Plaintext
152 lines
3.2 KiB
Plaintext
---
|
||
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) 记录：
|
||
- 完成的任务
|
||
- 遇到的问题
|
||
- 明日计划
|
||
|
||
保持项目进度透明化和可追踪性。
|