Serve backend reads over a server-to-server endpoint, with a Diesel wrapper

.dockerignore

@@ -1,6 +1,9 @@
-# The image is built from the manifest and the sources alone.
+# The images are built from the manifests and the sources alone: the
+# workspace's crates are part of the manifest, their build output is not.
 *
 !Cargo.toml
 !Cargo.lock
 !clippy.toml
 !src
+!crates
+crates/*/target

.github/workflows/ci-pr.yml

@@ -46,14 +46,17 @@ jobs:
       - name: Install rust cache
         uses: Swatinem/rust-cache@v2.7.7
 
-      - name: Clippy, warnings denied
-        run: cargo clippy --all-targets --locked -- -D warnings
+      - name: Clippy, warnings denied, every crate of the workspace
+        run: cargo clippy --workspace --all-targets --locked -- -D warnings
 
   test:
     name: Tests (accuracy)
     runs-on: ubuntu-latest
     env:
       STREAMGRES_PG_DSN: postgresql://postgres:postgres@localhost:5432/postgres
+      # The Diesel wrapper's and the demo's tests read and write their own
+      # tables in the same database.
+      DATABASE_URL: postgresql://postgres:postgres@localhost:5432/postgres
     steps:
       - name: Checkout repository
         uses: actions/checkout@v4
@@ -77,8 +80,8 @@ jobs:
             -c wal_level=logical -c max_replication_slots=32 -c max_wal_senders=32
           until docker exec pg pg_isready -U postgres; do sleep 1; done
 
-      - name: Unit, scenario, randomized and live PostgreSQL tests
-        run: cargo test --release --locked
+      - name: Unit, scenario, randomized and live PostgreSQL tests, every crate
+        run: cargo test --release --locked --workspace
 
   perf:
     name: Benchmark against the base branch (performance)

CONTRIBUTING.md

@@ -31,22 +31,24 @@ Build and test:
 
 ```bash
 cargo build
-cargo test                          # unit and scenario tests
-cargo clippy --all-targets -- -D warnings
+cargo test --workspace              # unit and scenario tests, every crate
+cargo clippy --workspace --all-targets -- -D warnings
 cargo run --bin streamgres           # Streamgres demo: every check must end in PASS
 cargo run --release --bin bench     # benchmarks
 cargo run --release --bin load      # the server over the wire: latency, cores, memory (needs STREAMGRES_PG_DSN)
 ```
 
 The tests against a real PostgreSQL run when `STREAMGRES_PG_DSN` is set and
-report themselves skipped otherwise. To run them the way CI does:
+report themselves skipped otherwise; the Diesel wrapper's and the demo's
+tests read `DATABASE_URL`. To run them the way CI does:
 
 ```bash
 docker run -d --name pg -e POSTGRES_PASSWORD=postgres -p 5432:5432 postgres:17 \
   -c wal_level=logical -c max_replication_slots=32 -c max_wal_senders=32
 
 STREAMGRES_PG_DSN=postgresql://postgres:postgres@localhost:5432/postgres \
-  cargo test --release
+DATABASE_URL=postgresql://postgres:postgres@localhost:5432/postgres \
+  cargo test --release --workspace
 ```
 
 To run the server locally, follow the [Quick start](README.md#quick-start) in
@@ -58,8 +60,8 @@ Every pull request runs:
 
 | Job | What it runs |
 | --- | --- |
-| Lints | `cargo clippy --all-targets --locked -- -D warnings` |
-| Tests | `cargo test --release --locked` against PostgreSQL 17 |
+| Lints | `cargo clippy --workspace --all-targets --locked -- -D warnings` |
+| Tests | `cargo test --release --locked --workspace` against PostgreSQL 17 |
 | Benchmark | `bench` on your branch and the base branch, five alternating rounds, compared by `scripts/bench-compare.py` |
 | Image | builds `docker/server/Dockerfile` and drives it end to end with `scripts/smoke.mjs` |