Skip to content

ci: introduce GitFlow workflow and quality gates#12

Merged
Cunninger merged 1 commit into
mainfrom
feat/workflow-standardization
Apr 29, 2026
Merged

ci: introduce GitFlow workflow and quality gates#12
Cunninger merged 1 commit into
mainfrom
feat/workflow-standardization

Conversation

@Cunninger

@Cunninger Cunninger commented Apr 29, 2026

Copy link
Copy Markdown
Owner

变更内容

本次 PR 引入简化版 GitFlow 工作流和代码质量门禁,规范化开发和发布流程。

CI / 工作流

  • 新增 ci.yml:PR 阶段自动检查 frontend 构建和 backend 语法,防止坏代码合入 main/develop。
  • 改造 auto-release.yml
    • 触发条件从 push to main 改为 push tag v*.*.* + workflow_dispatch
    • 移除自动 bump patch 版本号逻辑
    • 新增 VERSION 文件与 tag 一致性校验
    • 解决之前 tag 碰撞导致发布失败的问题

分支模型

  • 已创建 develop 分支作为日常开发集成分支
  • 以后日常开发从 developfeat/*,PR 目标选 develop
  • 发版时从 developrelease/vX.Y.Z,PR 到 main,合并后手动打 tag 触发自动打包

代码质量工具

  • Backend:Ruff(lint + format)+ mypy,配置在 backend/pyproject.toml
  • Frontend:ESLint + Prettier,配置在 frontend/eslint.config.js.prettierrc
  • Pre-commit hooks.pre-commit-config.yaml,本地提交前自动格式化

协作规范

  • CODEOWNERS:代码所有者声明
  • PULL_REQUEST_TEMPLATE.md:新增版本类型、Commit 类型选项
  • CONTRIBUTING.md:更新为 GitFlow 流程和 Conventional Commits 规范
  • CHANGELOG.md + RELEASE_CHECKLIST.md:发版可追溯

测试方式

  1. 合并此 PR 后,后续向 main/develop 发起的 PR 会自动触发 ci.yml 构建检查
  2. 更新 VERSION 文件并推送 tag(如 v1.0.11)可验证 auto-release.yml 是否正常打包

检查清单

  • 代码已本地测试通过
  • CI workflow 语法已验证
  • 没有引入新的警告或错误
  • CONTRIBUTING / RELEASE_CHECKLIST 已同步更新

- Add ci.yml: PR-stage build checks for frontend and backend
- Refactor auto-release.yml: trigger on tag push instead of main push,
  remove auto-bump, add VERSION/tag consistency check
- Create develop branch as integration branch
- Add Ruff (backend) and ESLint + Prettier (frontend) configs
- Add pre-commit hooks for local quality checks
- Add CODEOWNERS, CHANGELOG, and RELEASE_CHECKLIST
- Update CONTRIBUTING.md and PR template with GitFlow guidelines
- Add backend/requirements-dev.txt and backend/pyproject.toml

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
@Cunninger Cunninger merged commit 71235c3 into main Apr 29, 2026
1 of 2 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant