backend-domain-architecture

# Backend Domain Architecture Skill ## 定位 本 Skill 负责后端领域架构 Owner 视角。它要求后端设计先表达领域语言、业务流程、不变量和一致性边界，再落到接口、服务、权限、事务、缓存和数据结构，避免把框架样板或测试 fixture 当领域设计。 ## 触发条件 | 场景 | 是否触发 | |------|:--------:| | API、服务、权限、领域模型、业务流程、数据一致性或事务边界变化 | 必须 | | 涉及幂等、并发、缓存、队列、长事务、兼容迁移、public types | 必须 | | 用户指出示例像低阶、route 重复声明、权限/资源模型不专业 | 必须 | | 纯静态文档或前端视觉调整，后端契约不变 | N/A + skipReason | ## 核心门禁 | Gate | 要求 | 证据 | |------|------|------| | `BackendDomainArchitectureGate` | 后端方案必须绑定领域语言、边界上下文、业务不变量和一致性策略 | 源码、类型、schema、测试、运行证据 | | `DomainLanguageGate` | API、服务、文档和测试使用一致的领域词汇 | domainLanguage | | `BoundedContextGate` | 区分服务职责、模块边界、共享库和历史 route namespace | boundedContext | | `WorkflowInvariantGate` | 关键业务流程必须写前置条件、状态转换和不可破坏不变量 | workflowInvariants | | `PermissionModelGate` | 权限、资源、action、route group 或 middleware 由推荐主路径承载 | permissionModel | | `ConsistencyIdempotencyGate` | 事务、一致性、幂等、重试和兼容演进有明确策略 | transactionConsistency、idempotencyCompatibility | ## 执行步骤 1. 提取领域语言：实体、资源、动作、角色、状态、事件和约束。 2. 划定边界上下文：当前服务、共享库、adapter、legacy/compat、public API 和内部实现。 3. 描述业务流程：入口、前置条件、状态变化、失败分支、回滚和审计。 4. 设计权限模型：认证、授权、资源映射、route group、policy 和默认拒绝边界。 5. 设计一致性：事务范围、读写模型、缓存失效、幂等 key、重试和补偿。 6. 检查兼容性：public types、历史路由、迁移、版本化和消费者影响。 ## 输出字段 ```markdown ## BackendDomainArchitectureGate | 字段 | 内容 | |------|------| | domainLanguage | 实体、资源、动作、状态、事件和术语 | | boundedContext | 服务/模块/共享库/legacy/compat/public API 边界 | | workflowInvariants | 业务流程、状态转换和不可破坏不变量 | | permissionModel | authN/authZ、resource/action、policy、route group 或 middlewar...