soloforge 1.1.46 → 1.1.48

package/templates/design//351/234/200/346/261/202/345/210/206/346/236/220.md

@@ -12,8 +12,8 @@ extra:
   products:
     - '*'
   lifecycle_status: active
-  version: 1.3.0
-  last_reviewed: '2026-06-04'
+  version: 2.0.0
+  last_reviewed: '2026-06-17'
   type: artifact
   domain: design
   stage: design
@@ -22,6 +22,11 @@ extra:
 
 # 需求分析文档
 
+> **产物定位**：需求阶段（4 阶段第 1 步）的产出。把"做什么"想清楚，不是"怎么做"。
+> **核心纪律**（[[工程执行总纲]]）：先暴露阻塞困惑，禁止把模糊需求直接转成方案；区分事实/假设/需确认。[[证据驱动与反幻觉]]：需求声明要有来源证据。
+> **反退化纪律**：功能点清单/非功能需求/角色 等表格必须逐条填写真实内容，禁止空表、禁止只填示例行后省略、禁止「…」占位。
+> **完成判定**：见文末，不满足不算交付。
+
 ## 1. 需求来源
 - 需求文档/原型链接：
 - 提出人：
@@ -33,91 +38,82 @@ extra:
 **用户需要达成什么？（非解决方案描述）**
 
 fundamental_need: <!-- 如"用户需要在一个会话中选购多件商品并一次性结算" -->
-confirmed_by: <!-- 用户确认标记 -->
+confirmed_by: <!-- 用户确认标记，未确认不得进入实现 -->
 
-> **正反示例**：
+> 正反示例：
 > - ❌ `fundamental_need: "做一个购物车页面"` — 这是解决方案
 > - ✅ `fundamental_need: "用户需要在一个会话中选购多件商品并一次性结算"` — 这是用户目标
->
-> 引用审查规则：FP-01（第一性原理推理规则）
 
 ## 2. 功能点清单
 
-| 编号 | 功能点 | 页面/接口 | 业务规则 | 关联角色 | 前置依赖 | 关联功能 | 验收标准 | 状态 |
-|------|--------|----------|---------|---------|---------|---------|---------|------|
-| REQ-001 | | | | | | | | 待确认/已确认 |
+| 编号 | 功能点 | 页面/接口 | 业务规则 | 关联角色 | 前置依赖 | 验收标准 | 状态 |
+|------|--------|----------|---------|---------|---------|---------|------|
+| REQ-001 | | | | | | | 待确认/已确认 |
 
 ## 3. 术语表
 | 术语 | 含义 | 同义词（统一为） |
 |------|------|----------------|
-| | | |
 
 ## 4. 未确认项
 | 编号 | 问题 | 影响范围 | 阻塞程度 | 负责人 |
 |------|------|---------|---------|--------|
 | | | | 阻塞/非阻塞 | |
 
-## 5. 写操作失败反馈
-| 操作 | 失败场景 | 用户提示 | 重试建议 | 是否可恢复 |
-|------|---------|---------|---------|-----------|
-| | | | | |
-
-## 6. 菜单权限规划
-| 菜单路径 | 关联功能 | 角色 | 权限标识 | 默认可见 |
-|---------|---------|------|---------|---------|
-| | | | | |
+> 阻塞级未确认项不解决不得进入实现（[[工程执行总纲]] 思考先行）。
 
-## 7. 冲突与越界项
+## 5. 冲突与越界项
 | 项 | 类型（冲突/越界） | 来源 | 处理方式 |
 |----|-----------------|------|---------|
 | | | | 排除/延期/升级确认 |
 
-## 8. 非功能需求
-
-### 8.1 性能要求
-
-| 编号 | 类别 | 要求描述 | 验收指标 | 优先级 | 来源 |
-|------|------|---------|---------|--------|------|
-| NFR-001 | 性能 | <!-- 如：页面首次加载时间 --> | <!-- 如：< 3s --> | P0/P1/P2 | |
-
-### 8.2 安全要求
+## 6. 非功能需求
 
 | 编号 | 类别 | 要求描述 | 验收指标 | 优先级 | 来源 |
 |------|------|---------|---------|--------|------|
