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: "Структура монорепозиторію, архітектура застосунків і пакетів, життєвий цикл запиту та споживання ресурсів SnapOtter."
i18n_output_hash: 6a1de194bb8b
i18n_source_hash: 733cb3c10884
i18n_source_hash: a53946e760b0
i18n_provenance: human
---
@@ -54,7 +54,7 @@ snapotter/
Сервер Fastify v5, що надає 241 маршрут інструментів у п'яти модальностях (image, video, audio, PDF, file) і обробляє:
- Завантаження файлів, керування тимчасовим робочим простором та постійне зберігання файлів
- Бібліотеку файлів користувача з ланцюжками версій (таблиця `user_files`) - кожен оброблений результат посилається назад на свій вихідний файл і фіксує, який інструмент було застосовано, з автоматично згенерованими мініатюрами для сторінки Files
- Бібліотеку файлів користувача (таблиця `user_files`): за замовчуванням збережене редагування зберігається як незалежний новий файл, або як пов'язана з батьківською версія, коли ви перезаписуєте оригінал. Вона фіксує, які інструменти було застосовано (`toolChain`), і отримує автоматично згенеровану мініатюру для сторінки Files
- Виконання інструментів (маршрутизує кожен запит інструмента до рушія зображень або мосту AI)
- Оркестрацію конвеєрів (послідовне поєднання кількох інструментів)
- Пакетну обробку з контролем паралельності через черги завдань BullMQ (пули: image, media, ai, docs, system)
+2 -2
View File
@@ -1,6 +1,6 @@
---
description: "Схема бази даних PostgreSQL, таблиці, міграції та процедури резервного копіювання для SnapOtter."
i18n_source_hash: b37398ae91a3
i18n_source_hash: 50d5d4f220cf
i18n_provenance: human
i18n_output_hash: 8b7453bf7c82
---
@@ -77,7 +77,7 @@ API-ключі для програмного доступу. Необробле
### user_files {#user-files}
Постійна бібліотека файлів із відстеженням ланцюжка версій. Кожен крок обробки, що зберігає результат, створює новий рядок, пов'язаний зі своїм батьківським через `parentId`, утворюючи дерево версій.
Постійна бібліотека файлів. За замовчуванням збережене редагування додається як незалежний кореневий рядок («зберегти як новий»: `version` 1, `parentId` null, тож оригінал лишається у списку) або як пов'язана з батьківською версія, коли ви перезаписуєте оригінал (`parentId` встановлено, `version` збільшено, замінюючи його). Стовпець `toolChain` записує застосовані інструменти.
| Стовпець | Тип | Опис |
|--------|------|-------------|