Archify deployment-ownership 工程档案:失败关闭的部署拓扑审查契约完整详解
Archify deployment-ownership 工程档案失败关闭的部署拓扑审查契约完整详解【免费下载链接】archifyAgent skill for beautiful, verifiable architecture, workflow, sequence,>项目地址: https://gitcode.com/GitHub_Trending/arch/archifyArchify 是一个面向 AI Agent 的架构图绘制技能而它的 deployment-ownership 工程档案engineering profile把部署拓扑审查变成了一份可执行、失败关闭fail-closed的契约只要负责人、区域边界或跨边界机制有一处缺失验证立即失败。本文带你快速看懂这套契约的全部规则、诊断码与交付保证。为什么需要一份失败关闭的部署审查契约普通架构图有一个隐性风险图看起来很完整但关键事实其实是作者没填。谁负责哪个组件数据库在不在私有网络里跨区域链路走的是什么机制这些问题在没有契约时全靠自觉——AI 甚至可能编造一个看起来合理的答案。Archify 的设计哲学是不画什么和画什么同样重要这一点在官方对比图中体现得很直观deployment-ownership 契约就是针对这个问题的答案默认不启用一旦显式启用事实不全就直接失败而不是悄悄降级通过。 契约定义见 archify/schemas/README.md验收证据在 docs/deployment-ownership-profile-acceptance-2026-07-23.md。如何启用一行配置的可选契约启用方式极简——在 JSON 的meta中加一个字段{ meta: { engineering_profile: deployment-ownership } }三个关键设计约束只属于 Architecture 模式Workflow、Sequence、Data Flow、Lifecycle 四种图会直接拒绝该字段architecture.schema.json 中engineering_profile只允许这一个枚举值纯可选不写这个字段v1 输入走原有验证与渲染路径零破坏启用后不许删字段蒙混过关authoring-contract.md 明确规定失败时要么修复事实、要么如实报告诊断不能为了过验证而摘掉画像。六条失败关闭规则逐条拆解契约的核心实现只有 engineering-profiles.mjs 一个模块规则如下#规则违反时的诊断码1每个非外部组件必须在tag中写明负责人团队/ownerdeployment-owner-missing2每个非外部组件必须恰好属于一个Region 边界deployment-region-scope/deployment-region-ambiguous3文档中必须同时存在region和security-group两类边界deployment-boundary-kind4每个database必须位于某个私有安全组内deployment-private-state5每个安全组的成员必须来自同一个Region禁止跨区私网deployment-private-region-consistency6任何穿越Region 或安全组的连接必须在label中写明真实机制如 VPC route、cross-region WALdeployment-crossing-mechanism第 6 条的穿越判定值得注意它只看成员归属关系authored membership不看点谁画在哪里、线怎么绕——同范围的关系和自环不会产生虚假的标签要求这一点由 engineering-profile.test.mjs 中的交叉矩阵测试逐一覆盖outside→region、region→region、public→private、private→public 四类。每条诊断都附带精确的定位集合 下标 ID、证据如crossedBoundaries列表和一条可直接执行的修复建议例如set /connections/2/label to the real cross-boundary mechanism。交付保证回执、确定性与失败不覆盖通过验证只是开始Archify 还给了三层交付契约如实回执validate --json和deliver --json都会输出engineeringProfile: deployment-ownership生成的 HTML 根节点携带data-engineering-profile属性cli.mjs画廊卡片显示一条紧凑的DEPLOYMENT OWNERSHIP · PASS条带确定性同一份源文件重复交付HTML 的 SHA-256 完全一致——你可以把指纹当图没被偷偷改过的证明失败保留旧产物档案验收记录证实profile 校验失败的交付不会覆盖上一次的好产物last known good测试用preserved.html字节比对验证了这一点。渲染产物是这样一个自包含的暗色查看器可直接离线打开边界声明这份契约不做什么这是全文最容易被忽略、却最关键的一点验收档案第 29 行原话验证器只读你写下来的 IR。通过结果不是对仓库、IaC、云账号、运行时影响、可用性或线上部署状态的验证。也就是说契约保证的是这张图把该回答的问题都回答了而不是你的云上真的这么部署。事实未知时正确做法是不启用画像或去核实事实而不是让 AI 猜一个。上手试一试以官方生产部署样例 production-deployment.architecture.json 为例它包含 12 个组件platform / app team / data team / SRE 四类 owner、2 个 Regionus-east-1 生产 eu-west-1 灾备、2 个安全组以及 3 个引导视图请求边界、状态归属、异步运维。克隆仓库后即可验证git clone https://gitcode.com/GitHub_Trending/arch/archify cd archify/archify node bin/archify.mjs validate architecture examples/production-deployment.architecture.json --json看到engineeringProfile: deployment-ownership且ok: true说明六条规则全部通过。相关文件清单契约实现archify/renderers/shared/engineering-profiles.mjs示例数据archify/examples/production-deployment.architecture.json、v1 基线快照完整测试套件archify/test/engineering-profile.test.mjs作者契约archify/references/authoring-contract.md模式场景提示词archify/recipes/scenarios.mjs研究与设计动机docs/research-next-stability-delight-slice-2026-07-23.md验收档案472 项测试通过的发布门docs/deployment-ownership-profile-acceptance-2026-07-23.md一句话总结deployment-ownership 不是一张更漂亮的图而是一份部署事实不许缺席的可执行合同——启用它的那一刻起缺失就是错误错误就有精确位置而产物永远可复现。【免费下载链接】archifyAgent skill for beautiful, verifiable architecture, workflow, sequence,>项目地址: https://gitcode.com/GitHub_Trending/arch/archify创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考

