mino-domain-model-completeness

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Domain Model Completeness

领域模型完整性审计

固定したuse-case scopeで正しい判断と状態維持に必要な意味が欠落せず、適切なownerへ置かれているかを監査する。DDD patternの数ではなく、要件coverage、不正状態、rule leakage、access pathで判定する。
在固定的用例范围内,审计是否不存在正确判断和状态维持所需的语义缺失,且是否被放置在合适的所有者处。判断依据并非DDD模式的数量,而是需求覆盖度、非法状态、规则泄漏、访问路径。

Outcome Contract

成果契约

主成果物として
Completeness Package
を作る。通常は次の最小構成を返し、12 dimensionの詳細schemaはworkflow referenceへ置く。
  • scope、actor、context、use case、requirement ID
  • applicableなterminology / concept / constraint / state / transition / behavior / relationship / failure / time
  • writer / readerのaccess path、invalid construction、model外rule、authority conflict
  • scope-localなsemantic owner、invariant owner、state authority、source of truthの監査と、そのEvidence
  • requirementごとのmodel coverage、gap、contract / test obligation
  • 既存のdownstream成果物が入力にある場合だけ、その実在IDへのlink
  • subject_verdict: complete | incomplete | indeterminate
    とcanonical
    decision
  • platform差がwriter、reader、representation、failureを分岐させる場合だけ、Platform Contextとvalidation matrix
subject_verdict
は固定したscope内の監査対象を表す。対象が
incomplete
でも監査artifact自体は
ready
になり得る。未作成のcontract IDやtest IDを予測しない。
主要成果物为
Completeness Package
。通常返回以下最小构成,12个维度的详细schema放置在工作流参考文档中。
  • 范围、参与者、上下文、用例、需求ID
  • 适用的术语/概念/约束/状态/迁移/行为/关系/失败/时间
  • 编写者/阅读者的访问路径、无效构造、模型外规则、权限冲突
  • 范围内语义所有者、不变量所有者、状态权限、事实源的审计及其证据
  • 各需求的模型覆盖度、缺口、契约/测试义务
  • 仅当存在作为输入的现有下游成果物时,添加指向其实体ID的链接
  • subject_verdict: complete | incomplete | indeterminate
    以及标准
    decision
  • 仅当平台差异导致编写者、阅读者、表示方式、失败情况出现分支时,提供平台上下文与验证矩阵
subject_verdict
表示固定范围内的审计对象状态。即使对象处于
incomplete
状态,审计工件本身也可能处于
ready
状态。不预测未创建的契约ID或测试ID。

Reference Routing

参考路由

  • 内部pathは、配置先にかかわらず、インストールされた
    skills/
    directoryを参照rootとして解決する。
  • 最初に
    skills/mino-core/references/core.md
    skills/mino-core/references/shared-policies.md
    skills/mino-core/references/requirements-and-traceability.md
    を読み、共通gateを再定義しない。
  • inventory、writer / reader、gap、coverage、verdictでは
    skills/mino-domain-model-completeness/references/workflow.md
    を読む。
  • terminology、bounded context、暗黙conceptの発見が必要なときだけ
    skills/mino-core/references/domain-discovery.md
    を読む。
  • filesystem、process、path、encodingがaccess pathを変えるときだけ
    skills/mino-core/references/platform-compatibility.md
    を読む。
  • standalone依頼が契約化、boundary設計、実装まで求める場合は、必要範囲に応じて
    $mino-design-by-contract
    $mino-interface-implementation-separation
    、または
    $mino-reproducible-development
    へ一度hand offする。
  • routerまたはpeer Skillからscoped artifactを依頼された場合は再routingせず、Completeness Packageと未解決obligationだけをcallerへ返す。
  • 12 dimensionは公開資料の固定定義ではなくsuite operationalizationとして扱う。
  • 内部路径无论存放位置如何,均以已安装的
    skills/
    目录作为根目录进行解析。
  • 首先读取
    skills/mino-core/references/core.md
    skills/mino-core/references/shared-policies.md
    skills/mino-core/references/requirements-and-traceability.md
    ,不得重新定义通用网关。
  • 在清单、编写者/阅读者、缺口、覆盖度、判定环节,读取
    skills/mino-domain-model-completeness/references/workflow.md
  • 仅当需要发现术语、限界上下文、隐含概念时,读取
    skills/mino-core/references/domain-discovery.md
  • 仅当文件系统、流程、路径、编码改变访问路径时,读取
    skills/mino-core/references/platform-compatibility.md
  • 如果独立请求要求完成契约化、边界设计、实现,则根据需求范围,将任务一次移交至
    $mino-design-by-contract
    $mino-interface-implementation-separation
    $mino-reproducible-development
  • 如果路由或同级Skill请求范围内工件,则不重新路由,仅向调用者返回Completeness Package和未解决的义务。
  • 12个维度不视为公开资料中的固定定义,而是作为套件运营化内容处理。

