Merge pull request 'build: deploy frontend 2.0.0 and backend 3.0.0 (#19)' (#20) from build/19-bundle-frontend-2.0.0-backend-3.0.0 into main

build: deploy frontend 1.4.0 and backend 2.4.1 (#17)

README.md

@@ -12,14 +12,32 @@
 изменения рабочего checkout не подменяют содержимое релиза.
 
 Образы загружаются из `nexus.personal.ksv741.ru/docker-hosted/wealthledger/`.
-Комплект `v0.1.6` закрепляет frontend `1.2.1` и backend `2.3.0`.
+Комплект `v0.1.10` закрепляет frontend `2.0.0` и backend `3.0.0`.
-Доступность образов в Nexus и работа пары на сервере не проверялись перед
+Комплект `v0.1.9` закрепляет frontend `1.4.0` и backend `2.4.1`.
-публикацией комплекта.
+Комплект `v0.1.6` закрепляет backend `2.3.0`, образ которого не был опубликован.
 
-Совместимость OpenAPI frontend `1.2.1` и backend `2.3.0`, а также наличие новых
+OpenAPI-snapshot frontend `2.0.0` побайтно совпадает с контрактом backend
-миграций не проверялись. Штатный `deploy.sh` выполняет остановку backend,
+`3.0.0`; оба компонента нужно обновлять одной парой. Backend
-backup и `prisma migrate deploy`; существующие данные, `JWT_SECRET` и
+`3.0.0` добавляет историю индексов и миграцию RUB-only: удаляет не-RUB строки
-`TOKEN_ENCRYPTION_KEY` сохраняются.
+истории стоимости, старые снимки портфеля и прогнозы выплат; ближайший проход
+синхронизации пересоздаёт снимки. Скрипт делает backup всего каталога данных
+перед миграцией, но старый backend `2.4.1` нельзя считать совместимым с новой
+схемой: откат требует восстановления копии БД, сделанной до обновления.
+Работа пары на сервере ещё не проверена.
+
+Для предыдущего комплекта `v0.1.9` OpenAPI-snapshot frontend `1.4.0`
+**не** совпадает побайтно с контрактом backend `2.4.1`: backend убрал
+необязательный query-параметр `sync=observe` и
+`GET /api/v1/tbank-sync/{id}` вместе со схемами `TbankSyncStatusDto`,
+`SyncCandleRangeDto` и `*InvestmentScreenDto`. Остальные пути и схемы совпадают.
+Код frontend `1.4.0` эти элементы не вызывает (остались только в snapshot и
+generated types), поэтому несовместимость ожидается нулевой, но браузерная
+проверка после обновления обязательна.
+Миграций между backend `2.4.0` и `2.4.1` нет (`prisma/` не менялся); последняя
+миграция — `TbankInstrumentClassification` из `2.4.0`. Штатный `deploy.sh`
+выполняет остановку backend, backup и `prisma migrate deploy`; существующие
+данные, `JWT_SECRET` и `TOKEN_ENCRYPTION_KEY` сохраняются. Откат на `v0.1.8`
+образами `1.3.0` и `2.4.0` схему не меняет.
 
 ## Подготовка сервера
 

release.env

@@ -1,3 +1,3 @@
 # Pinned application images for this deployment bundle.
-FRONTEND_IMAGE=nexus.personal.ksv741.ru/docker-hosted/wealthledger/frontend:1.2.1
+FRONTEND_IMAGE=nexus.personal.ksv741.ru/docker-hosted/wealthledger/frontend:2.0.0
-BACKEND_IMAGE=nexus.personal.ksv741.ru/docker-hosted/wealthledger/backend:2.3.0
+BACKEND_IMAGE=nexus.personal.ksv741.ru/docker-hosted/wealthledger/backend:3.0.0