Architecture Documentation
This directory contains the architectural documentation for floe.
Overview
Section titled “Overview”- Architecture Summary - Executive overview of floe architecture
Core Architecture
Section titled “Core Architecture”| Document | Description |
|---|---|
| Four-Layer Overview | Foundation, Configuration, Services, and Data layers |
| Platform Enforcement | How platform constraints are enforced at compile time |
| Platform Services | Layer 3 long-lived services (Dagster, Polaris, Cube, etc.) |
| Plugin Architecture | Plugin system design and entry point registration |
| Opinionation Boundaries | What’s enforced vs pluggable |
| Interfaces | Abstract Base Classes for all plugin types |
| Platform Artifacts | OCI registry storage for platform configurations |
| Storage Integration | Object storage (MinIO/S3/GCS/Azure) + Iceberg |
| OCI Registry Requirements | Registry configuration, signing, air-gapped deployment |
Architecture Decision Records
Section titled “Architecture Decision Records”See ADR Index for all Architecture Decision Records.
Key ADRs
Section titled “Key ADRs”| ADR | Decision |
|---|---|
| 0016 | Four-layer architecture with compile-time enforcement |
| 0018 | Enforced (Iceberg, dbt, K8s) vs Pluggable (compute, orchestrator) |
| 0021 | Medallion default, Data Mesh support |
| 0022 | Security: RBAC, network policies, pod security |
| 0023 | Secrets: K8s Secrets, ESO, Vault backends |
| 0024 | Identity: Keycloak default, pluggable IdPs |