-| NFR-002 | 安全 | <!-- 如：敏感数据传输加密 --> | <!-- 如：TLS 1.2+ --> | P0/P1/P2 | |
+| NFR-001 | 性能 | <!-- 如：页面首次加载 --> | <!-- < 3s --> | P0/P1/P2 | |
+| NFR-002 | 安全 | <!-- 如：敏感数据传输加密 --> | <!-- TLS 1.2+ --> | P0/P1/P2 | |
+| NFR-003 | 可用性 | <!-- 如：系统可用率 --> | <!-- ≥ 99.9% --> | P0/P1/P2 | |
 
-### 8.3 可用性要求
+> 若需求来源未提及 NFR，按项目默认基线补齐：响应 < 3s、并发 100 用户、遵循项目安全基线、99.9% 可用率、主流浏览器最新 2 版。
 
-| 编号 | 类别 | 要求描述 | 验收指标 | 优先级 | 来源 |
-|------|------|---------|---------|--------|------|
-| NFR-003 | 可用性 | <!-- 如：系统可用率 --> | <!-- 如：≥ 99.9% --> | P0/P1/P2 | |
+## 7. 用户角色与权限
+| 角色名称 | 角色描述 | 关联功能 | 数据权限范围 |
+|---------|---------|---------|------------|
 
-### 8.4 兼容性要求
+## 8. 外部接口与集成
+| 外部系统 | 接口类型 | 用途 | 数据流向 | 可用性要求 | 负责方 |
+|---------|---------|------|---------|----------|--------|
+| | API/Webhook/SDK/文件 | | 出/入/双向 | SLA 要求 | 己方/对方/三方 |
 
-| 编号 | 类别 | 要求描述 | 验收指标 | 优先级 | 来源 |
-|------|------|---------|---------|--------|------|
-| NFR-004 | 兼容性 | <!-- 如：目标浏览器版本 --> | <!-- 如：Chrome/Safari/Firefox 最新 2 版 --> | P0/P1/P2 | |
+> 若系统无外部依赖，显式标注"本系统无外部接口依赖"。
 
-### 8.5 数据要求
+## 9. 系统形态与交付边界
 
-| 编号 | 类别 | 要求描述 | 验收指标 | 优先级 | 来源 |
-|------|------|---------|---------|--------|------|
-| NFR-005 | 数据 | <!-- 如：数据保留策略 --> | <!-- 如：日志保留 90 天 --> | P0/P1/P2 | |
+> 决定系统长什么样：是否前后端分离、几个端、各端技术栈。这是下游架构 §6.3 前端模块化（`FE-*` 端 ID）的依据，**须与用户研讨确认（非 AI 代决，属 must_confirm）**。
+> 纯后端 API 项目：形态填「纯后端 API」，端清单留空（REQ-DELIB 不强制研讨前端形态）。
 
-> 若需求来源未提及 NFR，按项目默认 NFR 基线补齐：响应 < 3s、并发 100 用户、遵循项目安全基线、99.9% 可用率、主流浏览器最新 2 版。
+- 系统形态：纯后端 API / 前后端分离 / 多端 / 纯前端
+- 是否有前端：是/否
 
-## 9. 用户角色
+### 端清单（有前端时逐端填写，每端对应架构 §6.3 一个 FE-* 端模块）
 
-| 角色名称 | 角色描述 | 关联功能 | 关联菜单 | 数据权限范围 |
-|---------|---------|---------|---------|------------|
-| <!-- 如：管理员 --> | <!-- 职责和使用场景 --> | REQ-NNN | <!-- 第 6 章菜单路径 --> | <!-- 可访问的数据范围 --> |
+| 端 ID（FE-*） | 端名称 | 形态 | 技术栈 | 职责 | 本期交付 |
+|--------------|--------|------|--------|------|---------|
+| FE-client-01 | | Web/移动/桌面 | | | 是/否 |
 
