Släktträd och tidslinje
Relationer får ett släktband (förälder, partner, syskon) och en period. Nytt släktträd som ritas av släktbanden, och en tidslinje som samlar födelse och död, scenarier, egna händelser och relationsperioder med ålder vid varje tillfälle. Datum skrivs som ÅÅÅÅ, ÅÅÅÅ-MM eller ÅÅÅÅ-MM-DD. Följer med i export, import och papperskorg. Migreringen 0006 ger gamla relationer som "Förälder till" rätt släktband. Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
This commit is contained in:
1 parent
dcb5d43429
commit
bd269d70a5
32 files changed
+2285
-25
No files matched your search
@@ -1,6 +1,6 @@
|
||||
# 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.
|
||||
Webbaserat planeringsverktyg för författare. Flera böcker, var och en med karaktärer, husdjur, bostäder, platser, företag, lokaler, scenarier, relationer, släktträd, tidslinje, arbetsscheman och kartor med markeringar.
|
||||
|
||||
- **Next.js 15** (App Router, TypeScript) med utseende från **Tabler**
|
||||
- **PostgreSQL** via Prisma
|
||||
@@ -117,6 +117,26 @@ Standardmallarna använder det för Lokal och Skiss i Företag, Lokal, Bostad oc
|
||||
|
||||
Ändrar du en mall försvinner ingen data: värden för borttagna fält finns kvar i databasen.
|
||||
|
||||
## Släktträd och tidslinje
|
||||
|
||||
**Datum.** Datum i berättelsen skrivs som `ÅÅÅÅ`, `ÅÅÅÅ-MM` eller `ÅÅÅÅ-MM-DD`, så att året räcker när resten inte är bestämt. Berättelsens tid kan ligga var som helst, även före år 1900 eller i framtiden. Gäller alla datumfält i mallarna, relationernas period och händelser. Åldern räknas i hela år när månad och dag är kända, annars som skillnaden i år.
|
||||
|
||||
**Släktträd** (menyn *Planering*). Trädet ritas av relationer som har ett **släktband**, som du väljer när du skapar eller ändrar en relation:
|
||||
|
||||
- *Förälder till*: gäller från den första till den andra och de extra deltagarna, så en förälder med flera barn blir en relation.
|
||||
- *Partner till* och *Syskon till*: gäller alla deltagare. Partner ritas bredvid varandra och syskon hamnar i samma generation.
|
||||
|
||||
Generationerna räknas ut automatiskt, partner ritas bredvid varandra och barn mitt under sina föräldrar. Under rullistan kan du visa bara släkten kring en person. Relationer som redan hette ”Förälder till”, ”Barn till”, ”Partner till” eller ”Syskon till” (och motsvarande på engelska) får rätt släktband automatiskt vid uppdateringen. ”Barn till” vänds då till ”Förälder till” åt andra hållet. Lämnar du relationstexten tom får relationen släktbandets namn.
|
||||
|
||||
**Tidslinje** (menyn *Planering*). Samlar datum från hela boken i en lista per år, med ålder vid varje tillfälle:
|
||||
|
||||
- Födelse och död, från fälten *Födelsedatum* och *Dödsdatum* i karaktärsmallen. (Har du en egen karaktärsmall, lägg till ett datumfält med nyckeln `deathDate`.)
|
||||
- Scenarier, från det nya fältet *Datum i berättelsen*. Scenarier utan datum listas för sig. Deltagare är de karaktärer som är kopplade till scenariot via en relation eller via fältet *Kopplat till*.
|
||||
- Egna händelser med datum, valfritt slutdatum, beskrivning och deltagare. De läggs till på tidslinjens sida.
|
||||
- Relationer med *Gäller från* och *Gäller till*, till exempel ett äktenskap 2004–2011.
|
||||
|
||||
Händelser och relationer med slutdatum visas dessutom som staplar under *Perioder*. Du kan filtrera på person och på typ av händelse.
|
||||
|
||||
## Export och import
|
||||
|
||||
Under *Bokinställningar* exporterar du hela boken:
|
||||
@@ -124,7 +144,7 @@ Under *Bokinställningar* exporterar du hela boken:
|
||||
- **Med bilder (.zip):** innehåller `book.json` och alla bilder i `files/`. Det är den fullständiga säkerhetskopian.
|
||||
- **Bara data (.json):** samma innehåll utan bilder, för snabb jämförelse eller redigering.
|
||||
|
||||
Exporten innehåller poster (med ID, taggar och mallfält), relationer med deltagare, scheman, kartor med markeringar, mallar och bilderna.
|
||||
Exporten innehåller poster (med ID, taggar och mallfält), relationer med deltagare, släktband och perioder, händelser, scheman, kartor med markeringar, mallar och bilderna.
|
||||
|
||||
På startsidan *Mina böcker* importerar du en exportfil (.zip eller .json). Importen **skapar alltid en ny bok** och skriver aldrig över något. Alla poster får nya interna id, och kopplingar mellan dem (relationer, kopplingsfält i mallar, markeringar och scheman) pekar om till de nya. ID som KI-0001 behålls, och räknarna fortsätter därefter. Finns redan en bok med samma titel får den nya tillägget *(import)*. Poster, bilder och kopplingar som saknas eller är ogiltiga i filen hoppas över, och antalet visas efteråt. Filen kan flyttas mellan installationer, till exempel från dev till prod.
|
||||
|
||||
@@ -158,7 +178,7 @@ Appar och Hemsidor har inget ID. Prefixen ligger samlade i `src/lib/ids.ts`. Sid
|
||||
|
||||
**Säkerhetskopior.** Varje natt (klockan `BACKUP_HOUR`, standard 03:00 i `TZ`) sparas en zip per bok med bilder i `./data/backups/<tidpunkt>/`. De `BACKUP_KEEP` senaste körningarna (standard 14) behålls. Zip-filerna är samma format som exporten och importeras via *Importera bok*. Missade körningar tas igen vid nästa start. Administratören kan köra en säkerhetskopia direkt och ladda ner filerna på *Administration*. Kopiera gärna `backups/` till en annan maskin.
|
||||
|
||||
**Papperskorg.** Borttagna poster och böcker flyttas till papperskorgen i `TRASH_DAYS` dagar (standard 30) och kan återställas. En post återställs med sina relationer, scheman och markeringar, och behåller sitt ID. En bok sparas som zip i `./data/trash` och återställs som en ny bok. Papperskorgen rensas automatiskt.
|
||||
**Papperskorg.** Borttagna poster och böcker flyttas till papperskorgen i `TRASH_DAYS` dagar (standard 30) och kan återställas. En post återställs med sina relationer (med släktband och perioder), deltagande i händelser, scheman och markeringar, och behåller sitt ID. En bok sparas som zip i `./data/trash` och återställs som en ny bok. Papperskorgen rensas automatiskt.
|
||||
|
||||
**Ändringshistorik.** Varje ändring av en post sparar den tidigare versionen (de `MAX_VERSIONS` senaste, standard 30). *Historik* på postens sida visar skillnaderna fält för fält och kan återställa en tidigare version. Att återställa sparar först den nuvarande, så det går att ångra. Bilder ingår inte i historiken.
|
||||
|
||||
@@ -198,10 +218,10 @@ Namnen viktas efter hur vanliga de var, så en man född 1960 blir oftare Anders
|
||||
|
||||
## Tester
|
||||
|
||||
Testerna körs med Vitest (`npm test`). Det finns cirka 170 tester:
|
||||
Testerna körs med Vitest (`npm test`). Det finns cirka 240 tester:
|
||||
|
||||
- **Enhetstester utan databas** (`tests/unit`): mallar och deras validering, ID-prefix, hastighetsbegränsning, säkerhetsrubriker, namngenerering, historikens jämförelser, bildbehandling (storlek, EXIF-rotation, borttagen metadata) och läsning och kontroll av importfiler (inklusive skydd mot för stora filer).
|
||||
- **Databastester** (`tests/db`): löpande ID (även vid samtidiga anrop), export och import fram och tillbaka med bilder och kopplingar, papperskorg (poster och böcker), historikens gräns, fältvärden och kopplingskontroller, säkerhetskopiering (rensning, schema, att zip-filerna går att importera), lagringskvot, administratör och sök.
|
||||
- **Enhetstester utan databas** (`tests/unit`): datum och åldersberäkning, släktträdets layout, tidslinjens sammanställning, mallar och deras validering, ID-prefix, hastighetsbegränsning, säkerhetsrubriker, namngenerering, historikens jämförelser, bildbehandling (storlek, EXIF-rotation, borttagen metadata) och läsning och kontroll av importfiler (inklusive skydd mot för stora filer).
|
||||
- **Databastester** (`tests/db`): löpande ID (även vid samtidiga anrop), export och import fram och tillbaka med bilder och kopplingar, släktband, perioder och händelser (även i papperskorgen), papperskorg (poster och böcker), historikens gräns, fältvärden och kopplingskontroller, säkerhetskopiering (rensning, schema, att zip-filerna går att importera), lagringskvot, administratör och sök.
|
||||
|
||||
Databastesterna behöver en PostgreSQL-databas och använder alltid en **egen testdatabas** vars namn slutar på `_test`. De tömmer den mellan testerna och vägrar köra mot en databas med något annat namn, så din riktiga data berörs aldrig. Databasen skapas och migreras automatiskt första gången.
|
||||
|
||||
|
||||
Reference in new issue
Block a user