Skip to content
Foundry

System Development Tutorial

Foundry is built on three core principles:

  • Framework-Application Decoupling: Build in your own Git repository, consume Foundry via Cargo, upgrade upstream with zero conflicts
  • Convention over Configuration: Standard patterns for routing, validation, persistence, and security
  • High Cohesion, Loose Coupling: Self-contained subsystems with clear boundaries

This tutorial organizes system development into 11 focused chapters, providing a structured guide for building enterprise-grade backend systems.

Tutorial Chapters

Section titled “Tutorial Chapters”
flowchart TD
    subgraph S1["Foundations & Architecture"]
        C1["Architecture & Request Lifecycle"]
        C2["Routing System & Namespaces"]
    end


    subgraph S2["Request Handling Layer"]
        C3["Controllers & Response Envelope"]
        C4["Request Validation & DTOs"]
    end


    subgraph S3["Data Persistence"]
        C5["Database Setup & Code-First ORM"]
        C6["Zero-DDL Dynamic Models & Auto-CRUD"]
    end


    subgraph S4["Security & Extensions"]
        C7["Authentication & Hierarchical RBAC"]
        C8["Lifecycle Mutation Hooks"]
        C9["Admin Console & postMessage SDK"]
    end


    subgraph S5["Walkthrough & Production"]
        C10["Hands-on Walkthrough: E-Commerce"]
        C11["Architectural Best Practices"]
    end


    S1 --> S2 --> S3 --> S4 --> S5

Quick Index

Section titled “Quick Index”
Chapter Title Focus Components
01 Architecture & Request Lifecycle Decoupling, HTTP flow, Facade Architecture, Lifecycle, Prelude
02 Routing System & Namespaces Unified namespace, route registration Routes, Namespaces, Methods
03 Controllers & Response Envelope Axum handlers, Extractors, ApiResponse Handlers, Extractors, Output
04 Request Validation & DTOs Derive(Validate), HTTP 422 Validators, Compile-time Rules
05 Database Setup & Code-First ORM Multi-DB SPI, EntitySchema, Query Builder Multi-DB, Schema, Queries
06 Zero-DDL Dynamic Models & Auto-CRUD Schema-free models, RecordStore API Dynamic Models, RecordStore, Auto-CRUD
07 Authentication & Hierarchical RBAC IAM, Argon2id, JWT, RBAC IAM, Argon2id, JWT, RBAC
08 Lifecycle Mutation Hooks MutationHook pipeline, 6 events Pre/Post Hooks, Invalidation
09 Admin Console & postMessage SDK React Admin, sandboxed views Admin Shell, Sandboxed Views
10 Walkthrough: E-Commerce System End-to-end implementation E-Commerce, Tests
11 Architectural Best Practices Layering, performance, Docker Layering, Performance, Docker

Web Architecture Mapping

Section titled “Web Architecture Mapping”
Concept Foundry Advantages
Application Module src/systems/<slug>/ Subsystem High cohesion, strict boundary
Module Routes SubsystemModule::register_routes Auto-prefixed namespace
Controllers Axum Handler Functions Fearless concurrency
Request Input Query/Json/Path Extractors Compile-time safety
Validator DTOs #[derive(Validate)] DTOs Compile-time annotations
Query Builder OrmSelect::from_table()->... Multi-dialect support
Insert/Update OrmInsert / OrmUpdate SQL injection prevention
Middleware Tower / Axum Middleware Request tracing & audit
Lifecycle Hooks MutationHook Traits Pre/post mutation pipeline
Section titled “Recommended Learning Path”

Begin with Architecture & Request Lifecycle