-> 角色名称必须在第 6 章菜单权限和第 2 章功能点中保持一致引用。
+> 端 ID 用**单段**命名（`FE-client-01`/`FE-admin-01`），不用多段（非 `FE-client-portal-01`）——承接校验正则约束。
 
-## 10. 外部接口与集成
+### 交付边界
+- 本期交付的端：
+- 后续迭代的端：
+- 前后端契约方式：RESTful / GraphQL / BFF
 
-| 外部系统 | 接口类型 | 用途 | 数据流向 | 可用性要求 | 负责方 |
-|---------|---------|------|---------|----------|--------|
-| | API/Webhook/SDK/文件 | | 出/入/双向 | SLA 要求 | 己方/对方/三方 |
+## 完成判定
 
-> 若系统无外部依赖，在此章显式标注"本系统无外部接口依赖"。
+- [ ] §9 系统形态与交付边界已填写（形态/端清单/技术栈已与用户研讨确认；涉及前端时须有研讨记录）
+- [ ] `fundamental_need` 是用户目标而非解决方案，且 `confirmed_by` 已标记
+- [ ] 每个 REQ 有验收标准（可验证，非"功能正常"模糊表述）
+- [ ] 阻塞级未确认项已解决或已升级
+- [ ] NFR 有量化验收指标
+- [ ] 无证据的需求声明已标注来源/不确定
+- [ ] 各表格逐条填写真实内容，无空表/无示例行后省略/无「…」占位

package/templates/operate/UI/350/247/206/350/247/211/351/252/214/346/224/266/347/272/252/345/276/213.md

@@ -0,0 +1,74 @@
+---
+id: ka-guidance-UI视觉验收纪律
+kind: guidance
+title: UI视觉验收纪律
+sync_policy: copy_to_project
+status: active
+triggers:
+  - UI 视觉
+  - 视觉验收
+  - 界面样式
+  - 前端样式
+  - 界面布局
+target_artifact:
+  - release_note
+extra:
+  name: ui-visual-acceptance
+  scope:
+    - frontend
+  products:
+    - '*'
+  type: procedure
+  lifecycle_status: active
+  version: 1.0.0
+  last_reviewed: '2026-06-20'
+  verification_layer: L2
+  stage: operate
+  domain: operate
+  owner_mechanism: mc-stage-gate-engine
+---
+
+# UI视觉验收纪律
+
+> **本纪律仅适用于含前端 UI 的项目。纯后端/无 UI 项目跳过本节，发布说明「UI 视觉验收」行填「无前端」。**
+
+> **为什么是 L2 软规则**：SLICE-E2E（playwright e2e）只验**交互链路与接口响应**，不验**UI 视觉样式**（布局/颜色/间距/响应式视觉/与设计稿一致）。引擎不调 LLM、看不懂截图，**无法确定性判定"界面长得对不对"**——强行硬判必造假（有截图 ≠ 视觉对）。故 UI 视觉正确性归 **L2 客户端 AI 视觉审查**（主）+ **L3 人工确认**（兜底），引擎只做：注入本纪律提醒 + 提供发布说明留痕载体 + 文案不假装确定性验过。
+
+## 主流程：L2 客户端 AI 视觉审查
+
+交付前（产出发布说明时）对前端各端做视觉审查，**看截图判断**：
+
+1. **布局**：核心页面在 desktop/移动 viewport 下无塌陷、无错位、关键元素可见可点
+2. **颜色/主题**：配色与设计稿/主题一致，无对比度缺陷（文字可读）
+3. **响应式视觉**：断点切换无溢出、无横向滚动、组件自适应
+4. **与设计稿一致**：关键页对照设计稿/截图基线，记录差异点
+
+**产出结论**（非"看过"二字了事）：每个审查维度给 通过/差异/未覆盖，差异项附截图 ref + 说明。
+
+## L3 兜底：人工确认主观项
+
+以下归人工确认，AI 不得替人拍板：
+- 主观审美（视觉风格是否"对"、品牌调性）
+- AI 不确定的视觉差异（像素级 flaky）
+- 设计稿未覆盖的边界视觉态
+
+发布说明「UI 视觉验收」行须列明**需人工确认的视觉点**（对应 `manual_review_steps_zh`），人工逐项确认后方可判定交付完成。
+
+## 留痕（发布说明「UI 视觉验收」行）
+
+发布说明「5. 验证结果」表「UI 视觉验收」行填写：
+- **结果**：通过 / 差异（附说明）/ 待人工确认
+- **证据**：截图 ref + AI 视觉结论摘要 / 人工确认结果
+
+## 诚实纪律（反造假）
+
+- **没验标 gap，不假装 passed**：若未做视觉审查，发布说明该行填「未验收」并标限制，**不得填"通过"**——填"通过"而无证据 = 重蹈 SLICE-E2E 名不副实的覆辙。
+- **不在确定性 e2e 里偷验视觉**：UI 视觉是 L2/L3 域，不往 SLICE-E2E 塞视觉断言冒充确定性覆盖。
+- **纯前端无后端的项目也须做**：只要含 UI 就适用，不因"无后端接口"跳过视觉验收。
+
+## L1 备选：视觉回归（成熟项目可选）
+
+成熟项目可加 `playwright` `toHaveScreenshot()` 基线对比做**视觉回归**（L1 确定性，防"这次和上次不一样"）。注意：
+- 视觉回归只防**回归**，不验**设计符合度**（基线本身可能就是错的）——不替代 L2 设计符合度审查。
+- 需建基线截图 + 维护，像素对比易 flaky（字体渲染/动画），需稳定测试环境。
+- 新建项目默认走 L2+L3，待视觉稳定后再补 L1 回归。

