docs(guide): describe both library save modes in database.md and architecture.md (#580)

Closes #578. Rewrites the user file library save-mode description in the English database.md and architecture.md guides (independent-new by default, parent-linked on overwrite) and updates all 20 translated copies of each, with i18n_source_hash re-stamped so the parity gate stays green.
This commit is contained in:
SnapOtter
2026-07-19 22:59:34 +08:00
committed by GitHub
parent 1113c761ea
commit 5558cf18b8
42 changed files with 82 additions and 82 deletions
+2 -2
View File
@@ -1,7 +1,7 @@
---
description: "Struttura del monorepo, architettura di app e pacchetti, ciclo di vita di una richiesta e impronta sulle risorse di SnapOtter."
i18n_output_hash: 5a4f11a25575
i18n_source_hash: 733cb3c10884
i18n_source_hash: a53946e760b0
i18n_provenance: human
---
@@ -54,7 +54,7 @@ Tipi TypeScript condivisi, costanti (come `APP_VERSION` e le definizioni degli s
Un server Fastify v5 che espone 241 route di strumenti su cinque modalità (immagine, video, audio, PDF, file) e gestisce:
- Upload di file, gestione dello spazio di lavoro temporaneo e archiviazione persistente dei file
- Libreria di file utente con catene di versioni (tabella `user_files`) - ogni risultato elaborato rimanda al file sorgente e registra quale strumento è stato applicato, con miniature auto-generate per la pagina File
- Libreria di file utente (tabella `user_files`): per impostazione predefinita, una modifica salvata viene archiviata come nuovo file indipendente, oppure come versione collegata al genitore quando sovrascrivi l'originale. Registra quali strumenti sono stati applicati (`toolChain`) e ottiene una miniatura auto-generata per la pagina File
- Esecuzione degli strumenti (instrada ogni richiesta di strumento all'image engine o all'AI bridge)
- Orchestrazione delle pipeline (concatenamento sequenziale di più strumenti)
- Elaborazione in batch con controllo della concorrenza tramite le code di lavori BullMQ (pool: image, media, ai, docs, system)
+2 -2
View File
@@ -1,6 +1,6 @@
---
description: "Schema del database PostgreSQL, tabelle, migrazioni e procedure di backup per SnapOtter."
i18n_source_hash: b37398ae91a3
i18n_source_hash: 50d5d4f220cf
i18n_provenance: human
i18n_output_hash: 6498644e25e3
---
@@ -77,7 +77,7 @@ Catene di strumenti salvate che gli utenti creano nell'interfaccia.
### user_files {#user-files}
Libreria di file persistente con tracciamento della catena delle versioni. Ogni passaggio di elaborazione che salva un risultato crea una nuova riga collegata al suo genitore tramite `parentId`, formando un albero delle versioni.
Libreria di file persistente. Per impostazione predefinita, una modifica salvata viene inserita come riga radice indipendente ("salva come nuovo": `version` 1, `parentId` null, così l'originale resta elencato), oppure come versione collegata al genitore quando sovrascrivi l'originale (`parentId` impostato, `version` incrementata, sostituendolo). La colonna `toolChain` registra gli strumenti applicati.
| Colonna | Tipo | Descrizione |
|--------|------|-------------|