Netpulse_SasS/db/README-migrations.md
byrsapty 205dd5e079 Пакування: runner міграцій і вшитий у бінарник фронтенд
netpulse-migrate замість PowerShell-скрипта: у контейнері немає ані
psql, ані PowerShell, а тягнути клієнт Postgres в образ заради одного
запуску — це половина дистрибутива на порожньому місці.

Міграції вшиті через embed і переїхали в server/migrations: embed не
бачить нічого за межами кореня свого модуля, а міграції поруч із
бінарником, який їх накочує, не можуть розійтися версіями.

Накочування під advisory-блокуванням: два інстанси при rolling update
інакше застосували б ту саму міграцію двічі. Кожен файл в одній
транзакції разом із записом у schema_migrations; виняток — continuous
aggregates, які TimescaleDB забороняє в транзакції. Змінена вже
застосована міграція зупиняє запуск: у різних інсталяціях інакше
опиниться різна схема під одним номером.

Перевірено на чистій базі: 23 міграції, 101 таблиця, повторний запуск
каже «схема актуальна».

Веб віддає сам API через embed: на self-hosted це прибирає з інструкції
встановлення цілий компонент. Три політики кешування — назавжди для
assets із хешем у імені, ніколи для index.html, коротко для решти.

Знайдено живим прогоном: невідомий шлях під /api/ віддавав 200 з
index.html, і клієнт падав на розборі HTML як JSON замість чесного 404.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-08-25 01:01:55 +03:00

22 lines
1.1 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# Міграції переїхали
Файли схеми тепер лежать у `server/migrations/`.
Причина технічна: `netpulse-migrate` вшиває їх у бінарник через
`//go:embed`, а `embed` не бачить нічого за межами кореня свого модуля.
Модуль сервера починається в `server/`, тож `db/migrations` для нього
недосяжні.
Це не лише про компіляцію. Міграції поруч із бінарником, який їх
накочує, не можуть розійтися версіями: у контейнері немає способу
підсунути схему з іншого релізу.
Накочування:
```
netpulse-migrate -dsn postgres://user:pass@host:5432/netpulse
netpulse-migrate -dsn … -dry-run # лише показати, що буде застосовано
```
Генератор профілів NCM (`db/profiles/build.py`) пише свій результат
туди ж — у `server/migrations/0014_ncm_profiles.sql`.