package/templates/operate/enforced.md

@@ -5,11 +5,13 @@ gate: operate-gate
 title: operate阶段强制检查清单
 sync_policy: engine_only
 status: active
+extra:
+  owner_mechanism: mc-stage-gate-engine
 checks:
   - id: OPR-G01
     executor: file_evidence
     rule: "发布后 5xx 错误率在基线 ±20% 范围内，无突增趋势"
-    severity: error
+    severity: warning
     check_type: deterministic
     evidence_required: ["基线错误率 / 发布后错误率 / 偏差百分比（±20% 内）"]
     gate: operate-gate
@@ -17,7 +19,7 @@ checks:
   - id: OPR-G02
     executor: file_evidence
     rule: "发布后 P99 延迟不超过基线的 1.5 倍"
-    severity: error
+    severity: warning
     check_type: deterministic
     evidence_required: ["P99 基线 / 发布后 P99 / 比值（<= 1.5x）"]
     gate: operate-gate
@@ -33,7 +35,7 @@ checks:
   - id: OPR-G04
     executor: file_evidence
     rule: "回滚预案已在预发环境演练验证，总耗时不超过 5 分钟"
-    severity: error
+    severity: warning
     check_type: deterministic
     evidence_required: ["回滚演练记录 + 总耗时（<= 5 分钟）"]
     gate: operate-gate
@@ -41,16 +43,61 @@ checks:
   - id: OPR-G05
     executor: file_evidence
     rule: "发布后数据一致性校验 SQL 全部通过，覆盖所有变更涉及的表"
-    severity: error
+    severity: warning
     check_type: deterministic
     evidence_required: ["校验 SQL 结果 + 覆盖表/记录数"]
     gate: operate-gate
     target: "self"
