# 设计注记

> Barn 的架构决策、方案取舍与实现边界。

---

LLMS 索引： [llms.txt](/zh/llms.txt)

---

本栏目说明 Barn 0.9.0 候选版本的架构与实现取舍。

建议从产品模型开始，再沿着边界向外阅读：

1. [为什么 Barn 没有 Project](one-deployment-no-projects/)：一份 Inventory、一个
   Owner-scope Deployment，不制造第二份事实。
2. [为什么每个节点都有两张网卡](fixed-ip-two-nics/)：实验室固定身份与管理出网分离。
3. [声明式不等于破坏式](convergence-without-surprise/)：逐节点 Drift、显式重建与删除。
4. [PID 不是虚拟机身份](identity-before-pid/)：QMP 身份、进程证据、Journal 与有界恢复。
5. [`repo.yaml` 是意图，`catalog.json` 是证据](repo-yaml-catalog-json/)：生成元数据必须与
   实际 qcow2 字节一致的静态镜像仓库。

当前行为以[文档](/zh/docs/)为准，带日期的验证边界见[当前状态](/zh/docs/about/status/)。
这些设计记录解释契约为何存在；它们不会把设计、构建或本地测试升级成发布证据。

---

本节页面：

- [为什么 Barn 没有 Project](/zh/blog/design/one-deployment-no-projects/): 为什么 Barn 用一份 Pigsty Inventory 驱动一个 Owner-scope Deployment，取代按目录组织的 Project 状态。
- [为什么每个 Barn 节点都有两张网卡](/zh/blog/design/fixed-ip-two-nics/): 为什么 Barn 把管理出网与宿主、节点、Ansible 和 Pigsty 使用的固定地址网络分离。
- [声明式不等于破坏式](/zh/blog/design/convergence-without-surprise/): Barn 如何用逐节点哈希与显式操作保证配置缺席永远不能授权删除。
- [PID 不是虚拟机身份](/zh/blog/design/identity-before-pid/): 为什么 Barn 在发送信号或删除任何东西前，必须让 QMP 身份、进程证据、类型化 Invocation 与 Journal 相互吻合。
- [repo.yaml 是意图，catalog.json 是证据](/zh/blog/design/repo-yaml-catalog-json/): 为什么 Barn 把人工维护的镜像策略与必须匹配实际 qcow2 工件的生成元数据分离。