背景:用户确认仓库只保留 main,不再创建任何远程分支或走 PR 合并。 改动: - 01-Git规范 V1.1:仅 main 直推,禁止非 main 分支推送、force push 与 Merge commit; - AGENTS V1.1:变更流程改为直接提交并推送 main; - 07-CodeReview:PR 模板改为提交说明,合并流程改为推送与推送后观察; - 03/06/工程规范 README 同步去除 PR 措辞; - CI 仅保留 push main 与 workflow_dispatch 触发。 影响面:仅流程与文档,无代码/数据/接口变更。 回滚方式:git revert 本提交即可恢复旧流程。 验证:format:check、lint、typecheck 全绿(10/10)。
This commit is contained in:
1 parent
046dad463e
commit
dd01b89214
7 files changed
+74
-81
No files matched your search
@@ -7,7 +7,7 @@
|
||||
| --- | --- |
|
||||
| 适用对象 | 前端 / 后端 / 测试 / 运维 / AI 工程 / 产品(技术边界) |
|
||||
| 适用产物 | 代码、配置、脚本、迁移、文档、Prompts |
|
||||
| 文档版本 | V1.0(2026-11-02) |
|
||||
| 文档版本 | V1.1(2026-11-02) |
|
||||
| 事实基线 | PRD `V1.6`、技术架构 `V0.4` |
|
||||
|
||||
---
|
||||
@@ -79,7 +79,7 @@
|
||||
| 质量 | Vitest · Testcontainers · Playwright · k6 · oasdiff |
|
||||
| 观测 | Pino · OpenTelemetry |
|
||||
|
||||
> 版本升级单独 PR + 修订记录,**禁止顺手升级**。新增运行时依赖需在 PR 说明必要性(影响面 + 替代方案)。
|
||||
> 版本升级单独提交 + 修订记录,**禁止顺手升级**。新增运行时依赖需在提交说明必要性(影响面 + 替代方案)。
|
||||
|
||||
---
|
||||
|
||||
@@ -122,21 +122,21 @@ docs/ PRD / 技术架构 / 立项建议 / 工程规范
|
||||
|
||||
---
|
||||
|
||||
## 7 变更流程(提测 / 合并前必须全绿)
|
||||
## 7 变更流程(推送前必须全绿)
|
||||
|
||||
1. 从 `main` 拉短分支 → 小步提交(**Conventional Commits,提交信息与 PR 标题一律用中文**,`type` / `scope` 保留英文)。
|
||||
2. 本地门禁:`pnpm lint && pnpm typecheck && pnpm test`。
|
||||
3. PR 描述必含:**背景 / 改动 / 影响面 / 回滚方式 / 验证证据**;迁移、权限、AI、导出类变更须**双人 Review**。
|
||||
4. CI 全绿 + Review 通过 → **Squash Merge**;禁止 force push `main`。
|
||||
1. 基于最新 `main` 直接提交,小步 commit(**Conventional Commits,提交信息一律用中文**,`type` / `scope` 保留英文)。
|
||||
2. 本地门禁:`pnpm format:check && pnpm lint && pnpm typecheck && pnpm test`。
|
||||
3. 提交说明必含:**背景 / 改动 / 影响面 / 回滚方式 / 验证证据**;迁移、权限、AI、导出类变更须在推送前完成双人走查。
|
||||
4. 直接 `git push origin main`;禁止 force push `main`,禁止 Merge commit;推送后立即确认 CI,失败按前向修复处理。
|
||||
5. 发布:staging 验证 → 生产灰度;**迁移先行、代码后行**。
|
||||
|
||||
细则:[Git 规范](docs/工程规范/01-Git规范.md) · [Code Review 与 PR](docs/工程规范/07-CodeReview与PR规范.md) · [测试与 CI](docs/工程规范/06-测试与CI规范.md)
|
||||
细则:[Git 规范](docs/工程规范/01-Git规范.md) · [Code Review](docs/工程规范/07-CodeReview与PR规范.md) · [测试与 CI](docs/工程规范/06-测试与CI规范.md)
|
||||
|
||||
---
|
||||
|
||||
## 8 文档规范(摘要)
|
||||
|
||||
- 文档与代码**同 PR** 更新;只改文档也要走 PR。
|
||||
- 文档与代码**同一次提交或相邻提交**更新;只改文档也直接提交到 `main`。
|
||||
- 新业务规则先进 PRD 并编号(`R-xx`),再进代码。
|
||||
- 文档版本 `V<主>.<次>`:主版本 = 业务口径不兼容;次版本 = 增量补充。
|
||||
- 索引三处必须同步:根 `README.md`、`docs/工程规范/README.md`、本文件 §9。
|
||||
@@ -148,13 +148,13 @@ docs/ PRD / 技术架构 / 立项建议 / 工程规范
|
||||
|
||||
| 主题 | 文档 | 一句话 |
|
||||
| --- | --- | --- |
|
||||
| Git / 分支 / 提交 | [01-Git规范](docs/工程规范/01-Git规范.md) | 主干 + 短分支,Conventional Commits(**提交信息用中文**),Squash 合并 |
|
||||
| Git / 分支 / 提交 | [01-Git规范](docs/工程规范/01-Git规范.md) | 仅 `main` 直推,Conventional Commits(**提交信息用中文**),禁止 Merge commit |
|
||||
| 代码风格 | [02-代码风格](docs/工程规范/02-代码风格.md) | 命名、类型、错误处理、异步、React 约定 |
|
||||
| 格式化与 Lint | [03-格式化与Lint](docs/工程规范/03-格式化与Lint.md) | Prettier + ESLint 9 flat,钩子与 CI 门禁 |
|
||||
| API 与路由 | [04-API与路由规范](docs/工程规范/04-API与路由规范.md) | REST /api/v1、错误码、鉴权链、任务协议 |
|
||||
| 数据库 | [05-数据库规范](docs/工程规范/05-数据库规范.md) | ULID、customer_id、游标分页、expand/contract |
|
||||
| 测试与 CI | [06-测试与CI规范](docs/工程规范/06-测试与CI规范.md) | 分层测试、权限三态、覆盖率只升不降 |
|
||||
| Code Review | [07-CodeReview与PR规范](docs/工程规范/07-CodeReview与PR规范.md) | PR 模板、双人场景、DoD、合并后观察 |
|
||||
| Code Review | [07-CodeReview与PR规范](docs/工程规范/07-CodeReview与PR规范.md) | 提交说明、双人场景、DoD、推送后观察 |
|
||||
| 日志与可观测 | [08-日志与可观测性规范](docs/工程规范/08-日志与可观测性规范.md) | Pino 字段、trace_id、审计与日志分离、告警 |
|
||||
| 环境变量与密钥 | [09-环境变量与密钥规范](docs/工程规范/09-环境变量与密钥规范.md) | `.env.example` 入库、启动校验、轮换与泄露处置 |
|
||||
| 资产命名与图层 | [10-资产命名与PSD图层规范](docs/工程规范/10-资产命名与PSD图层规范.md) | 命名占位符、PSD 图层前缀、规格矩阵、低质量标记 |
|
||||
|
||||
Reference in new issue
Block a user