+  - id: OPR-DEPLOY-STRUCT
+    executor: document_structure
+    rule: "部署配置须含「环境规划」「环境变量与密钥」「部署方式」「健康检查与资源」「监控告警」「回滚方案」「完成判定」章节"
+    severity: error
+    check_type: deterministic
+    evidence_required: ["deploy/部署配置.md"]
+    gate: operate-gate
+    target: self
+  - id: RELNOTE-STRUCT
+    executor: document_structure
+    check_type: deterministic
+    severity: warning
+    gate: operate-gate
+    required_artifact: 发布说明模版
+    rule: "发布说明须含「版本信息」「变更摘要」「数据库迁移」「验证结果」「回滚方案」「部署步骤」「监控」「已知问题」「完成判定」章节"
+    evidence_required: ["docs/audits/04-发布说明.md"]
+    target: "self"
+  - id: DEPLOY-BLOCK
+    executor: document_structure
+    check_type: deterministic
+    severity: error
+    gate: operate-gate
+    required_artifact: 部署配置模版
+    rule: "部署必填表格章节（环境/变量/依赖/健康/监控/回滚）须有表格行（反退化：禁空单元格/...占位）"
+    block_check:
+      item_pattern: '^##\s+(1|2|3|5|6|7)\.'
+      require_table: true
+      min_table_rows: 1
+    evidence_required: ["部署配置模版"]
+    target: "self"
+  - id: RELEASENOTE-BLOCK
+    executor: document_structure
+    check_type: deterministic
+    severity: error
+    gate: operate-gate
+    required_artifact: 发布说明模版
+    rule: "变更摘要/验证结果章节须有表格行（反退化：禁空表/一句话代替）"
+    block_check:
+      item_pattern: '^##\s+(2|5)\.'
+      require_table: true
+      min_table_rows: 1
+    evidence_required: ["发布说明模版"]
+    target: "self"
 ---
 
 # operate-gate 强制检查清单
 
-5 条确定性检查。bridge 从此文件聚合。
+6 条确定性检查（含 RELNOTE-STRUCT）。bridge 从此文件聚合。
+
+> OPR-G01~G05 用 file_evidence（只验证据文件存在+非空）；rule 描述的指标（5xx/P99/日志/回滚/一致性）**须人工确认**，故 severity=warning（不假装 error 确认指标）。
 
 对应工程经验：
 - OPR-G01

package/templates/operate//344/270/212/347/272/277/350/247/202/345/257/237.md

@@ -1,57 +1,78 @@
 ---
-id: ka-rule-domain-operate-rollout-monitoring
+id: ka-guidance-上线观察
 kind: guidance
 title: 上线观察
+sync_policy: copy_to_project
+status: active
 triggers:
   - 上线
   - 观察
   - 监控
   - rollout
-sync_policy: copy_to_project
-status: active
+  - 灰度
+  - 发布
+  - 回滚
+  - 熔断
+  - 发布后
+target_artifact:
+  - deploy_config
+  - release_note
 extra:
-  updated_at: '2026-06-15'
-  lifecycle_status: active
   name: rollout-monitoring
   scope:
     - '*'
   products:
-    - deploy_config
-    - release_note
-  type: constraint
-  version: 1.0.0
-  last_reviewed: '2026-06-11'
-  domain:
-    - operate
+    - '*'
+  type: procedure
+  lifecycle_status: active
+  version: 2.0.0
+  last_reviewed: '2026-06-17'
   verification_layer: L2
   stage: operate
+  domain: operate
   owner_mechanism: mc-domain-operate
 ---
 
-## 上线观察规则
+# 上线观察：发布后怎么盯、什么时候回滚
+
+> operate-gate 的 OPR-G01~05 是确定性门禁；本 guidance 是发布值守的方法。
+> [[开发者宪法]]：破坏性/线上操作必须可回滚、有人盯。
+
+## 灰度发布
+
+- 小流量先上（1% → 10% → 50% → 100%），每档观察一个周期
+- 每档观察指标无异常再放量
+- 灰度期间保留快速回滚能力
+
+## 观察指标（对应 OPR-G01~03）
+
+- **错误率**：5xx 在基线 ±20% 内（OPR-G01）
+- **延迟**：P99 不超基线 1.5 倍（OPR-G02）
+- **新错误模式**：日志无部署前不存在的错误（OPR-G03）
+- **业务指标**：核心业务量/转化率无异常下跌
 
-### 观察指标
+## 熔断回滚
 
