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