записано решение уйти с PocketBase на SQLite со своим каталогом файлов
- разведка storage-without-pocketbase: шесть ролей библиотеки в этом коде, отпавший довод перевода, шесть модулей достижимы только через неё - ADR-2026-08-22-storage-without-pocketbase заменяет три записи: перевод в PocketBase, очередь коллекцией, файл за защищённым полем - задача storage-without-pocketbase встала первой строкой плана стройки
This commit is contained in:
@@ -3,6 +3,7 @@
|
||||
- **Дата:** 2026-08-11
|
||||
- **Источник:** [../research/pocketbase.md](../research/pocketbase.md) — записка
|
||||
разведки `pocketbase-admin-fit`
|
||||
- **Статус:** заменено на [ADR-2026-08-22-storage-without-pocketbase](ADR-2026-08-22-storage-without-pocketbase.md)
|
||||
|
||||
## Решение
|
||||
|
||||
|
||||
@@ -3,6 +3,7 @@
|
||||
- **Дата:** 2026-08-11
|
||||
- **Источник:** [../research/job-queue.md](../research/job-queue.md) — записка
|
||||
разведки `job-queue-choice`
|
||||
- **Статус:** заменено на [ADR-2026-08-22-storage-without-pocketbase](ADR-2026-08-22-storage-without-pocketbase.md)
|
||||
|
||||
## Решение
|
||||
|
||||
|
||||
@@ -5,6 +5,7 @@
|
||||
раздел «Что изменило ревью кода», плюс отчёт триажа
|
||||
[../../openspec/changes/archive/2026-08-12-oidc-login/review/report.md](../../openspec/changes/archive/2026-08-12-oidc-login/review/report.md),
|
||||
пункт 3
|
||||
- **Статус:** заменено на [ADR-2026-08-22-storage-without-pocketbase](ADR-2026-08-22-storage-without-pocketbase.md)
|
||||
|
||||
## Решение
|
||||
|
||||
|
||||
@@ -0,0 +1,79 @@
|
||||
# Хранилищем становится SQLite с каталогом файлов, а PocketBase уходит целиком
|
||||
|
||||
- **Дата:** 2026-08-22
|
||||
- **Источник:** [../research/storage-without-pocketbase.md](../research/storage-without-pocketbase.md) —
|
||||
записка разведки о выборе хранилища
|
||||
|
||||
## Решение
|
||||
|
||||
PocketBase уходит из проекта целиком: состояние записей и метаданные переезжают
|
||||
в SQLite, с которым сервис работает напрямую через `modernc.org/sqlite`, файлы
|
||||
записей — в свой каталог со своей раскладкой, маршруты и слои — на `net/http`,
|
||||
шаги схемы — на свой раннер. Панель администратора теряется и **не заменяется
|
||||
ничем**: пока идёт стройка, остановленную запись возвращает в работу запрос к
|
||||
базе.
|
||||
|
||||
Запись заменяет три:
|
||||
[ADR-2026-08-11-pocketbase-storage-with-admin-panel](ADR-2026-08-11-pocketbase-storage-with-admin-panel.md),
|
||||
[ADR-2026-08-11-queue-as-pocketbase-collection](ADR-2026-08-11-queue-as-pocketbase-collection.md) и
|
||||
[ADR-2026-08-12-protected-file-behind-session](ADR-2026-08-12-protected-file-behind-session.md).
|
||||
|
||||
**Что из заменённых решений подтверждается, а не отменяется.** Очередь остаётся
|
||||
своей таблицей, захват — одним запросом с `RETURNING`, готовую библиотеку
|
||||
очереди по-прежнему не берём: замер, которым это решено, снят на
|
||||
`modernc.org/sqlite` — том самом драйвере, который остаётся и после ухода.
|
||||
Отменяется у той записи одно слово: таблица перестаёт быть коллекцией.
|
||||
Приложение остаётся в своём корне `/app/`
|
||||
([ADR-2026-08-15-app-namespace](ADR-2026-08-15-app-namespace.md)). Файл записи
|
||||
остаётся закрытым — но проверкой владельца в своём обработчике, а не защищённым
|
||||
полем коллекции и коротким токеном.
|
||||
|
||||
## Почему
|
||||
|
||||
Разведка мерила не «хранилище против хранилища», а то, что библиотека держит в
|
||||
этом коде. Цитата из источника:
|
||||
|
||||
> Разрез «хранилище против хранилища» вопроса не покрывает: библиотека держит
|
||||
> шесть ролей сразу, и только две из них про хранение.
|
||||
|
||||
Довод, на котором стоял перевод, отпал сам. Источник, раздел о трёх доводах:
|
||||
|
||||
> Вход делает само приложение с 2026-08-22 […]: пришедшего называет заголовок
|
||||
> прокси, а учётную запись заводит наш `EnsureUser`. Пользователи в коллекции
|
||||
> есть **потому, что их пишет наш код**, а не провайдер библиотеки. Довод,
|
||||
> которым отвергнут отвергнутый вариант, перестал быть верным.
|
||||
|
||||
Отвергнут вариант «уйти в два шага», оставив панель жить в промежутке, и
|
||||
отвергнут решением владельца: панель на стройке заменяется запросом к базе, а
|
||||
вторая порция работы стоит дороже, чем то, что она сберегает.
|
||||
|
||||
Обстоятельство, которое назначило момент:
|
||||
|
||||
> на сервере данных нет и сервис остановлен, поэтому смена стоит только кода.
|
||||
> Дешевле она не станет никогда — каталог `internal/controller/http` прирастает
|
||||
> кодом на чужих типах с каждой задачей.
|
||||
|
||||
## Последствия
|
||||
|
||||
- `+` периметр сервиса становится только нашим. Панель `/_/` исчезает вместе с
|
||||
дефектом `/%5f/` из [../security.md](../security.md), а пространство
|
||||
хранилища `/api/` — вместе с необходимостью держать его открытым ради файлов.
|
||||
- `+` пропадает секрет, которого не было до перевода, — пароль суперпользователя
|
||||
панели.
|
||||
- `+` файлы ложатся своей раскладкой, и загрузка частями, узнавание по хеш-сумме,
|
||||
удаление записи и вторая копия рядом становятся обычной работой с файлами.
|
||||
- `+` из сборки уходят шесть модулей, достижимых только через библиотеку:
|
||||
`imaging`, `mailyak`, `jwt`, `fexpr`, `cobra`, драйвер MySQL.
|
||||
`modernc.org/sqlite` остаётся, и сборка по-прежнему обходится без CGO.
|
||||
- `−` владелец сервиса остаётся без панели. Правку записи, возврат остановленной
|
||||
в работу и просмотр очереди до появления экранов делает запрос к базе руками.
|
||||
Задачи `audiorecord-actions` и `play-recording-in-app` этим становятся не
|
||||
улучшением, а заменой утраченного инструмента.
|
||||
- `−` шаги схемы, отдачу файла, ограничитель частоты и настройку базы пишем и
|
||||
сопровождаем сами. Единственный писатель у `modernc.org/sqlite` — наша забота
|
||||
с этого дня.
|
||||
- `−` раскладка каталога данных меняется необратимо. Цена сегодня нулевая:
|
||||
стройка, на сервере пусто; после первой боевой записи она перестаёт быть
|
||||
нулевой.
|
||||
- `−` 1497 строк контроллера и 3075 строк его проверок написаны на
|
||||
`*core.RequestEvent` и переписываются целиком.
|
||||
+4
-3
@@ -35,6 +35,7 @@
|
||||
|
||||
| Дата | Запись | Статус |
|
||||
| --- | --- | --- |
|
||||
| 2026-08-22 | [Хранилищем становится SQLite с каталогом файлов, а PocketBase уходит целиком](ADR-2026-08-22-storage-without-pocketbase.md) | |
|
||||
| 2026-08-22 | [Пришедшего называет заголовок доверенного прокси, а не собственный вход OIDC](ADR-2026-08-22-login-by-trusted-header.md) | |
|
||||
| 2026-08-15 | [Node зовётся контейнером, а не ставится на машину разработчика](ADR-2026-08-15-node-in-container-not-on-machine.md) | |
|
||||
| 2026-08-15 | [Приложение живёт своим пространством адресов, а не общим с хранилищем](ADR-2026-08-15-app-namespace.md) | |
|
||||
@@ -49,7 +50,7 @@
|
||||
| 2026-08-14 | [Учётная запись с записями не удаляется, и это осознанный тупик](ADR-2026-08-14-account-with-records-is-not-deleted.md) | |
|
||||
| 2026-08-13 | [Намерение объявляется признаком, а не выводится из ключа доступа](ADR-2026-08-13-telegram-intent-declared-not-inferred.md) | устарело: вход убран [ADR-2026-08-15-telegram-intake-removed-temporarily](ADR-2026-08-15-telegram-intake-removed-temporarily.md) |
|
||||
| 2026-08-13 | [Недоступность Telegram подъёму сервиса не мешает](ADR-2026-08-13-telegram-outage-does-not-block-startup.md) | устарело: вход убран [ADR-2026-08-15-telegram-intake-removed-temporarily](ADR-2026-08-15-telegram-intake-removed-temporarily.md) |
|
||||
| 2026-08-12 | [Файл записи закрыт защищённым полем и отдаётся вошедшему по токену файла](ADR-2026-08-12-protected-file-behind-session.md) | |
|
||||
| 2026-08-12 | [Файл записи закрыт защищённым полем и отдаётся вошедшему по токену файла](ADR-2026-08-12-protected-file-behind-session.md) | заменено на [ADR-2026-08-22-storage-without-pocketbase](ADR-2026-08-22-storage-without-pocketbase.md) |
|
||||
| 2026-08-12 | [Сессия живёт семь суток и не продлевает саму себя](ADR-2026-08-12-session-without-refresh.md) | заменено на [ADR-2026-08-22-login-by-trusted-header](ADR-2026-08-22-login-by-trusted-header.md) |
|
||||
| 2026-08-12 | [Кого пускать в сервис, решает правило провайдера, а не сервис](ADR-2026-08-12-access-delegated-to-provider.md) | |
|
||||
| 2026-08-12 | [Код провайдера меняется на сессию вызовом собственного адреса хранилища внутри процесса](ADR-2026-08-12-oidc-exchange-via-own-route.md) | заменено на [ADR-2026-08-22-login-by-trusted-header](ADR-2026-08-22-login-by-trusted-header.md) |
|
||||
@@ -61,8 +62,8 @@
|
||||
| 2026-08-11 | [Отказ, который решено не проверять, объявляется поимённо](ADR-2026-08-11-errcheck-check-blank.md) | |
|
||||
| 2026-08-11 | [Наружу расширение выходит только приведённым к перечню](ADR-2026-08-11-known-format-label.md) | |
|
||||
| 2026-08-11 | [Приложение пишем на Vue, а Node входит в гейт и в образ](ADR-2026-08-11-spa-on-vue.md) | |
|
||||
| 2026-08-11 | [Очередь остаётся своей таблицей, но коллекцией PocketBase](ADR-2026-08-11-queue-as-pocketbase-collection.md) | |
|
||||
| 2026-08-11 | [Хранилище, файлы и вход переезжают в PocketBase](ADR-2026-08-11-pocketbase-storage-with-admin-panel.md) | |
|
||||
| 2026-08-11 | [Очередь остаётся своей таблицей, но коллекцией PocketBase](ADR-2026-08-11-queue-as-pocketbase-collection.md) | заменено на [ADR-2026-08-22-storage-without-pocketbase](ADR-2026-08-22-storage-without-pocketbase.md) |
|
||||
| 2026-08-11 | [Хранилище, файлы и вход переезжают в PocketBase](ADR-2026-08-11-pocketbase-storage-with-admin-panel.md) | заменено на [ADR-2026-08-22-storage-without-pocketbase](ADR-2026-08-22-storage-without-pocketbase.md) |
|
||||
| 2026-08-11 | [Проверки не зовут внешних программ](ADR-2026-08-11-stub-adapters-in-tests.md) | |
|
||||
|
||||
Решения, принятые до заведения канона 2026-08-10, источника в архиве изменений
|
||||
|
||||
Reference in New Issue
Block a user