Authority Boundary

权限边界

  • このSkillが所有するのは、固定したuse-case / model scope内の意味、invariant、state change、writer / reader、既存source of truthの監査である。
  • system-wideなdata authority、target architecture、transition中の複数writerを新たに決定しない。入力にArchitecture Strategy PackageがあればそのIDを参照し、なければsystem-wide decision obligationとして返す。
  • contract conditionのauthoritative enforcementやconsumer operation boundaryを二重に確定しない。
  • 本Skill负责的是固定用例/模型范围内的语义、不变量、状态变更、编写者/阅读者、现有事实源的审计。
  • 不新制定系统级数据权限、目标架构、迁移中的多编写者规则。如果输入中存在架构策略包,则引用其ID;否则,将其作为系统级决策义务返回。
  • 不重复确定契约条件的权威执行或消费者操作边界。

Workflow

工作流

  1. actor、context、use case、success / failure、in / out-of-scopeを固定し、Evidence状態とdecision maturityを記録する。
  2. 必要ならterm ledger、context boundary、invisible conceptを発見する。
  3. requirementごとに12 dimensionのapplicabilityをscreeningし、結果を分岐させる観点だけを詳細化する。
  4. code、schema、API、event、test、operationからwriter / readerの全access pathを追跡する。
  5. scope-localなsemantic owner、invariant owner、state authority、source of truthを区別し、system-wide authorityとの整合を確認する。
  6. primitive、nullable、flag combination、unvalidated construction、model外ruleを監査する。
  7. 思考実験または使い捨てfixtureでdestruction probeを行い、entryから業務影響まで追跡する。
  8. model coverageとgapを計算し、必要なcontract / test obligationを作る。
  9. 対象の
    subject_verdict
    と、監査artifactのcanonical readiness、次phaseの可否を分けて返す。
  1. 固定参与者、上下文、用例、成功/失败情况、范围内/外内容,记录证据状态和决策成熟度。
  2. 如有必要,发现术语台账、上下文边界、隐性概念。
  3. 针对每个需求筛选12个维度的适用性,仅细化导致结果分支的视角。
  4. 从代码、schema、API、事件、测试、操作中追踪编写者/阅读者的所有访问路径。
  5. 区分范围内的语义所有者、不变量所有者、状态权限、事实源,确认与系统级权限的一致性。
  6. 审计基本类型、可空性、标志组合、未验证构造、模型外规则。
  7. 通过思维实验或一次性夹具进行破坏性探测,从入口追踪至业务影响。
  8. 计算模型覆盖度和缺口,生成必要的契约/测试义务。
  9. 分别返回对象的
    subject_verdict
    、审计工件的标准就绪状态、下一阶段是否可行。

Platform Compatibility

平台兼容性

  • path separator、case sensitivity、line ending、permissionをdomain conceptと混同せず、representationまたはenvironment constraintとして扱う。
  • file import、watcher、process連携等でOS差がstateやfailureを変える場合だけ、platform別writer / reader / failureをinventoryへ含める。
  • 複数platform対応がrequiredなら、一部platformでのみ到達できるinvalid stateやalternate writerを未監査のままpassにしない。
  • 不将路径分隔符、大小写敏感性、行尾、权限与领域概念混淆,而是将其视为表示方式或环境约束。
  • 仅当文件导入、监视器、流程协作等场景下的OS差异会改变状态或失败情况时,才将各平台的编写者/阅读者/失败情况纳入清单。
  • 如果需要支持多平台,不得将仅在部分平台可触发的非法状态或替代编写者视为未审计通过。

Hard Gates

硬性检查项

