Files
bookmanager/README.md
T
bobbanandClaude Sonnet 5.5 54893569f3 Synka beroenden och Prisma-klient vid dev-start
node_modules ligger i en namngiven volym som överlever ombyggnad av bilden, så en
gammal Prisma-klient kunde finnas kvar efter schemaändringar (idCounter saknades).
Dev-containern kör nu npm install och prisma generate före migrering och start.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
2026-10-22 22:39:25 +02:00

123 lines
6.7 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# Bokplanerare
Webbaserat planeringsverktyg för författare. Flera böcker, var och en med karaktärer, husdjur, bostäder, platser, företag, lokaler, scenarier, relationer, arbetsscheman och kartor med markeringar.
- **Next.js 15** (App Router, TypeScript) med utseende från **Tabler**
- **PostgreSQL** via Prisma
- Inloggning med **Authentik** (OpenID Connect via Auth.js)
- Svenska och engelska i gränssnittet (växlas i sidomenyn)
- Kartor: riktig karta (Leaflet + OpenStreetMap) eller egen uppladdad kartbild per karta
## Starta för utveckling
```bash
docker compose -f docker-compose.dev.yml up --build
```
Öppna http://localhost:3000. Utan Authentik-inställningar visas en **utvecklarinloggning** (bara i utvecklingsläge, finns aldrig i produktionsbygget). Källkoden monteras in så ändringar slår igenom direkt.
Vill du testa mot din riktiga Authentik: kopiera `.env.example` till `.env`, fyll i `AUTHENTIK_*` och sätt `AUTH_DEV_LOGIN=false`. Allt i `.env` skickas in i appen; saknas `AUTH_SECRET` och `AUTH_URL` används utvecklingsvärden (`http://localhost:3000`). Ändrar du `.env` räcker det att köra `up` igen, ingen ombyggnad behövs.
Ändrar du `prisma/schema.prisma`:
```bash
docker compose -f docker-compose.dev.yml exec app npx prisma migrate dev --name beskrivning
```
Ändrar du `package.json` eller `prisma/schema.prisma` räcker det att starta om med `docker compose -f docker-compose.dev.yml up`. Beroenden och Prisma-klienten synkas automatiskt vid varje start.
## Sätta upp Authentik
1. I Authentik: **Applications → Applications → Create with Provider**, välj **OAuth2/OpenID Connect**.
2. Client type **Confidential**. Under **Redirect URIs** lägg till (exakt match):
`https://din-adress.example.com/api/auth/callback/authentik`
(för lokal test mot Authentik: `http://localhost:3000/api/auth/callback/authentik`)
3. Scopes: `openid`, `profile`, `email`.
4. Kopiera **Client ID**, **Client Secret** och **OpenID Configuration Issuer** (slutar på `/application/o/<slug>/`) till `.env`.
## Produktion
```bash
cp .env.example .env # fyll i lösenord, AUTH_SECRET, AUTH_URL och AUTHENTIK_*
docker compose -f docker-compose.prod.yml --env-file .env up -d --build
```
- Appen lyssnar på port `APP_PORT` (standard 3000). Lägg en omvänd proxy med HTTPS framför och sätt `AUTH_URL` till den publika adressen.
- Databasmigreringar körs automatiskt vid varje start.
- Data ligger i mappar bredvid compose-filen: `./data/db` (databas) och `./data/uploads` (bilder), eller under `DATA_DIR` om du sätter den. Ta backup på mappen, eller använd **Bokinställningar → Exportera som JSON** per bok. I utveckling används `./data/dev/`.
- Hälsokontroll: `/api/health`.
## Mallar
Varje typ (karaktär, husdjur, bostad, plats, företag, lokal, utbildning, scenario) och relationer har en mall som styr vilka fält formuläret har. Standardmallarna är byggda efter Word-mallarna i `Mall/`:
| Word-mall | I appen |
|---|---|
| Karaktärsmall (lång och kort) | Karaktär. Den korta finns som knappen *Ladda kort mall* i mallredigeraren |
| Djurmall, Bostadsmall, Företagsmall, Lokalmall, Scenariomall | Husdjur, Bostad, Företag, Lokal, Scenario |
| Utbildningsmall | Utbildning |
| Relationsmall | Relation (öppnas från relationslistan eller från en posts sida) |
| Schema dag / natt | Scheman, vyn *Timrutnät* med Dag 06–18 och Natt 18–06 |
| Registren (Fordon, Research, Referens, Appar, Hemsidor, Kart-, Schema- och Företagsregister) | Egna poster under *Register* i menyn, och sidan *ID-register* med alla ID samlade |
| ID-översikten | ID skapas automatiskt, se nedan |
Uppgifter som i Word-mallarna är ID-listor (anställda, boende, elever, involverade karaktärer, ägare) görs i appen som **relationer** mellan poster, till exempel ”Jobbar på”, ”Bor på”, ”Elev på”, ”Involverad i”. Då kan du klicka dig mellan dem och se dem i relationsdiagrammet.
En relation kan ha fler än två deltagare, till exempel en vännergrupp: välj två i *Från* och *Till* och resten under *Fler deltagare*. Gruppen ritas som ett nav i diagrammet, och den visas på varje deltagares sida.
Under **Mallar** kan du ändra fält, ordning, rubriker och fälttyper (text, textruta, tal, datum, val, kryssruta, länk) per bok, eller klistra in en mall som JSON:
```json
[
{ "key": "nickname", "label": "Smeknamn", "type": "text", "section": "Grunduppgifter" },
{ "key": "mood", "label": "Läggning", "type": "select", "options": ["Glad", "Butter"] }
]
```
Ändrar du en mall försvinner ingen data: värden för borttagna fält finns kvar i databasen.
## Automatiska ID
Alla ID skapas automatiskt enligt ID-översikten, med löpande nummer per bok och typ (de börjar om i varje ny bok). ID tilldelas första gången posten sparas och ändras aldrig därefter.
| Typ | ID | Exempel |
|---|---|---|
| Karaktär | KI | KI-0001 |
| Företag | FI | FI-0001 |
| Bostad | BI | BI-0001 |
| Husdjur | DI | DI-0001 |
| Lokal | LI | LI-0001 |
| Utbildning | UI | UI-0001 |
| Fordon | FD | FD-0001 |
| Research | RI | RI-0001 |
| Referens | RD | RD-0001 |
| Skiss | SI | SI-0001 |
| Relation | REI | REI-0001 |
| Placering (markering på karta) | PI | PI-0001 |
| Schema (en persons pass hos samma arbetsplats) | SCI | SCI-0001 |
| Karta | KD-R_ (riktig karta) eller KD-E_ (egen kartbild) | KD-R_0001 |
| Plats och Scenario (saknas i översikten, förslag) | PLI och SNI | PLI-0001, SNI-0001 |
Appar och Hemsidor har inget ID. Prefixen ligger samlade i `src/lib/ids.ts`. Sidan **ID-register** listar alla ID i boken med sökning och filter. Befintliga poster får ID vid uppgraderingen i den ordning de skapades, och tidigare handskrivna koder ersätts.
## Kartor
- **Riktig karta**: sök adress, klicka där markeringen ska sitta, koppla den till en bostad, lokal eller plats. Dra för att flytta. *Spara vy* minns utsnittet.
- **Egen kartbild**: ladda upp en bild (PNG/JPG/WebP/GIF, max 15 MB) och placera markeringar på den.
- Från en posts sida kan du gå direkt till *Placera på karta*.
- Kartplattor och adressökning hämtas som standard från OpenStreetMaps publika servrar, som är tänkta för lätt användning. För tyngre bruk, sätt `MAP_TILE_URL` och `MAP_GEOCODER_URL` till egen eller betald tjänst. Adressökningar skickas då från webbläsaren till den tjänsten.
## Struktur
```
prisma/ schema och migreringar
src/auth*.ts Authentik-inloggning (Auth.js)
src/actions/ server actions (skriv-operationer)
src/app/ sidor och API-routes
src/components/ gränssnittskomponenter (Tabler)
src/i18n/ sv.ts och en.ts
src/lib/templates.ts standardmallar och validering
```
Varje bok tillhör användaren som skapade den; andra inloggade användare kommer inte åt den.