---
id: ka-guidance-架构语义红线
kind: guidance
title: 架构语义红线
sync_policy: engine_only
status: active
triggers:
  - 架构红线
  - 跨服务
  - 跨边界
  - 幂等
  - 审计记录
  - 绕过认证
  - 部署方案
  - 风险登记
  - 黑盒审查
  - 人工确认
  - 人工签署
extra:
  name: architecture-semantic-redline
  scope:
    - '*'
  products:
    - '*'
  category: constraint
  verification_layer: L2
  version: 1.0.0
  domain: verify
  owner_mechanism: mc-stage-gate-engine
---

# 架构语义红线

> 这些规则不可由通用代码检查确定性判定，需要业务上下文或人工判断，因此作为 guidance 注入并由 AI/人工审查。确定性架构检查仅承接能够可靠执行的规则；分层依赖和组件规模需要项目特定的 AST 或跨语言工具支持。

## 架构语义红线

客户端 AI 结合业务上下文评判：

1. **禁止 Patch JAR / docker commit / 运行时文件替换交付代码** —— 交付物须可重建、可追溯
2. **禁止跨服务边界直访持久化** —— 前端 / Controller / 定时任务不得绕过服务层直接访问数据库实现
3. **禁止绕过统一认证与数据范围控制暴露业务接口** —— 所有业务接口须经认证 + 数据权限
4. **新增写操作须有可追溯审计记录** —— 谁 / 何时 / 改了什么
5. **异步消息 / 定时任务 / 补偿逻辑须幂等** —— 重复执行不产生副作用
6. **模块边界职责清晰，无无消费者抽象或循环依赖**
7. **适用的 NFR 有来源、口径和可执行验证**
8. **部署方案与真实平台、权限和发布单元一致**
9. **风险登记覆盖高影响且难恢复的变化，不用通用清单凑数**
10. **模块依赖遵循分层方向、无循环依赖** —— 表现层不得直接访问数据层、service 不得跨层直访；分层违规和循环依赖须由 AI/人工或项目特定工具审查

## 用户裁决

需要业务、设计、合规或风险接受的项必须向用户展示影响和证据。接受风险通过 `sf_review resolve` 的 confirmed record 留痕；文档中的自定义签名字符串不具备授权效力。

## 关联
- 确定性架构检查：仅承接通用引擎可以可靠执行的规则；分层依赖和组件规模由本 guidance 与项目特定工具承接。
- [[证据驱动与反幻觉]] / [[开发者宪法]]