chore(#276): Paperless-Config — PAPERLESS_BASE_URL + PAPERLESS_TOKEN #308

Merged
admin-mrrm merged 1 commit from feat/276-paperless-config into main 2026-05-16 14:35:12 +02:00
Owner

Summary

  • apps/api/src/config/env.ts: PAPERLESS_BASE_URL (URL) + PAPERLESS_TOKEN (String) — beide optional.
  • apps/api/.env.example: dokumentiert Compose-intern (http://paperless-webserver:8000) vs. extern (https://paperless.dev.mrrm.de).

Server-Stack (paralleler PR im server-stack-Repo)

  • stacks/dev-neu/mrrmlabapp/docker-compose.yml: api-Service erhält PAPERLESS_BASE_URL (Compose-intern) + PAPERLESS_TOKEN (Var-Ref).
  • templates/dev-neu.env.j2: neue Var MRRMLABAPP_DEV_PAPERLESS_TOKEN -> referenziert vault_mrrmlabapp_dev_paperless_token.

Manuelle Schritte vor Deploy

  1. In Paperless-Admin (https://paperless.dev.mrrm.de) API-Token generieren (Profil -> API-Tokens).
  2. Token in inventory/host_vars/dev-neu/vault.yml als vault_mrrmlabapp_dev_paperless_token hinterlegen (ansible-vault edit).
  3. Ansible-Playbook dev-neu.yml ausfuehren -> .env wird neu generiert + api-Service neu gestartet.

Test plan

  • pnpm --filter @mrrmlab/api typecheck clean
  • pnpm --filter @mrrmlab/api test 276/276 gruen
  • Nach Deploy: api-Container hat PAPERLESS_BASE_URL + PAPERLESS_TOKEN gesetzt (docker exec ... env | grep PAPERLESS_)

Refs #276 — Foundation fuer #274 (PaperlessClient).

## Summary - `apps/api/src/config/env.ts`: `PAPERLESS_BASE_URL` (URL) + `PAPERLESS_TOKEN` (String) — beide optional. - `apps/api/.env.example`: dokumentiert Compose-intern (`http://paperless-webserver:8000`) vs. extern (`https://paperless.dev.mrrm.de`). ## Server-Stack (paralleler PR im `server-stack`-Repo) - `stacks/dev-neu/mrrmlabapp/docker-compose.yml`: api-Service erhält `PAPERLESS_BASE_URL` (Compose-intern) + `PAPERLESS_TOKEN` (Var-Ref). - `templates/dev-neu.env.j2`: neue Var `MRRMLABAPP_DEV_PAPERLESS_TOKEN` -> referenziert `vault_mrrmlabapp_dev_paperless_token`. ## Manuelle Schritte vor Deploy 1. In Paperless-Admin (`https://paperless.dev.mrrm.de`) API-Token generieren (Profil -> API-Tokens). 2. Token in `inventory/host_vars/dev-neu/vault.yml` als `vault_mrrmlabapp_dev_paperless_token` hinterlegen (`ansible-vault edit`). 3. Ansible-Playbook `dev-neu.yml` ausfuehren -> .env wird neu generiert + api-Service neu gestartet. ## Test plan - [x] `pnpm --filter @mrrmlab/api typecheck` clean - [x] `pnpm --filter @mrrmlab/api test` 276/276 gruen - [ ] Nach Deploy: api-Container hat `PAPERLESS_BASE_URL` + `PAPERLESS_TOKEN` gesetzt (`docker exec ... env | grep PAPERLESS_`) Refs #276 — Foundation fuer #274 (PaperlessClient).
chore(#276): Paperless-Config — PAPERLESS_BASE_URL + PAPERLESS_TOKEN
All checks were successful
continuous-integration/drone/push Build is passing
continuous-integration/drone/pr Build is passing
19f1dc2b00
- env.ts: zwei optionale Schema-Felder (optionalUrl/optionalString)
- .env.example: dokumentierte Beispiele für Compose-intern vs. extern

Server-Stack-Anbindung (api-Service-ENV, Vault-Ref) im Schwester-Repo.

Refs #276

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
admin-mrrm deleted branch feat/276-paperless-config 2026-05-16 14:35:12 +02:00
Sign in to join this conversation.
No reviewers
No milestone
No project
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference
admin-mrrm/mrrmlabapp!308
No description provided.