Files
bookmanager/TODO.md
T
bobbanandClaude Sonnet 5.5 5c58f70bdd Inbjudningslänkar, adressuppslag för kartregistret och närvaromärke
Böcker kan delas med en inbjudningslänk (roll, giltighetstid, en eller
flera personer, bara en hash sparas). Inloggningen går tillbaka till
inbjudan. Kartregistrets markeringar kan få position genom uppslag mot
karttjänsten, ett i sekunden. Redigeringsformulär och listor visar vem
som har något öppet för redigering. Migrering 0009.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
2026-11-09 22:18:29 +01:00

6.4 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.

Köra testerna automatiskt i Gitea Actions

Kör typkontroll och tester vid varje push och pull request, innan imagen byggs. Databastesterna behöver en PostgreSQL-tjänst; databasen måste heta något som slutar på _test (testerna lägger själva på _test om det saknas).

Utkast till .gitea/workflows/test.yml

name: Tester

on:
  push:
    branches: [main]
  pull_request:

jobs:
  test:
    runs-on: ubuntu-latest
    services:
      postgres:
        image: postgres:16
        env:
          POSTGRES_USER: test
          POSTGRES_PASSWORD: test
          POSTGRES_DB: bookmanager
    env:
      DATABASE_URL: postgresql://test:test@postgres:5432/bookmanager
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-node@v4
        with:
          node-version: 22
          cache: npm
      - run: npm ci
      - run: npx prisma generate
      - run: npm run typecheck
      - run: npm test

Samma act_runner som för publiceringen räcker. Tjänstecontainern nås som postgres när jobbet körs i en container; om runnern kör direkt på värden byts adressen mot localhost och en publicerad port. Låt publiceringsflödet vänta på testerna (needs: test) när båda finns på plats.

Verifiera

  • Importen från Word är provad mot de blanka mallarna i Mall/ och Register/ och mot versioner jag fyllt i på de sätt som beskrivs i README. Prova med några av dina egna ifyllda dokument och berätta vad som tolkas fel, särskilt hur du markerar val (X, symbol eller ruta) och var du skriver värden.

  • Delning: logga in som en andra användare med riktiga Authentik-konton och prova rollerna (läsare, redaktör, administratör) i en delad bok.

  • Word-import av scheman och kartregister är provad mot de blanka mallarna och mot versioner jag fyllt i. Prova med egna dokument, särskilt hur du fyller i rutnätet i Schema dag och natt (text, kryss eller något annat) och vilka rader du använder i schemaregistret och kartregistret.

  • Namn för äldre år hämtas om från SCB första gången ett år används efter uppdateringen (två tabeller). Kontrollera i riktig miljö att Förnamn-tabellen svarar och att namnlistan blir längre.

  • Migreringen 0008 lägger till kolumner för krockskydd på böcker, mallar och markeringar, och 0009 tabeller för inbjudningar och närvaro.

  • Inbjudningslänkar: prova hela flödet med Authentik (öppna länken utloggad, logga in, kom tillbaka till inbjudan och gå med). Länken bygger på AUTH_URL, så kontrollera att adressen i länken är den som användarna når.

  • Adressuppslag mot OpenStreetMap görs från servern. Kontrollera att servern når nominatim.openstreetmap.org (eller din egen MAP_GEOCODER_URL) och att användaragenten Bokplanerare/<version> godtas.

  • Närvaromärket kräver att användarnas webbläsare når servern var 15:e sekund. Bakom en proxy med korta tidsgränser för serveranrop kan märket släpa, men inget går sönder.

  • 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

Inga just nu.