Delning av böcker, skydd mot kolliderande ändringar och import från Word
Böcker kan delas med roller (läsare, redaktör, administratör), och behörigheten kontrolleras på servern. Formulär för poster, relationer och händelser skickar med version, och en krock visar vad som skiljer och låter användaren spara ändå eller ladda om. Ifyllda Word-mallar kan importeras med förhandsgranskning. Importerade ID flyttar nu räknaren. Migrering 0007. Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
This commit is contained in:
1 parent
bd269d70a5
commit
86fd435438
64 files changed
+4796
-235
No files matched your search
@@ -137,6 +137,36 @@ Generationerna räknas ut automatiskt, partner ritas bredvid varandra och barn m
|
||||
|
||||
Händelser och relationer med slutdatum visas dessutom som staplar under *Perioder*. Du kan filtrera på person och på typ av händelse.
|
||||
|
||||
## Delning av böcker
|
||||
|
||||
En bok kan delas med andra som har loggat in i appen. Under *Bokinställningar → Delning* skriver du e-postadressen som personen loggar in med (samma som i Authentik) och väljer en roll. Personen måste ha loggat in minst en gång. Den delade boken syns under *Mina böcker* med ägarens namn och rollen.
|
||||
|
||||
| Roll | Får |
|
||||
| --- | --- |
|
||||
| Läsare | Läsa allt, söka och exportera. Ser ingen redigeringsknapp. |
|
||||
| Redaktör | Allt en läsare får, och skriva: poster, relationer, släktband, scheman, kartor, händelser, namngeneratorn, Word-import, och flytta till och återställa ur papperskorgen. |
|
||||
| Administratör | Allt en redaktör får, och dela boken, ändra bokens uppgifter och mallar, och tömma papperskorgen. Kan ge och ta bort redaktörer och läsare. |
|
||||
| Ägare | Allt, och dessutom ta bort boken och ge och ta bort administratörer. |
|
||||
|
||||
Behörigheten kontrolleras på servern vid varje ändring, så en dold knapp är inte det enda skyddet. Den som inte har tillgång till en bok får 404. Poster som tas bort hamnar i ägarens papperskorg (det är ägaren som har lagringskvoten) men kan återställas av redaktörer. Bilder som en redaktör laddar upp räknas mot ägarens kvot. Ändringshistoriken visar vem som gjorde ändringen. En medlem kan lämna en delad bok under *Bokinställningar*, och ägaren kan dela den igen.
|
||||
|
||||
## Samtidiga ändringar
|
||||
|
||||
Två personer kan redigera samma post eller relation samtidigt. Formuläret skickar med versionen det öppnades med, och har någon annan sparat sedan dess sparas ingenting. I stället visas en ruta ovanför formuläret med vem som sparade, när, och hur ditt formulär skiljer sig från den sparade versionen. Det du skrivit finns kvar. Du väljer *Spara mina ändringar ändå* (den andras version hamnar i historiken, för poster) eller *Ladda om sidan*. Kontrollen gäller poster, relationer och händelser och görs i databasen i samma steg som sparningen, så två sparningar i exakt samma ögonblick kan inte skriva över varandra.
|
||||
|
||||
## Importera från Word
|
||||
|
||||
Under *Planering → Importera från Word* laddar du upp ifyllda Word-mallar (.docx) från `Mall/` och `Register/`, flera i taget. Appen läser dokumenten, visar vad den hittade och sparar först när du bekräftar.
|
||||
|
||||
- **Dokumenttyp** känns igen på dokumentets eget ID-fält (*Karaktärs ID*, *Bostads ID* och så vidare) eller på etiketterna, och kan bytas i rullistan. Karaktär, husdjur, bostad, företag, lokal, utbildning, scenario, relation, fordon, referens, research, app och hemsida stöds. Scheman och kartregistret importeras inte, de har egna sidor.
|
||||
- **Fyll i** genom att skriva värdet efter etiketten i samma cell, i cellen bredvid eller på raden under, och markera val med ett X (till exempel `Ja: X Nej:`). Val utan markering räknas som tomma. Mallens hjälptexter i parentes och frågor räknas aldrig som värden. Etiketter får vara skrivna lite annorlunda än i appens mall.
|
||||
- **Namn och ID.** Namn sätts ihop av *Förnamn* och *Efternamn*, eller tas från *Namn*, *Företagets namn* och liknande. Poster utan namnfält (bostad, lokal, scenario) får adress, typ och ID som namn. Du kan ändra namnet i förhandsgranskningen. Ett ID i dokumentet behålls om det är ledigt, annars får posten ett nytt, och räknarna fortsätter efter det.
|
||||
- **Kopplingar.** Deltagarlistor blir relationer: *Boende* blir ”Bor på”, *Anställda* ”Jobbar på” (med rollen som anteckning), lärare och elever ”Lärare på” och ”Elev på”, *Involverade* och *Berörda karaktärer* ”Involverad i” och ”Berörd av”, och *Anställd hos* och *Ägare* (husdjur) kopplas åt rätt håll. Personer och företag hittas i boken på ID eller exakt namn. De som inte hittas visas och hoppas över. Kopplingsfält (till exempel *Lokal ID* i en företagsmall) fylls i på samma sätt. En relationsmall blir en relation mellan de som hittades (minst två), och *Partner* ger släktbandet partner.
|
||||
- **Det som inte tolkades** visas under *Ej tolkat* och kan läggas i fältet *Övrigt* eller *Beskrivning* (en ruta, på som standard), så att inget försvinner.
|
||||
- **Dubbletter.** Finns redan en post av samma typ med samma namn är den avmarkerad. Markera den för att skapa en till.
|
||||
- **Register** (fordon, referenser, research) ger en post per ifylld rad, och appar och hemsidor en post per *Namn*.
|
||||
- Gränser: 20 filer åt gången, 8 MB per fil och 500 poster. Bara huvuddokumentet i filen packas upp. Allt kontrolleras igen på servern innan det sparas.
|
||||
|
||||
## Export och import
|
||||
|
||||
Under *Bokinställningar* exporterar du hela boken:
|
||||
@@ -218,10 +248,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 240 tester:
|
||||
Testerna körs med Vitest (`npm test`). Det finns cirka 430 tester:
|
||||
|
||||
- **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.
|
||||
- **Enhetstester utan databas** (`tests/unit`): roller och behörighet, tolkning av Word-dokument (etiketter, val i rutor, listor, register och ifyllda versioner av de riktiga mallarna i `Mall/` och `Register/`), 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, delning och behörigheter för varje roll, skydd mot kolliderande ändringar (även med flera samtidiga sparningar), import från Word, 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