These pages explain the ideas, design decisions, and trade-offs behind the Artisan framework. Start with the Architecture Overview for the big picture, then explore topics relevant to your work.
System Architecture¶
Architecture Overview -- High-level system structure and component relationships
Operations Model -- Why Creators and Curators, the three-phase execution model, and the spec system
Composites and Composition -- Reusable compositions of operations with collapsed and expanded execution
Artifacts and Content Addressing -- Immutable artifacts and hash-based identity
Data and Tracking¶
Provenance System -- Dual provenance: execution and artifact lineage tracking
Execution Flow -- Dispatch, execute, commit lifecycle
Storage and Delta Lake -- Why Delta Lake for artifact persistence
Design Rationale¶
Design Principles -- Motivating goals and the design decisions behind the framework
Error Handling -- Fail-fast philosophy and error propagation
Cross-references¶
Tutorials -- Hands-on walkthroughs that demonstrate these concepts in practice
How-to Guides -- Task-oriented instructions that apply these concepts
Reference -- API details and schema specifications for the types described here