Skip to content

Commit a60baad

Browse files
committed
chore: add on-prem metadata source change tasks
1 parent ea63625 commit a60baad

File tree

2 files changed

+26
-0
lines changed

2 files changed

+26
-0
lines changed
Lines changed: 14 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,14 @@
1+
# Change: On-prem metadata source configuration for Web Library
2+
3+
## Why
4+
- Current setup keeps Zotero metadata on zotero.org while attachments live on WebDAV, creating ambiguity and dependence on cloud metadata.
5+
- We need a way to point the on-prem Web Library overlay to a self-hosted metadata source (Synology) or, if still using zotero.org, clearly configure API keys/endpoints.
6+
7+
## What Changes
8+
- Investigate and document how the upstream Web Library config handles metadata endpoints/auth.
9+
- Add overlay configuration to select between zotero.org metadata and on-prem metadata service.
10+
- Provide env-based defaults and staging instructions for Synology-hosted metadata.
11+
12+
## Impact
13+
- Affected code: Web Library overlay config and deployment env files.
14+
- Affected specs: add/update deployment/metadata capability to reflect on-prem metadata sourcing.
Lines changed: 12 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,12 @@
1+
## 1. Discovery
2+
- [ ] 1.1 Review upstream `zotero/web-library` config to identify metadata endpoint/auth settings (zotero.org defaults, API keys, user/group config).
3+
- [ ] 1.2 Check overlay code for existing overrides (e.g., pdf proxy base, userSlug/userId) and note gaps for metadata endpoint selection.
4+
5+
## 2. On-prem metadata option
6+
- [ ] 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.
7+
- [ ] 2.2 Add overlay config/hooks to select metadata source via env (e.g., `METADATA_BASE_URL`, `ZOTERO_API_KEY`), including zotero.org fallback.
8+
- [ ] 2.3 Provide staging defaults (Synology) in env examples and Compose notes.
9+
10+
## 3. Validation
11+
- [ ] 3.1 Manual check: Web Library loads collections/items from the chosen metadata source (on-prem vs zotero.org) while attachments remain WebDAV.
12+
- [ ] 3.2 Update docs/OpenSpec spec delta to capture the metadata-source selection requirement and scenarios.

0 commit comments

Comments
 (0)