Update Schoolhouse and backup docs to live state

This commit is contained in:
Fizzlepoof
2026-05-16 15:54:20 +00:00
parent 5c889f108e
commit 8e705b8865
3 changed files with 23 additions and 28 deletions

View File

@@ -31,11 +31,9 @@ Do not run production from an agent workspace.
## Current state
This is an implementation scaffold with:
The app is live on NOMAD at `/opt/doris-schoolhouse` and uses shared Postgres in production.
## Current local persistence
Until the full shared-Postgres integration is wired, the scaffold uses JSON state files for fast local iteration:
For local iteration, the source tree still supports a JSON-backed mode:
- default state dir: `/data/state`
- default upload temp dir: `/data/uploads`
@@ -47,18 +45,15 @@ export SCHOOLHOUSE_STATE_DIR=/tmp/doris-schoolhouse-state
export UPLOAD_TMP_DIR=/tmp/doris-schoolhouse-uploads
```
Production target remains shared Postgres plus Paperless/n8n integration.
Production runtime uses shared Postgres plus Paperless/n8n integration.
`SCHOOLHOUSE_STORAGE_BACKEND=auto` prefers Postgres when psycopg and a PostgreSQL DSN are available, and falls back to JSON state for local iteration.
- route stubs
- templates
- schema draft
Repo contents still include:
- route handlers and templates
- schema/bootstrap helpers
- compose/env examples
- D2L / Paperless integration placeholders
It is not deployed yet.
- D2L / Paperless / n8n integration code
## Layout
@@ -159,7 +154,7 @@ That image includes:
So even if the host is missing `ffmpeg`, the containerized runtime can still do WAV → MP3 conversion.
## Future deploy shape
## Deploy shape
Expected live deploy flow on NOMAD:
@@ -172,7 +167,7 @@ docker compose --env-file .env config
docker compose --env-file .env up -d --build
```
Not doing that yet. No live deployment should happen without explicit rollout work.
That flow is the reference for refreshing the live runtime from repo source.
## Live integration notes