📝 Add mail and file upload guides

Document pagetop-mail (configuration, templates, layout, previews,
queue and tests with the outbox) and file uploads (`web::Upload`,
`form::File`, `web::Download` and the [upload] settings). doccheck
enables the mail queue, keeps mail in memory and saves uploads under
`target/`.
This commit is contained in:
Manuel Cillero 2026-11-02 17:29:37 +01:00
parent 4e007feec8
commit f42f5e9b89
13 changed files with 1118 additions and 8 deletions

View file

@ -95,12 +95,13 @@ When writing a chapter:
```` ```rust,no_run ```` for the rest, and ```` ```rust,ignore ```` only for loose fragments
that are not valid on their own.
- Examples can use `pagetop`, `pagetop-admin`, `pagetop-bootsier`, `pagetop-cron`,
`pagetop-htmx`, `pagetop-mail`, `pagetop-seaorm` (with SQLite), `pagetop-user`, `pagetop-build`,
`serde`, `thiserror`, `tokio` and `tower-http` (with the `compression-gzip`, `cors`, `limit` and
`timeout` features); the translations in `tools/doccheck/src/locale/` (`LOCALES_APP`), and a
static files bundle named `app`. If a chapter needs anything else, add it to `tools/doccheck`.
`pagetop-htmx`, `pagetop-mail` (with its `queue` feature), `pagetop-seaorm` (with SQLite),
`pagetop-user`, `pagetop-build`, `serde`, `thiserror`, `tokio` and `tower-http` (with the
`compression-gzip`, `cors`, `limit` and `timeout` features); the translations in
`tools/doccheck/src/locale/` (`LOCALES_APP`), and a static files bundle named `app`. If a chapter needs anything else, add it to `tools/doccheck`.
- Examples and tests that start an application read `tools/doccheck/config/`: those with a database
get a new in-memory SQLite one on every run.
get a new in-memory SQLite one on every run, mail is kept in memory (`pagetop_mail::outbox`) and
uploaded files go to `tools/doccheck/target/doccheck-uploads`.
- Tests that share state (a static store, a database) run in the same process: write one test per
flow, so that their results do not depend on the order they run in.