以下のいずれかに該当する場合は
subject_verdict: complete
にせず、gap、確認方法、影響を返す。
  • scopeが未定義、またはworld全体を対象にしている。
  • 業務用語、state、ruleを一般知識で補完している。
  • migration、serializer、ORM、admin、fixture等のalternate writerを無視している。
  • required platformのwriter / readerを未監査のまま完全性をpassにしている。
  • targetのauthority conflict、invalid construction、model外ruleを残している。
  • matrixを空欄、根拠のないN/A、重複profile、未解決IDで埋めている。
  • missing behavior / relationship / time / writer / readerを汎用gapへ潰す、またはEvidence不足を
    present
    や既知severityへ丸めている。
  • term / context / translation / relationshipのcanonical ID参照が未解決または改名fieldへ圧縮され、applicableなrelationshipのretry、duplicate、ambiguous outcome、failure owner、unknownの確認方法・影響が欠けている。
  • 未作成のcontract / test IDでtraceabilityを偽装している。
  • 対象が
    incomplete
    であることを、完遂した監査artifactの
    blocked
    と自動的に同一視している。
  • 本番dataへdestruction probeを実行している。
若符合以下任一情况,不得将
subject_verdict
设为
complete
,需返回缺口、确认方法及影响。
  • 范围未定义,或以整个系统为审计对象。
  • 使用通用知识补充业务术语、状态、规则。
  • 忽略迁移、序列化器、ORM、管理工具、夹具等替代编写者。
  • 未审计所需平台的编写者/阅读者即判定完整性通过。
  • 遗留目标的权限冲突、无效构造、模型外规则。
  • 矩阵为空、无依据标记为N/A、重复配置文件、未解决ID。
  • 将缺失的行为/关系/时间/编写者/阅读者归为通用缺口,或因证据不足将其标记为
    present
    或已知严重程度。
  • 术语/上下文/翻译/关系的标准ID引用未解决或被压缩至重命名字段,且缺失适用关系的重试、重复、模糊结果、失败所有者、未知情况的确认方法及影响。
  • 使用未创建的契约/测试ID伪造可追溯性。
  • 将对象的
    incomplete
    状态自动等同于已完成审计工件的
    blocked
    状态。
  • 在生产数据上执行破坏性探测。

Completion

完成标准

  • 全requirementで12 dimensionのapplicabilityがscreeningされ、applicableな観点はEvidence付きmodel elementへ、非該当は根拠付きprofileへ一度だけ接続される。
  • writer / reader access pathとmodel-localなauthority種別が明示され、system-wide authorityとの関係が参照またはobligationとして残る。
  • missing model elementはcontract / test obligationへ変換され、未作成IDで偽装されない。
  • term、context、ambiguous meaning、translationのcanonical ID参照が解決し、reference integrityを保つ。
  • applicableなcontext relationshipはupstream / downstream context、fact owner、integration、consistency、retry、duplicate、ambiguous outcome、failure ownerをEvidence付きで持ち、unknownには確認方法と影響がある。
  • invalid stateを公開writerから生成できないか、gapとして報告される。
  • discoveryがapplicableならcanonical Domain Discovery Packageを保持し、非適用またはunknownには理由、確認方法、影響、Evidenceがある。
  • platform要件がある場合、Windows / Linux / macOS固有のrepresentation、writer、reader、failureを監査済みまたは未実行として分ける。
  • subject_verdict
    、unknown、scope外、未実行検証を隠さず、canonical artifact readinessと分離する。
  • 所有需求均完成12个维度的适用性筛选,适用视角关联至带证据的模型元素,非适用视角关联至带依据的配置文件,且仅关联一次。
  • 明确编写者/阅读者访问路径及模型内权限类型,与系统级权限的关系以引用或义务形式保留。
  • 缺失的模型元素转换为契约/测试义务,不使用未创建ID伪造。
  • 术语、上下文、模糊语义、翻译的标准ID引用已解决,确保引用完整性。
  • 适用的上下文关系附带证据,包含上游/下游上下文、事实所有者、集成、一致性、重试、重复、模糊结果、失败所有者;未知情况附带确认方法及影响。
  • 非法状态要么无法由公开编写者生成,要么作为缺口报告。
  • 如果发现环节适用,则保留标准领域发现包;非适用或未知情况附带理由、确认方法、影响及证据。
  • 若存在平台需求,区分Windows/Linux/macOS特有的表示方式、编写者、阅读者、失败情况,标记为已审计或未执行。
  • 不隐瞒
    subject_verdict
    、未知情况、范围外内容、未执行验证,与标准工件就绪状态区分开。