9 Core Architecture & Design – BeaverDB: The Complete Guide

# 9 Core Architecture & Design

Chapter Outline:

- 9.1. Guiding Principles (Developer Focus)
  - A deeper dive into the “Why” from `design.md`.
  - Standard SQLite Compatibility as a “no-magic” rule.
  - Convention over Configuration.
- 9.2. The Manager Delegation Pattern
  - How `BeaverDB` acts as a factory.
  - How managers (e.g., `DictManager`) are initialized with a reference to the core `BeaverDB` connection pool.
  - How all tables are prefixed with `beaver_` to avoid user-space conflicts.
- 9.3. Type-Safe Models (`beaver.Model`)
  - Using the `model=...` parameter for automatic serialization and deserialization.
  - Inheriting from `beaver.Model` for a lightweight, Pydantic-compatible solution.