av
4a052ec99b
- шаги PocketBase переехали из файла в пакет internal/adapter/repo/pocketbase/migrations, файл на шаг с именем зарегистрированного шага; туда же имена коллекций, срок сессии — в provider.go - ключ migrations в docs/.docs.json наведён на этот каталог: прежнее значение указывало на несуществующий migrations/, и шаг гейта проходил зелёным при всякой правке схемы - app.go подключает пакет шагов явным пустым импортом: пропавшая ссылка на константы унесла бы регистрацию, и хранилище поднялось бы без коллекций
36 lines
2.2 KiB
Go
36 lines
2.2 KiB
Go
// Package migrations — шаги схемы хранилища и имена коллекций, которые они
|
||
// заводят.
|
||
//
|
||
// Схема заводится версионированными шагами, и применённый шаг не переписывается
|
||
// — только новым шагом. Инвариант проекта перенесён дословно: хранилище считает
|
||
// применённое по **имени шага**, а не по пути файла, поэтому имена в
|
||
// `Register` ниже не переносятся и не переименовываются, даже если файл переехал.
|
||
//
|
||
// Шаги лежат своим каталогом, а не файлом внутри пакета репозитория, и причина
|
||
// внешняя: сверка документов ловит изменённый шаг схемы при нетронутом
|
||
// `docs/database.md` по префиксу пути (`docs/.docs.json`, ключ `migrations`), а
|
||
// префикс наводится только на каталог. Пока шаги лежали файлом, наводить его
|
||
// было не на что, и проверка молчала на всякой правке схемы.
|
||
package migrations
|
||
|
||
import (
|
||
pbmigrations "github.com/pocketbase/pocketbase/migrations"
|
||
)
|
||
|
||
// Имена коллекций живут здесь, рядом с шагом, который их заводит. Они же — часть
|
||
// пути к файлу в раскладке хранилища и часть адреса ссылки на него, поэтому
|
||
// меняются только новым шагом схемы.
|
||
const (
|
||
FilesCollection = "files"
|
||
JobsCollection = "transcribe_jobs"
|
||
)
|
||
|
||
// Шаг регистрируется в списке приложения при загрузке пакета, а накатывает его
|
||
// `apis.Serve` прежде, чем поднять сервер.
|
||
func init() {
|
||
pbmigrations.Register(up202608110001, down202608110001, "202608110001_init.go")
|
||
pbmigrations.Register(up202608120001, down202608120001, "202608120001_oidc_login.go")
|
||
}
|
||
|
||
func ptr[T any](v T) *T { return &v }
|