Decisions

This directory contains Architecture Decision Records documenting significant architectural decisions for the ML Pipelines platform.

Active Decisions

• ADR-001: Four-Tier Deployment Architecture

• ADR-002: Unity Catalog Isolation

• ADR-003: Service Principal Per Environment with GitHub OIDC

• ADR-004: Neon Database Replication vs. Live Querying

How to Use This Directory

When making significant architectural decisions:

1. Copy the ADR template

2. Number it sequentially (ADR-XXX)

3. Fill in all sections with thorough analysis

4. Include concrete implementation details

5. Document alternatives considered and why rejected

6. Update this README to include the new ADR

Decision Categories

Infrastructure & Deployment:

• ADR-001: Four-Tier Deployment Architecture

• ADR-003: Service Principal Per Environment with GitHub OIDC

Data Architecture:

• ADR-002: Unity Catalog Isolation

• ADR-004: Neon Database Replication vs. Live Querying

ADR Lifecycle

Statuses:

• Proposed: Under review, not yet implemented

• Accepted: Approved and being implemented

• Deprecated: No longer recommended, but still in use

• Superseded: Replaced by a newer decision (link to replacement)