Engineering Standard — Infrastructure¶
Classification index for Bluefly infrastructure governance documents.
Scope: Oracle runtime, NAS storage, Terraform/OCI provisioning, backup contracts, private factory build, source/deployment/runtime separation.
Document Classification¶
| Document | Authority | Domain | Status |
|---|---|---|---|
| oracle-runtime-topology-2026-07-30.md | canonical | Oracle runtime architecture | dated snapshot — use for historical reference |
| nas-operational-model.md | canonical | NAS storage operations | operational |
| terraform-operational-model.md | canonical | OCI/Terraform provisioning | operational |
| backup-restore-contract.md | canonical | Backup/restore governance | binding |
| private-factory-build-guide.md | canonical | Private registry build | operational |
| source-deployment-runtime-separation.md | canonical | GitLab/Oracle/NAS topology law | binding |
| configuration-compiler-v1.0.md | canonical | Configuration compiler | operational |
Domain Map¶
Oracle Runtime¶
- Topology: oracle-runtime-topology-2026-07-30.md — canonical topology as of 2026-07-30. Probe live Oracle (
gcstatus,doltstatus) for current state. - Separation law: source-deployment-runtime-separation.md — binding: GitLab = source authority, Oracle = runtime, NAS = long-lived data. Never collapse these three.
NAS Storage¶
- Operations: nas-operational-model.md
- Audit/evidence: nas/README.md, nas/NAS-AUDIT-EVIDENCE.md
Provisioning (Terraform / OCI)¶
- IaC model: terraform-operational-model.md
- Active IaC source:
blueflyio/agent-platform/infra/iac(GitLab) — this is the canonical IaC source, NOT this docs directory.
Build¶
- Private factory build: private-factory-build-guide.md
- Configuration compiler: configuration-compiler-v1.0.md
Durability¶
- Backup/restore contract: backup-restore-contract.md — defines backup ownership, restore procedure, and acceptance criteria.
Non-Authorities (Do Not Mistake for Source)¶
| Surface | Authority |
|---|---|
| Oracle host checkout of any repo | NOT authoritative — source is GitLab |
| NAS agent workspaces | Working copies — GitLab is the authority |
Deploy components in web/, vendor/, recipes/contrib/ |
Generated — fix the producer repository |