-1. **错误率监控**
-   - 上线后 15 分钟内 5xx 错误率不得超过基线的 2 倍
-   - 新增的错误码必须立即通知
+回滚触发条件（命中任一立即回滚，不要犹豫）：
+- 错误率超基线 2 倍且持续
+- P99 超基线 3 倍
+- 业务核心指标崩跌
+- 数据不一致告警
 
-2. **延迟监控**
-   - P99 延迟不得超过基线的 1.5 倍
-   - 关键接口响应时间必须持续观察 30 分钟
+回滚操作：
+- 按预演过的回滚方案执行（OPR-G04，总耗时 ≤ 5 分钟）
+- 回滚后确认指标恢复 + 数据一致性（OPR-G05）
+- 留痕：回滚原因/时间/操作人/结果
 
-3. **业务指标**
-   - 核心业务流程（下单/支付/登录）成功率不得下降
-   - 数据一致性校验必须在上线后执行
+## 发布后验证
 
-4. **回滚触发条件**
-   - 错误率超过阈值 → 自动回滚
-   - 业务流程完全中断 → 立即回滚
-   - 数据不一致 → 暂停发布 + 人工评估
+- 数据一致性校验 SQL 全过（OPR-G05）
+- 核心业务流程线上复验（非只看监控）
+- 确认无遗留告警
 
-### 验收项
+## 禁止
 
-- [AC-01] 监控面板已就绪
-- [AC-02] 告警阈值已配置
-- [AC-03] 回滚触发条件已定义
-- [AC-04] 观察窗口期已设定（至少 30 分钟）
+- 无回滚方案就上线（违规）
+- 全量直上无灰度（违规，除非低风险配置变更且说明）
+- 指标异常不回滚硬扛（违规）
+- 回滚方案没演练过（违规，OPR-G04）

package/templates/operate//345/217/221/345/270/203/350/257/264/346/230/216.md

@@ -1,5 +1,5 @@
 ---
-id: ka-artifact_template-发布说明模版
+id: ka-artifact-发布说明
 kind: artifact
 title: 发布说明
 sync_policy: copy_to_project
@@ -22,6 +22,10 @@ extra:
 
 # 发布说明
 
+> **产物定位**：operate 阶段产出。记录发布内容/影响/验证/回滚，是上线可追溯的凭证。
+> **核心纪律**：任何上线变更必须有回滚方案（[[开发者宪法]]）；发布说明须含回滚章节（operate-gate RELNOTE-STRUCT 守护）。
+> **反退化纪律**：变更摘要/验证结果等表格须逐条填写，禁止空表、禁止「…」省略；回滚/部署步骤须是可执行的具体步骤，非一句话。
+
 ## 1. 版本信息
 - 版本号：
 - 发布日期：
@@ -33,6 +37,12 @@ extra:
 |--------|---------------------------|--------------|---------|
 | | | | |
 
+### 前端各端版本（涉及 FE-* 时填；纯后端填"无前端"）
+
+| 端（FE-*） | 版本号 | 变更摘要 | 是否独立发布 |
+|-----------|--------|---------|------------|
+| FE-client-01 | | | 是/否 |
+
 ## 3. 数据库迁移
 - [ ] 无数据库变更
 - 迁移脚本路径：
@@ -51,6 +61,7 @@ extra:
 | 单元测试 | | |
 | 集成测试 | | |
 | 端到端验收 | | |
+| UI 视觉验收（前端项目填；纯后端填"无前端"）| | 截图 + AI视觉结论/人工确认 |
 
 ## 6. 回滚方案
 - 触发条件（什么情况下回滚）：
@@ -77,3 +88,13 @@ extra:
 - 通知对象（用户/团队/相关方）：
 - 通知内容：
 - 通知时间：
+
+## 完成判定
+
+- [ ] 版本信息完整（版本号/日期/负责人）
+- [ ] 变更摘要覆盖本次所有变更
+- [ ] 验证结果含三类（正常/边界/异常）
+- [ ] 回滚方案可执行
+- [ ] 部署步骤明确可操作
+- [ ] 前端项目：UI 视觉验收已留痕（截图+结论或人工确认）；纯后端填"无前端"
+- [ ] 变更/验证表格逐条填写，回滚与部署步骤具体可执行（非一句话）

