Files
bookmanager/TODO.md
T
bobbanandClaude Sonnet 5.5 4e8d79ee10 Säkerhetskopior, papperskorg, historik, härdning, adminsida och snabbsök
- Automatisk nattlig säkerhetskopiering (zip per bok med bilder), schemaläggare via
  instrumentation, adminsida med manuell körning och nedladdning
- Papperskorg för poster (ögonblicksbild med relationer, scheman, markeringar) och
  böcker (zip), återställning och automatisk rensning
- Ändringshistorik för poster med fältvis diff och återställning
- Härdning: säkerhetsrubriker och CSP via middleware, hastighetsbegränsning, lagringskvot
  per användare, konfigurerbar sessionstid
- Bildoptimering med sharp (EXIF-rotation, nedskalning, metadata borttagen) och miniatyrer
- Strukturerade JSON-loggar, onRequestError och Prometheus-mätvärden på /api/metrics
- Snabbsök och kommandopalett (Ctrl+K) med sökning i poster och mallfält
- Migration 0005_system, nya volymer och miljövariabler, versionsinfo via build-args
- README, .env.example och TODO uppdaterade

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
2026-10-27 23:04:05 +01:00

3.7 KiB
Raw Blame History

Att göra senare

Automatisk bygg och publicering med Gitea Actions

Bygg och publicera imagen till gitea.labsconnect.se automatiskt vid push till main och vid versionstaggar. Uppdateringen av prod behålls manuell (pull och up -d).

Behövs först

  1. Gitea Actions påslaget på instansen ([actions] ENABLED = true) och i repots inställningar.
  2. En act_runner registrerad mot Gitea med tillgång till Docker (till exempel /var/run/docker.sock monterad).
  3. En åtkomsttoken i Gitea med write:package, sparad som repo-hemligheten REGISTRY_TOKEN.
  4. Om runnern körs på samma maskin som Gitea kan den pusha via en intern adress och slippa proxyn.

Utkast till .gitea/workflows/publish.yml

name: Bygg och publicera image

on:
  push:
    branches: [main]
    tags: ["v*"]

env:
  REGISTRY: gitea.labsconnect.se
  IMAGE: gitea.labsconnect.se/bobban/bookmanager

jobs:
  publish:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4

      - name: Bestäm taggar
        id: tags
        run: |
          SHA7=$(echo "${{ gitea.sha }}" | cut -c1-7)
          if [ "${{ gitea.ref_type }}" = "tag" ]; then
            VERSION="${{ gitea.ref_name }}"
            VERSION="${VERSION#v}"
            echo "list=$IMAGE:$VERSION,$IMAGE:latest" >> "$GITHUB_OUTPUT"
          else
            echo "list=$IMAGE:main-$SHA7,$IMAGE:latest" >> "$GITHUB_OUTPUT"
          fi

      - uses: docker/setup-buildx-action@v3

      - uses: docker/login-action@v3
        with:
          registry: ${{ env.REGISTRY }}
          username: ${{ gitea.actor }}
          password: ${{ secrets.REGISTRY_TOKEN }}

      - uses: docker/build-push-action@v6
        with:
          context: .
          target: prod
          push: true
          tags: ${{ steps.tags.outputs.list }}
          build-args: |
            APP_VERSION=${{ gitea.ref_type == 'tag' && gitea.ref_name || 'main' }}
            APP_COMMIT=${{ gitea.sha }}
          cache-from: type=registry,ref=${{ env.IMAGE }}:buildcache
          cache-to: type=registry,ref=${{ env.IMAGE }}:buildcache,mode=max

Släppa en version: git tag v1.0.3 && git push --tags, och sätt sedan APP_IMAGE=gitea.labsconnect.se/bobban/bookmanager:1.0.3 i .env på servern.

Valfritt: automatisk uppdatering av prod (Watchtower, eller ett SSH-steg som bara körs på versionstaggar). Rekommendation: vänta tills flödet känns tryggt.

Verifiera

  • Ladda upp en stor kartbild (10–15 MB). Gränsen för förfrågningar via inloggningskontrollen höjdes till 300 MB i samband med import och export, men en stor kartbild är inte testad.
  • Kör Docker-filerna på riktigt (docker compose ... config och en full start). Dev- och prod-compose har inte körts i miljön där koden skrevs.
  • Bygg imagen med den mindre Dockerfile och jämför storleken mot den gamla.
  • Efter uppdateringen med säkerhetskopior, papperskorg och bildoptimering (testat lokalt, men inte i Docker):
    • Att sharp (bildbehandling) installeras och fungerar i imagen (Debian, linux-x64) och att bilder skalas vid uppladdning.
    • Att uploads-init ger skrivrätt till ./data/backups och ./data/trash, och att nattens säkerhetskopia skapas där.
    • Att Content-Security-Policy inte stör inloggningen mot Authentik (omdirigeringen till och från Authentik) i en riktig miljö.
    • Att ADMIN_EMAILS och TZ ger rätt administratör och rätt tid för säkerhetskopian.
    • Att /api/metrics fungerar mot din Prometheus (sätt METRICS_TOKEN).

Idéer

  • Flera val i kopplingsfält (till exempel flera lokaler för ett företag). Idag är det en koppling per fält.
  • Äldre år i namngeneratorn har färre namn, eftersom SCB bara publicerar de 200 vanligaste namnen totalt för födda före 1998.