pique/_docs/decisions
Nicole Tietz-Sokolskaya 65ad20d197 Switch DB layer to Diesel from SeaORM and Fjall (#2)
Refactors Pique to use Diesel for the backing database layer instead of the previous choices of SeaORM and Fjall (with a custom DB on top of the KV store). This choice was made to speed up development. I found SeaORM much more challenging to discover things in than Diesel, and with Fjall I was getting mired in building things that already exist. This is a migration to a boring choice, and that's the right decision for this moment in time.

Among other things, the diff stats wind up being `47 files changed, 926 insertions(+), 950 deletions(-)` when you exclude lockfile changes and markdown changes. This validates that the code is not significantly more or less verbose, but is simply structured differently. So we're not giving anything up in brevity.

I decided to structure query calls into their own submodules, called `q` (short for `query`). I shortened the names to make it easier to type and make lines shorter, which may be a controversial take, but I think that it will wind up being worth it and will be easy to get used to.

I also renamed `Context` to `Provider`, because I think `Context` implies things like cancellation, while `Provider` implies giving access to resources, which is more precisely what's going on here.

Reviewed-on: #2
2024-06-02 18:37:15 +00:00
..
0001-record-architecture-decisions.md Add ADR for our choice of SQLite as our primary database, 2024-03-16 11:12:46 -04:00
0002-primary-database-choice.md Add ADR for our choice of SQLite as our primary database, 2024-03-16 11:12:46 -04:00
0003-use-tailwind-for-css.md Create web skeleton, including Tailwind for CSS and hot reloading of CSS 2024-03-23 12:43:02 -04:00
0004-uuids-for-primary-keys.md Switch DB layer to Diesel from SeaORM and Fjall (#2) 2024-06-02 18:37:15 +00:00