docs: add env templates and README

Author: joonsoome

.env.dev.example

@@ -1,6 +1,10 @@
 # Local dev/test environment configuration (example values).
 # Copy this file to `.env.dev` and adjust as needed.
 
+# Images built locally by the dev compose stack (build + tag with these names)
+PDF_PROXY_IMAGE=ghcr.io/joonsoome/on-prem-zotero-webui/pdf-proxy:dev
+WEB_LIBRARY_IMAGE=ghcr.io/joonsoome/on-prem-zotero-webui/web-library:dev
+
 # Host path for synthetic/sample Zotero WebDAV data used in dev.
 # The default `./sample-webdav/zotero` will be populated by scripts/generate-sample-webdav.py
 DEV_ZOTERO_SAMPLE_ROOT=./sample-webdav/zotero
@@ -9,9 +13,6 @@ DEV_ZOTERO_SAMPLE_ROOT=./sample-webdav/zotero
 DEV_PDF_PROXY_PORT=8280
 DEV_WEB_LIBRARY_PORT=8281
 
-# Web Library image built from subtree + overlay (build with scripts/build-web-library-image.sh)
-WEB_LIBRARY_IMAGE=zotero-web-library:dev
-
 # Base URL that Web Library should use for opening PDFs via the proxy.
 # In local dev this is typically http://localhost:8280/pdf
 DEV_PDF_PROXY_BASE_URL=http://localhost:8280/pdf

.env.stage.example

@@ -0,0 +1,15 @@
+# Staging/NAS environment configuration (example values). Copy to `.env.stage` on the staging host.
+
+# GHCR images to deploy (choose tags built by CI)
+PDF_PROXY_IMAGE=ghcr.io/joonsoome/on-prem-zotero-webui/pdf-proxy:main
+WEB_LIBRARY_IMAGE=ghcr.io/joonsoome/on-prem-zotero-webui/web-library:main
+
+# Host path for Zotero WebDAV data mounted into the proxy container
+ZOTERO_ROOT_HOST_PATH=/volume1/Reference/zotero
+
+# Host ports exposed by the stack
+PDF_PROXY_PORT=8280
+WEB_LIBRARY_PORT=8281
+
+# Base URL that the Web Library should use when linking to the PDF proxy (update to your staging hostname/IP)
+PDF_PROXY_BASE_URL=http://nas.local:8280/pdf

.gitignore

@@ -136,6 +136,9 @@ celerybeat.pid
 
 # Environments
 .env
+.env.dev
+.env.stage
+.env.portainer
 .envrc
 .venv
 env/
@@ -212,4 +215,4 @@ README-draft.md
 .vscode/
 openspec/
 sample-webdav/
-app/web-library-build/
+app/web-library-build/