docs: update portainer env example and metadata tasks status

Author: joonsoome

.env.portainer.example

@@ -1,8 +1,27 @@
-# GHCR images (override tags if needed) — default to a pinned release tag
+# Portainer stack environment (example values). Copy to `.env.portainer` for Portainer UI deployment.
+
+# GHCR images to deploy (choose tags built by CI) — default to a pinned release tag
 PDF_PROXY_IMAGE=ghcr.io/joonsoome/on-prem-zotero-webui/pdf-proxy:v0.1.1
 WEB_LIBRARY_IMAGE=ghcr.io/joonsoome/on-prem-zotero-webui/web-library:v0.1.1
 
-# Host bindings
+# 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
+
+# Metadata source (used at build time for the Web Library image)
+# If you host metadata on zotero.org (default):
+#   ZOTERO_API_KEY: your Zotero API key
+#   ZOTERO_API_AUTHORITY_PART: api.zotero.org
+# If you host metadata on-prem (custom API host):
+#   ZOTERO_API_KEY: on-prem API token (if required)
+#   ZOTERO_API_AUTHORITY_PART: e.g., nas.local:8080 (your on-prem metadata host)
+ZOTERO_API_KEY=changeme-zotero-api-key
+ZOTERO_API_AUTHORITY_PART=api.zotero.org
+ZOTERO_USER_SLUG=changeme-user-slug
+ZOTERO_USER_ID=1234567

openspec/changes/add-onprem-metadata-source/tasks.md

@@ -1,11 +1,11 @@
 ## 1. Discovery
-- [ ] 1.1 Review upstream `zotero/web-library` config to identify metadata endpoint/auth settings (zotero.org defaults, API keys, user/group config).
-- [ ] 1.2 Check overlay code for existing overrides (e.g., pdf proxy base, userSlug/userId) and note gaps for metadata endpoint selection.
+- [x] 1.1 Review upstream `zotero/web-library` config to identify metadata endpoint/auth settings (zotero.org defaults, API keys, user/group config).
+- [x] 1.2 Check overlay code for existing overrides (e.g., pdf proxy base, userSlug/userId) and note gaps for metadata endpoint selection.
 
 ## 2. On-prem metadata option
-- [ ] 2.1 Define how to point Web Library to an on-prem metadata backend (e.g., Zotero API proxy/self-hosted sync target on Synology) and document required env vars.
-- [ ] 2.2 Add overlay config/hooks to select metadata source via env (e.g., `METADATA_BASE_URL`, `ZOTERO_API_KEY`), including zotero.org fallback.
-- [ ] 2.3 Provide staging defaults (Synology) in env examples and Compose notes.
+- [x] 2.1 Define how to point Web Library to an on-prem metadata backend (e.g., Zotero API proxy/self-hosted sync target on Synology) and document required env vars.
+- [x] 2.2 Add overlay config/hooks to select metadata source via env (e.g., `METADATA_BASE_URL`, `ZOTERO_API_KEY`), including zotero.org fallback.
+- [x] 2.3 Provide staging defaults (Synology) in env examples and Compose notes.
 
 ## 3. Validation
 - [ ] 3.1 Manual check: Web Library loads collections/items from the chosen metadata source (on-prem vs zotero.org) while attachments remain WebDAV.