# Sandloom

> Python backend framework for AI-driven development. Enforced module boundaries, pluggable infrastructure, and monolith-to-services deployment without rewriting business modules.

Sandloom is a Python backend framework for AI-driven development with enforced module boundaries and pluggable infrastructure. Public API: `sandloom.sdk`. Start with Getting Started; contributor guidance is optional context.

## Home

- [Overview](<https://sandloom.dev/docs/index.md>)
- [How Sandloom works](<https://sandloom.dev/docs/architecture/index.md>)
- [Release Notes](<https://sandloom.dev/docs/changelog/index.md>)
- [Help](<https://sandloom.dev/docs/getting-started/help/index.md>)

## Getting Started

- [Quickstart](<https://sandloom.dev/docs/getting-started/index.md>)
- [Your project structure](<https://sandloom.dev/docs/getting-started/project-structure/index.md>)
- [Tutorial: your first feature](<https://sandloom.dev/docs/getting-started/tutorial/index.md>)
- [Installation](<https://sandloom.dev/docs/getting-started/installation/index.md>)
- [Glossary](<https://sandloom.dev/docs/getting-started/glossary/index.md>)

## Toolchain

- [The toolchain](<https://sandloom.dev/docs/toolchain/index.md>)
- [Generators](<https://sandloom.dev/docs/toolchain/generators/index.md>)
- [Generate contracts and snapshots](<https://sandloom.dev/docs/toolchain/generate/index.md>)
- [Agent tooling](<https://sandloom.dev/docs/toolchain/agent-tooling/index.md>)
- [Module context for agents](<https://sandloom.dev/docs/toolchain/module-context/index.md>)
- [Explore the architecture graph](<https://sandloom.dev/docs/toolchain/architecture-graph/index.md>)
- [Checks](<https://sandloom.dev/docs/toolchain/checks/index.md>)
- [Testing modules](<https://sandloom.dev/docs/toolchain/testing/index.md>)

## Modules

- [What a module is](<https://sandloom.dev/docs/modules/index.md>)
- [Add a module](<https://sandloom.dev/docs/modules/create/index.md>)
- [Units of work and db()](<https://sandloom.dev/docs/modules/database/units/index.md>)
- [Multi-tenancy](<https://sandloom.dev/docs/modules/database/multi-tenancy/index.md>)
- [Timestamps, ids and list order](<https://sandloom.dev/docs/modules/database/conventions/index.md>)
- [How migrations work](<https://sandloom.dev/docs/modules/database/migrations/index.md>)
- [Write a migration](<https://sandloom.dev/docs/modules/database/write-migration/index.md>)
- [Run migrations](<https://sandloom.dev/docs/modules/database/run-migrations/index.md>)
- [Route policy and sessions](<https://sandloom.dev/docs/modules/http/route-policy/index.md>)
- [Authorization and billing subjects](<https://sandloom.dev/docs/modules/http/authorization/index.md>)
- [Make a write idempotent](<https://sandloom.dev/docs/modules/http/idempotent-write/index.md>)
- [Revoke sessions](<https://sandloom.dev/docs/modules/http/session-revocation/index.md>)
- [Audit](<https://sandloom.dev/docs/modules/http/audit/index.md>)
- [Choose how modules talk](<https://sandloom.dev/docs/modules/between/index.md>)
- [How events work](<https://sandloom.dev/docs/modules/between/events/index.md>)
- [Add an event](<https://sandloom.dev/docs/modules/between/add-event/index.md>)
- [Consume an event](<https://sandloom.dev/docs/modules/between/add-consumer/index.md>)
- [Change an event payload (v1 → v2)](<https://sandloom.dev/docs/modules/between/event-versioning/index.md>)
- [How contracts work](<https://sandloom.dev/docs/modules/between/contracts/index.md>)
- [Provide and call a contract](<https://sandloom.dev/docs/modules/between/add-contract/index.md>)
- [How projections work](<https://sandloom.dev/docs/modules/between/projections/index.md>)
- [Build a projection](<https://sandloom.dev/docs/modules/between/add-projection/index.md>)
- [How sagas work](<https://sandloom.dev/docs/modules/between/sagas/index.md>)
- [Add a saga](<https://sandloom.dev/docs/modules/between/add-saga/index.md>)
- [Background tasks](<https://sandloom.dev/docs/modules/background/tasks/index.md>)
- [Deduplicate effects](<https://sandloom.dev/docs/modules/background/effect-deduplication/index.md>)
- [Overview](<https://sandloom.dev/docs/modules/standard/index.md>)
- [Identity](<https://sandloom.dev/docs/modules/standard/identity/index.md>)
- [Get your first access token](<https://sandloom.dev/docs/modules/standard/first-access-token/index.md>)
- [Tenancy](<https://sandloom.dev/docs/modules/standard/tenancy/index.md>)
- [Billing](<https://sandloom.dev/docs/modules/standard/billing/index.md>)
- [Customize a standard module](<https://sandloom.dev/docs/modules/standard/customize/index.md>)
- [SSO setup](<https://sandloom.dev/docs/modules/standard/sso/index.md>)
- [Guarantees and labels](<https://sandloom.dev/docs/modules/guarantees/index.md>)
- [Write admission](<https://sandloom.dev/docs/modules/guarantees/write-admission/index.md>)
- [Transaction and replay lifecycle](<https://sandloom.dev/docs/modules/guarantees/lifecycle/index.md>)
- [Module internals](<https://sandloom.dev/docs/modules/guarantees/module-internals/index.md>)

## Infrastructure

- [Overview](<https://sandloom.dev/docs/infrastructure/index.md>)
- [Configure backends](<https://sandloom.dev/docs/infrastructure/configure/index.md>)
- [Database](<https://sandloom.dev/docs/infrastructure/database/index.md>)
- [Cache](<https://sandloom.dev/docs/infrastructure/cache/index.md>)
- [Event bus](<https://sandloom.dev/docs/infrastructure/event-bus/index.md>)
- [Task queue](<https://sandloom.dev/docs/infrastructure/task-queue/index.md>)
- [Object store](<https://sandloom.dev/docs/infrastructure/object-store/index.md>)
- [Notifications](<https://sandloom.dev/docs/infrastructure/notifications/index.md>)
- [Write a driver](<https://sandloom.dev/docs/infrastructure/write-a-driver/index.md>)
- [Add your own capability](<https://sandloom.dev/docs/infrastructure/own-capability/index.md>)
- [Driver kit reference](<https://sandloom.dev/docs/infrastructure/driverkit/index.md>)

## Operate

- [What it is and how to run it](<https://sandloom.dev/docs/admin-console/index.md>)
- [Add your module](<https://sandloom.dev/docs/admin-console/add-your-module/index.md>)
- [Deploy](<https://sandloom.dev/docs/admin-console/deploy/index.md>)
- [Declaration reference](<https://sandloom.dev/docs/admin-console/declarations/index.md>)
- [Develop the console](<https://sandloom.dev/docs/admin-console/develop/index.md>)
- [Operate](<https://sandloom.dev/docs/operate/index.md>)
- [Topologies](<https://sandloom.dev/docs/operate/topologies/index.md>)
- [Deploy](<https://sandloom.dev/docs/operate/deploy/index.md>)
- [Split into services](<https://sandloom.dev/docs/operate/split-into-services/index.md>)
- [Service RPC](<https://sandloom.dev/docs/operate/service-rpc/index.md>)
- [Loader configuration](<https://sandloom.dev/docs/operate/loader-configuration/index.md>)
- [Runbook](<https://sandloom.dev/docs/operate/runbook/index.md>)
- [Operator reference](<https://sandloom.dev/docs/operate/operator-reference/index.md>)
- [Upgrade an application](<https://sandloom.dev/docs/operate/upgrade/index.md>)
- [Upgrading to Public API 1.0](<https://sandloom.dev/docs/operate/upgrade-1.0/index.md>)

## Reference

- [Reference](<https://sandloom.dev/docs/reference/index.md>)
- [sandloom.sdk](<https://sandloom.dev/docs/reference/sdk/index.md>)
- [sandloom.sdk.module](<https://sandloom.dev/docs/reference/sdk/module/index.md>)
- [sandloom.sdk.web](<https://sandloom.dev/docs/reference/sdk/web/index.md>)
- [sandloom.sdk.data](<https://sandloom.dev/docs/reference/sdk/data/index.md>)
- [sandloom.sdk.tenant](<https://sandloom.dev/docs/reference/sdk/tenant/index.md>)
- [sandloom.sdk.events](<https://sandloom.dev/docs/reference/sdk/events/index.md>)
- [sandloom.sdk.effects](<https://sandloom.dev/docs/reference/sdk/effects/index.md>)
- [sandloom.sdk.tasks](<https://sandloom.dev/docs/reference/sdk/tasks/index.md>)
- [sandloom.sdk.contracts](<https://sandloom.dev/docs/reference/sdk/contracts/index.md>)
- [sandloom.sdk.authz](<https://sandloom.dev/docs/reference/sdk/authz/index.md>)
- [sandloom.sdk.sagas](<https://sandloom.dev/docs/reference/sdk/sagas/index.md>)
- [sandloom.sdk.projections](<https://sandloom.dev/docs/reference/sdk/projections/index.md>)
- [sandloom.sdk.infra](<https://sandloom.dev/docs/reference/sdk/infra/index.md>)
- [sandloom.sdk.security](<https://sandloom.dev/docs/reference/sdk/security/index.md>)
- [sandloom.sdk.errors](<https://sandloom.dev/docs/reference/sdk/errors/index.md>)
- [sandloom.sdk.app](<https://sandloom.dev/docs/reference/sdk/app/index.md>)
- [sandloom.sdk.migrations](<https://sandloom.dev/docs/reference/sdk/migrations/index.md>)
- [sandloom.sdk.tooling](<https://sandloom.dev/docs/reference/sdk/tooling/index.md>)
- [sandloom.sdk.testing](<https://sandloom.dev/docs/reference/sdk/testing/index.md>)
- [sandloom.sdk.testing.fixtures](<https://sandloom.dev/docs/reference/sdk/testing/fixtures/index.md>)
- [sandloom.sdk.testing.plugin](<https://sandloom.dev/docs/reference/sdk/testing/plugin/index.md>)
- [Error catalogue](<https://sandloom.dev/docs/reference/error-codes/index.md>)
- [Testing (copy-paste)](<https://sandloom.dev/docs/reference/testing/index.md>)
- [CLI](<https://sandloom.dev/docs/reference/cli/index.md>)
- [Configuration](<https://sandloom.dev/docs/reference/configuration/index.md>)
- [Configuration tiers](<https://sandloom.dev/docs/reference/configuration-tiers/index.md>)
- [Routes](<https://sandloom.dev/docs/reference/routes/index.md>)
- [Event contracts](<https://sandloom.dev/docs/reference/event-contracts/index.md>)
- [Security model](<https://sandloom.dev/docs/reference/security-model/index.md>)
- [Guarantees and capabilities](<https://sandloom.dev/docs/reference/guarantees/index.md>)
- [Execution planner](<https://sandloom.dev/docs/reference/execution-planner/index.md>)
- [SLOs](<https://sandloom.dev/docs/reference/slo/index.md>)
- [Dependency stack](<https://sandloom.dev/docs/reference/dependencies/index.md>)

## Optional

- [Contribution Guide](<https://sandloom.dev/docs/contributing/index.md>)
- [Set up the repository](<https://sandloom.dev/docs/contributing/setup/index.md>)
- [Repository map and agent tooling](<https://sandloom.dev/docs/contributing/repository/index.md>)
- [Source snapshot policy](<https://sandloom.dev/docs/contributing/source-export/index.md>)
- [Website publishing](<https://sandloom.dev/docs/contributing/website/index.md>)
- [Versioning policy](<https://sandloom.dev/docs/contributing/versioning/index.md>)
- [Local CI runner](<https://sandloom.dev/docs/contributing/local-ci/index.md>)
- [Supply-chain gates](<https://sandloom.dev/docs/contributing/supply-chain/index.md>)
- [Lint policy](<https://sandloom.dev/docs/contributing/lint-policy/index.md>)
- [Architecture Decision Records](<https://sandloom.dev/docs/adr/index.md>)
- [ADR-0001: Framework Distribution](<https://sandloom.dev/docs/adr/0001-framework-distribution/index.md>)
- [ADR-0002: Framework Absorbs Module Boilerplate](<https://sandloom.dev/docs/adr/0002-framework-absorbs-module-boilerplate/index.md>)
- [ADR-0003: Fewer Sync RPC Calls (Membership)](<https://sandloom.dev/docs/adr/0003-fewer-sync-rpc-membership-reads/index.md>)
- [ADR-0004: Pair-MAC RPC](<https://sandloom.dev/docs/adr/0004-rpc-pair-mac-request-authentication/index.md>)
- [ADR-0005: Effect Model](<https://sandloom.dev/docs/adr/0005-effect-model/index.md>)
- [ADR-0006: Accepted Risks](<https://sandloom.dev/docs/adr/0006-accepted-risks/index.md>)
- [ADR-0007: Kernel Layers](<https://sandloom.dev/docs/adr/0007-kernel-layers/index.md>)
- [ADR-0008: Sagas](<https://sandloom.dev/docs/adr/0008-sagas/index.md>)
- [ADR-0009: Route Policy and Session Freshness](<https://sandloom.dev/docs/adr/0009-route-policy-and-session-freshness/index.md>)
- [ADR-0010: Public API 1.0](<https://sandloom.dev/docs/adr/0010-public-api-1.0/index.md>)
- [ADR-0011: The driver API](<https://sandloom.dev/docs/adr/0011-driver-api/index.md>)
- [Operator guide](<https://sandloom.dev/docs/admin-console/operations/index.md>)