👥 团队协作工作流

面向 Ascent Creator 开发的团队协作规范：Git 分支策略、代码审查、部署流程、日常操作。

一、Git 分支策略

采用精简版 Git Flow，适合 2~3 人小团队：

分支 命名 用途 保护
main main 生产就绪代码，只从 dev 合并 ✅ 保护
dev dev 日常开发集成分支，所有功能分支合并至此 ✅ 保护
feature/* feature/xxx 新功能开发，从 dev 拉出，完成后合并回 dev ❌
fix/* fix/xxx Bug 修复，从 dev 拉出，修复后合并回 dev ❌

分支操作流程

# 1. 从 dev 创建功能分支
git checkout dev
git pull origin dev
git checkout -b feature/image-workshop

# 2. 开发并提交
git add .
git commit -m "feat(image): 连接SDXL真实推理"

# 3. 推送到远程
git push origin feature/image-workshop

# 4. 创建 Pull Request (PR) 到 dev 分支
# 在 Gitee 上操作：新建 PR -> 从 feature/* -> dev

# 5. 合并后删除本地功能分支
git checkout dev
git pull origin dev
git branch -d feature/image-workshop

二、代码规范

2.1 Git Commit 格式

# 格式：类型(范围): 描述
# 类型：feat / fix / refactor / style / docs / chore

feat(image): 连接SDXL真实推理接口
fix(video): 修复任务状态轮询超时问题
refactor(chat): 重构消息流式渲染
style(layout): 调整侧边栏间距
docs(readme): 更新部署说明
chore(deps): 升级tailwindcss到4.0

2.2 Vue 代码规范

  • 使用 Composition API（setup script）
  • 状态管理使用 Pinia（stores/app.js）
  • 组件命名：PascalCase（如 AppLayout.vue）
  • 页面视图放在 src/views/，公共组件放在 src/components/
  • API 请求统一写在 src/services/api.js
  • 尽量避免在 vue 文件中写过多样式，使用 Tailwind 类 + style.css 全局类

2.3 Python 后端规范

  • 遵循 PEP 8 风格
  • API 路由统一以 /api/ 开头
  • 配置项统一放在 backend/config.py
  • 模型接口按类型归类（LLM / Image / Video / Music / Voice）
  • 新增工坊需注册路由 + 初始化数据库表

三、部署流程

3.1 手动部署（当前方式）

# 服务器上操作
cd /root/models_20260529220733/ai-creator-platform

# 1. 拉取最新代码
git pull origin main

# 2. 安装依赖
npm install

# 3. 构建前端
npm run build

# 4. 重启 Flask 后端
pkill -f "python3 app.py"
cd backend && nohup python3 app.py > app.log 2>&1 &

# 5. 验证
curl http://localhost:5000/api/models

3.2 Docker 部署（推荐生产）

# 构建镜像
docker build -t ascent-creator .

# 运行容器
docker run -d \
  --name ascent-creator \
  -p 5000:5000 \
  -v /path/to/config.py:/app/backend/config.py \
  --restart unless-stopped \
  ascent-creator

# 查看日志
docker logs -f ascent-creator

3.3 部署检查清单

# 检查项 结果
1config.py 包含正确的 API 密钥___
2GPU 推理机在线且端口可达___
3前端构建成功（npm run build）___
4Flask 服务启动无报错___
5论坛（5001）正常运行___
6SSH 端口 22 已限制白名单___

四、日常协作习惯

每日开始

  1. git checkout dev && git pull — 拉取最新代码
  2. npm install — 检查依赖更新
  3. 查看论坛帖子和留言了解任务进展

每日结束

  1. 提交代码并推送到远程（git push origin feature/xxx）
  2. 在 Gitee 上创建 PR（feature/* → dev）
  3. 记录当天完成内容到论坛（周报系统）

代码审查原则

  • PR 至少经过 1 人审查后合并
  • 审查重点：功能正确性、性能影响、安全风险、代码风格
  • 避免超大 PR（建议不超过 300 行变更）
  • Gitee PR 功能：可在 PR 页面添加评论和审核

五、联系方式与沟通

  • 技术讨论：微信工作群（主）
  • 任务分配：通过 Ascent Creator 论坛 + 微信沟通
  • 紧急问题：直接微信联系
  • 代码仓库：https://gitee.com/fishfilex/ascentcreator
  • 测试地址：http://82.156.214.59:5000
', 1, 'admin', '学习专区,Git,代码规范,部署流程,团队协作,Ascent Creator', datetime('now', '+8 hours') )