文档范围:项目技术说明。项目是否发布、架构采用登记和具体环境验收分别维护;本页中的计划、偏差、测试数及未完成项仅适用于其明确记录的事项和版本,不应概括为整个平台尚未实现。当前组件版本见版本与依赖,业务发布范围见业务模块目录。未提供关闭证据的问题仍需按责任项目跟踪。
本文档由 g2rain-member-app 的 docs/development/git-workflow.md 自动同步生成。
# Git 分支与提交策略

# 分支

  • main:正式发布分支。
  • develop:日常集成和开发分支。
  • feature/<name>:特性开发。
  • fix/<name>:缺陷修复。
feature/* 或 fix/*
→ develop
→ 测试环境验证
→ main

feature/fix 不应绕过 develop 直接进入 main。模板仓库变更应在测试生成项目中验证,因为 main 上的模板版本会影响所有后续项目。

# 提交

推荐格式:

type(scope): summary

示例:

docs(architecture): add frontend template boundaries
feat(generator): support optional route output
fix(runtime): isolate router by app key

一次提交聚焦同一目的。生成结果可以与对应模板/页面变化一同提交,但必须能从 Diff 中识别,提交说明注明执行的生成命令。

# Pull Request

PR 至少说明:

  • 修改目的和受影响的模板能力。
  • 对新生成项目和已有项目的影响。
  • 是否改变占位符、目录、环境变量、生成输出或公共 API。
  • 执行的构建/测试/生成命令和结果。
  • 架构偏差是否新增、缩小或迁移。
  • 需要测试环境验证的 main-shell、IAM、Gateway 或容器条件。
Last Updated: 2026-11-04T23:05:57.394Z