sap-drawio: add 'Sketch to SAP BTP' custom-store app (FastAPI+React, single-port, seed-on-first-run SQLite, exposed via auto-SSO)

2026-07-22 09:01:10 -07:00
parent e35d5589b6
commit 5f6499125a
6 changed files with 244 additions and 0 deletions
@@ -0,0 +1,52 @@
+# sap-drawio — Build Files
+
+Image source repo (Dockerfile lives there, NOT in this store folder):
+`~/projects/sap-architecture-diagrams` (git remote `git.alexzaw.dev/alexz/sap-architecture-diagrams`).
+
+## What the image is
+
+A single multi-stage image, `git.alexzaw.dev/alexz/sap-drawio:latest`:
+
+1. **Builder stage** (`node:20-bookworm-slim`) — builds the React (CRA + CRACO,
+   Yarn Classic 1.22.22) frontend with `REACT_APP_BACKEND_URL=""` so all API
+   calls are same-origin (`/api`), working from any host/domain.
+2. **Runtime stage** (`python:3.12-slim`) — installs `backend/requirements.txt`,
+   copies `backend/` to `/app/backend` and the built UI to `/app/frontend/build`
+   (FastAPI/uvicorn serves both from one process on port 8011), bakes the
+   12 MB SQLite catalog seed to `/seed/app.db`, and runs as root (homelab —
+   avoids the non-root volume-permission trap).
+
+## How to build
+
+```bash
+cd /etc/runtipi/repos/runtipi/apps/sap-drawio/build
+./build.sh
+```
+
+Builds and pushes `git.alexzaw.dev/alexz/sap-drawio:latest`. Override
+`IMAGE_NAME` / `IMAGE_TAG` / `SRC` env vars if needed. To build without
+pushing, run the `docker build` line directly from `$SRC`.
+
+## Seed-on-first-run behavior
+
+`docker/entrypoint.sh` (in the source repo) copies `/seed/app.db` →
+`/data/app.db` only if `/data/app.db` is absent, then execs uvicorn. This
+means:
+- First install: the persistent volume (`${APP_DATA_DIR}/data` on the host)
+  gets the baked catalog (icons/services) as its starting point.
+- Every subsequent `app update`/restart: the existing `/data/app.db` (with any
+  saved conversions, added logos, etc.) is left untouched — the image rebuild
+  never overwrites live data.
+
+## LLM dependency
+
+Calls an Ollama-compatible host at `OLLAMA_URL` (form field, defaults to
+`http://192.168.0.32:11434`, this homeserver's local `ollama-nvidia` app).
+Models (`VISION_MODEL`, `VALIDATOR_MODEL`) are also form fields so they can be
+changed without a rebuild. `qwen3-vl:8b` / `gemma4:31b` must exist on the
+Ollama host for the defaults to work.
+
+## Architecture note
+
+**amd64 only.** No multi-arch build — matches the host architecture; not
+needed for this homelab deployment.