# oridecon-sql

> Async SQL for Postgres / MySQL / SQLite — repositories, migrations, query building.

Machine index for **oridecon-sql** only. Rules: https://docs.oridecon.dev/agents.md · Catalog: https://docs.oridecon.dev/llms.txt · Slices: https://docs.oridecon.dev/llms/index.txt · Skill: https://docs.oridecon.dev/SKILL.md

## Package

- Name: `oridecon-sql`
- Group: Data — SQL, NoSQL, cache, object storage, search.
- Docs: https://docs.oridecon.dev/packages/data/oridecon-sql/
- Source (branch `dev`): https://github.com/dbtinoy-/oridecon/tree/dev/packages/oridecon-sql
- This slice: https://docs.oridecon.dev/llms/oridecon-sql.txt
- Install: `uv add oridecon-sql`

## Boundaries

- Extensions import only `oridecon` and `oridecon-contracts` — never each other.
- Shared types live in `oridecon-contracts`. Do not invent a second copy here.
- Constructor injection. `register()` binds, `boot()` resolves.
- Domain failures are `Result[T, E]`. Infrastructure failures raise.
- One tree: `domains/` (not `models/`), app-root `di/` for `*_provider.py`.

## Docs in this package

- [SQL (oridecon-sql)](https://docs.oridecon.dev/packages/data/oridecon-sql/): Async SQLAlchemy ORM: repositories, unit-of-work
- [API Reference](https://docs.oridecon.dev/packages/data/oridecon-sql/api/): Complete API reference for the oridecon-sql package.
- [Architecture](https://docs.oridecon.dev/packages/data/oridecon-sql/docs/architecture/): Architecture for oridecon-sql
- [application.yaml](https://docs.oridecon.dev/packages/data/oridecon-sql/docs/backends/): application.yaml guide and reference for the oridecon-sql package in the Oridecon framework.
- [Configuration](https://docs.oridecon.dev/packages/data/oridecon-sql/docs/configuration/): Configuration for oridecon-sql
- [Guide](https://docs.oridecon.dev/packages/data/oridecon-sql/docs/guide/): Guide for oridecon-sql
- [How-To Guides](https://docs.oridecon.dev/packages/data/oridecon-sql/docs/howtos/): How-To Guides for oridecon-sql
- [Quickstart](https://docs.oridecon.dev/packages/data/oridecon-sql/docs/quickstart/): Quickstart for oridecon-sql
- [Troubleshooting](https://docs.oridecon.dev/packages/data/oridecon-sql/docs/troubleshooting/): Troubleshooting for oridecon-sql

## See also

- Playbook: https://docs.oridecon.dev/getting-started/for-coding-agents/
- Fail vs fix: https://docs.oridecon.dev/getting-started/common-mistakes/
- Group hub: https://docs.oridecon.dev/packages/data/
- Skill: https://docs.oridecon.dev/SKILL.md
- Rules (do not skip): https://docs.oridecon.dev/agents.md