combo-raport-app — Wiki

combo-raport-app — Wiki

Interaktywna aplikacja raportowa do wizualizacji danych sprzedażowych i wolumenowych z systemu GoPos. Dane pobierane przez API, raporty wysyłane automatycznie emailem.

Interaktywna aplikacja raportowa do wizualizacji miesięcznych danych sprzedażowych i wolumenowych. Dane ładowane dynamicznie z plików JSON według wybranej listy i miesiąca.

Spis treści

Szybki start

# Tryb developerski (hot-reload)
docker compose --profile dev up
# → http://localhost:5173

# Produkcja (nginx)
docker compose --profile prod up --build
# → http://localhost:4173

Stack

Schemat środowiska produkcyjnego

VPS home.pl · 212.132.103.157 · Debian 13 trixie · 4 vCPU / 7.7 GiB RAM / 237 GiB SSD
Edytowalny diagram drawio: plik env-prod.drawio w sekcji Attachments pod tą stroną — pobierz, otwórz na https://app.diagrams.net lub w VS Code (Draw.io Integration), zedytuj i wgraj z powrotem.

Topologia (widok logiczny)

                                Internet (HTTPS)
                                       │
                                       ▼
                  ┌──────────────────────────────────────────┐
                  │  nginx (host) — ECDSA + certbot          │
                  │  arcane.t-pizza.pl  → 127.0.0.1:3552     │
                  │  combo.t-pizza.pl   → 127.0.0.1:4173     │
                  │  id.t-pizza.pl      → 127.0.0.1:9000     │
                  │  wiki.tepizza.pl    → 127.0.0.1:6875     │
                  └──────────────────────────────────────────┘
                                       │
          ╔════════════════════════════╪════════════════════════════╗
          ║       Docker network: web (external, bridge)            ║
          ║                                                          ║
          ║  ┌─────────────┐  ┌──────────────┐  ┌────────────────┐  ║
          ║  │  Arcane     │  │ combo_prod   │  │ Authentik      │  ║
          ║  │  v1.19.5    │  │ (React+nginx)│  │ server+worker  │  ║
          ║  │  :3552      │  │ :4173        │  │ +pg+redis :9000│  ║
          ║  └──────┬──────┘  └──────────────┘  └────────┬───────┘  ║
          ║         │   OIDC (issuer/token/userinfo)     │          ║
          ║         └─────────────────────────────────── ┘          ║
          ║                                                          ║
          ║  ┌─────────────────────┐    ┌────────────────────────┐  ║
          ║  │ BookStack + MariaDB │    │ Backup cron 03:30      │  ║
          ║  │ :6875               │    │ → Arcane Volume API    │  ║
          ║  │ wiki.tepizza.pl     │    │ → /opt/backups/arcane  │  ║
          ║  └─────────────────────┘    └────────────────────────┘  ║
          ╚══════════════════════════════════════════════════════════╝

Stacki Docker

SSO / OIDC

• Provider: Authentik (id.t-pizza.pl) — app arcane (pk=1) prod, arcane-dev (pk=3) lokalny
• Relying party: Arcane v1.19.5 — konfiguracja w DB (nie env), zmiany bez recreate kontenera
• Redirect URI: https://arcane.t-pizza.pl/auth/oidc/callback (uwaga: frontend route, nie /api/...)
• Admin claim: groups → grupa arcane-admin (członkowie: akadmin, admin-combo, kamil.lendlewicz, matzxp84)
• Break-glass: lokalny login Arcane pozostaje włączony (authLocalEnabled=true, oidcAutoRedirectToProvider=false)

Backup

• Skrypt: /opt/docker/arcane/backup-cron.sh — iteruje po wszystkich wolumenach Docker via Arcane Volume Backup API
• Cron: 30 3 * * * (codziennie 03:30, przed logrotate)
• Log: /var/log/arcane-backup.log
• Lokalizacja: /opt/backups/arcane/ (bind-mount jako /backups w kontenerze Arcane), rotacja 10 kopii na wolumen
• Off-site: rsync -avz root@212.132.103.157:/opt/backups/arcane/ ~/backups/vps-home-pl/

Backupowane wolumeny: arcane_arcane-data, combo_data, authentik_authentik-{postgres,redis,media,templates,certs}.

Jak zedytować ten schemat

1. Otwórz tę stronę w trybie edycji (BookStack → Edit).
2. Tekst / tabele — wszystko powyżej jest zwykłym markdown/HTML, edytuj bezpośrednio w WYSIWYG.
3. Diagram graficzny — pobierz env-prod.drawio z sekcji Attachments, otwórz w https://app.diagrams.net, zapisz lokalnie, wgraj ponownie jako attachment (nadpisze stary).
4. Po zmianie infrastruktury zaktualizuj tabelę Stacki Docker oraz topologię ASCII.