package/templates/operate//351/203/250/347/275/262/351/205/215/347/275/256.md

@@ -0,0 +1,93 @@
+---
+id: ka-artifact-部署配置
+kind: artifact
+title: 部署配置
+sync_policy: copy_to_project
+status: active
+extra:
+  name: deploy-config
+  scope:
+    - '*'
+  products:
+    - '*'
+  lifecycle_status: active
+  version: 1.0.0
+  last_reviewed: '2026-06-17'
+  type: artifact
+  domain: operate
+  stage: operate
+  owner_mechanism: mc-generic-artifact
+---
+
+# 部署配置
+
+> **产物定位**：operate 阶段必出。把环境、依赖、部署方式、健康检查、回滚定清楚。
+> **核心纪律**：部署可回滚（[[开发者宪法]]）；配置走环境变量不硬编码（[[安全加固]]）。
+> **反退化纪律**：环境变量/依赖服务/监控告警/回滚方案等表格须逐条填写真实值，禁止空单元格、禁止「…」占位。
+> **完成判定**：见文末。
+
+## 1. 环境规划
+| 环境 | 用途 | 访问范围 | 数据来源 | 配置差异 |
+|------|------|---------|---------|---------|
+| 开发 | | | | |
+| 测试 | | | | |
+| 预发 | | | | |
+| 生产 | | | | |
+
+## 2. 环境变量与密钥
+| 变量名 | 用途 | 是否敏感 | 默认值 | 各环境取值来源 |
+|--------|------|---------|--------|--------------|
+
+> 敏感变量必须走密钥管理/环境变量注入，禁止写入镜像或代码（shared-gate SEC-02）。
+
+## 3. 依赖服务
+| 服务 | 用途 | 版本 | 访问方式 | SLA/可用性要求 | 失败降级 |
+|------|------|------|---------|--------------|---------|
+| 数据库 | | | | | |
+| 缓存 | | | | | |
+| 消息队列 | | | | | |
+
+## 4. 部署方式
+- 部署形态：Docker / k8s / 裸机 / Serverless
+- 镜像/制品来源：
+- 部署流程：构建 → 推送 → 拉起 → 健康检查 → 放量
+
+### 多端部署矩阵（涉及前端 FE-* 时填；纯后端填"无前端，单一部署"）
+
+| 端（FE-*） | 部署方式 | 制品来源 | 域名/入口 | 与后端依赖 |
+|-----------|---------|---------|----------|-----------|
+| FE-client-01 | 静态托管/CDN/容器 | | | |
+
+> 每个前端端独立部署（静态资源 CDN / 容器化），后端独立部署；端间依赖（如 admin 依赖后端 API）显式声明。
+
+## 5. 健康检查与资源
+| 项 | 配置 |
+|----|------|
+| 健康检查端点 | |
+| 就绪检查 | |
+| 存活检查 | |
+| CPU/内存限制 | |
+| 副本数/扩缩容策略 | |
+
+## 6. 监控告警
+| 指标 | 告警阈值 | 处理动作 |
+|------|---------|---------|
+| 错误率 | | |
+| P99 延迟 | | |
+| 资源使用率 | | |
+
+## 7. 回滚方案（必填）
+| 场景 | 回滚方式 | 回滚耗时 | 验证方法 | 触发条件 |
+|------|---------|---------|---------|---------|
+
+> operate-gate OPR-G04：回滚预案须在预发演练，总耗时 ≤ 5 分钟。
+
+## 完成判定
+
+- [ ] 四环境规划完整（开发/测试/预发/生产）
+- [ ] 敏感变量标注并走密钥管理（无硬编码）
+- [ ] 依赖服务列出失败降级
+- [ ] 健康检查（就绪+存活）配置
+- [ ] 监控告警覆盖错误率/延迟/资源
+- [ ] 回滚方案有且可演练
+- [ ] 各配置表格逐条填真实值，无空单元格/无「…」占位