Ayatori

Infrastructure, woven by intent. 意図から、インフラを編む。

Ayatori 是 ddupan.top homelab 的内部基础设施控制平面。它以 Kubernetes API 作为统一资源模型，通过薄适配器组合成熟后端，并让机器执行器与人工操作共同推动 实际状态持续收敛到声明的期望状态。

本仓库公开源代码，但当前只面向一个确定的内部环境。它不是通用私有云发行版，暂不 承诺开箱即用、后端可替换性或面向第三方的兼容性。

核心原则

• 内部专用只缩小需求与兼容范围，不降低软件工程质量。
• 优先采用可以立即投入使用的成熟后端，不重新实现复杂的数据面。
• 平台统一入口、策略、组合、状态与生命周期；后端保留领域实现。
• 应用通过 GitOps 直接组合正交的平台原语，不引入 ApplicationService 上帝控制器。
• Pod、OpenSandbox、Terraform、Ansible 和人都可以成为 executor。
• 暂时不能自动化的操作必须被建模、追踪并验证，而不是遗落在文档和记忆中。
• 控制面中断不得破坏已运行的数据面。

文档

• 产品愿景
• 总体架构
• API 设计原则
• 执行模型
• 环境与发布
• 路线图
• ADR-0001：采用 Kubernetes API machinery 作为状态协调平面
• ADR-0002：采用 k0s 与可选工作负载运行时
• ADR-0003：直接连接 Dev API 的开发循环
• ADR-0006：按实际管理缺口扩展资源 API
• ADR-0007：复用 Node API 建立按需实现的 Compute 能力
• ADR-0008：将 PostgreSQL Tenant Operator 合并为 Ayatori Database 模块

当前状态

Ayatori 处于设计与早期实现阶段。当前使用 Job controller 验证第一个完整控制循环与 adapter 边界；它不是通用 Job Service 或 FaaS 产品承诺。首批实际产品方向是 Database、LoadBalancer 和 Bucket/Object Storage，具体顺序按纵向价值决定。