相关新闻

GD32F303标准库新建工程全攻略:从启动文件到时钟配置

GD32F303标准库新建工程全攻略:从启动文件到时钟配置

简介:面向基于ARM Cortex-M4内核的GD32F303嵌入式开发,这份资源系统梳理了在Keil MDK环境下使用标准库新建工程的完整过程,适合刚接触GD32系列或需要搭建可复用工程模板的单片机开发者。压缩包内共163个文件,以GD32F30x外设库的.h…

2026/11/20 10:56:55 阅读更多 →
Cloudflare 临时邮箱 S3 附件存储配置指南:R2 对象存储接入与附件管理实战

Cloudflare 临时邮箱 S3 附件存储配置指南:R2 对象存储接入与附件管理实战

Cloudflare 临时邮箱 S3 附件存储配置指南:R2 对象存储接入与附件管理实战 【免费下载链接】cloudflare_temp_email CloudFlare free temp domain email 免费收发 临时域名邮箱 支持附件 IMAP SMTP TelegramBot 项目地址: https://gitcode.com/GitHub_Trending/cl…

2026/11/18 10:29:26 阅读更多 →
ScyllaDB 2026.x 到 2026.3 滚动升级与回滚完全指南

ScyllaDB 2026.x 到 2026.3 滚动升级与回滚完全指南

ScyllaDB 2026.x 到 2026.3 滚动升级与回滚完全指南 【免费下载链接】scylladb NoSQL data store using the Seastar framework, compatible with Apache Cassandra and Amazon DynamoDB 项目地址: https://gitcode.com/GitHub_Trending/sc/scylladb 本篇技术指南面向 S…

2026/11/18 10:29:27 阅读更多 →

最新新闻

Electron桌面应用开发实战:从环境搭建到打包发布全流程

Electron桌面应用开发实战:从环境搭建到打包发布全流程

做前端这些年,我大部分时间都在跟浏览器标签页打交道,直到第一次把桌面应用跑起来,才发现原来自己一直被限制在地址栏和刷新按钮围起来的框框里。Electron这个词,最开始是在某段时间频繁出现在同事的讨论里,一个用HTML…

2026/11/19 21:38:27 阅读更多 →
滑盖智能锁T109深度解析:结构原理、安装调试与故障排查

滑盖智能锁T109深度解析:结构原理、安装调试与故障排查

简介:亚太天能T109滑盖智能锁产品说明书是一份PDF格式的官方技术文档,主要面向智能锁安装人员、终端用户及售后维护者,帮助快速掌握产品安装、配置与常见故障处理。全包仅1个PDF文件,大小4.37MB,内容结构清晰&#xff…

2026/11/19 21:38:49 阅读更多 →
PMSM弱磁控制原理与Simulink建模:高速AGV驱动系统设计指南

PMSM弱磁控制原理与Simulink建模:高速AGV驱动系统设计指南

上个月我在调试一台高速AGV的驱动系统,整车要求空载跑到8m/s,电机转速已经拉到额定点,驱动器的输出电压也顶到了母线电压极限附近。再往上踩速度指令,转速纹丝不动,三相电流反而开始震荡。那会儿我的第一反应就是&…

2026/11/19 21:39:09 阅读更多 →
C++核心知识点:从内存管理到STL的实战指南

C++核心知识点:从内存管理到STL的实战指南

C 这门语言我前前后后折腾了十几年,用它写过嵌入式驱动、做过游戏服务端,也搭过基础组件库。每次看到新人一头扎进"C 核心知识点"这个搜索词,我其实挺感慨的——这门语言的难点从来不是语法多,而是知识点之间的耦合太深…

2026/11/19 21:36:50 阅读更多 →
T109滑盖智能锁怎么装?安装调试与故障排查全攻略

T109滑盖智能锁怎么装?安装调试与故障排查全攻略

简介:亚太天能T109滑盖智能锁产品说明书以PDF格式发布,适合智能锁用户、安装人员与售后维修人员阅读。内容围绕T109系列指纹密码刷卡锁展开,先介绍前面板、后面板、锁体、机械钥匙、电池盒盖等部件名称与功能,再给出完整安装步骤&…

2026/11/19 21:37:45 阅读更多 →
LLM知识降熵:从信息垄断到理解权下放

LLM知识降熵:从信息垄断到理解权下放

你有没有过这种经历:翻开源码注释、论文摘要或者一份专业报告,每个字都认识,连在一起却像天书。想找人聊聊,身边要么没人懂,要么懂的懒得跟你解释。后来我试着把同一段内容丢给一个大语言模型,几秒钟之后&a…

2026/11/19 21:36:20 阅读更多 →

日新闻

周新闻

月新闻