docs: confirm component OpenAPI match (#19)

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

README.md

@@ -12,16 +12,32 @@
 изменения рабочего checkout не подменяют содержимое релиза.
 
 Образы загружаются из `nexus.personal.ksv741.ru/docker-hosted/wealthledger/`.
-Комплект `v0.1.8` закрепляет frontend `1.3.0` и backend `2.4.0`.
+Комплект `v0.1.10` закрепляет frontend `2.0.0` и backend `3.0.0`.
+Комплект `v0.1.9` закрепляет frontend `1.4.0` и backend `2.4.1`.
 Комплект `v0.1.6` закрепляет backend `2.3.0`, образ которого не был опубликован.
-Работа новой пары на сервере не проверялась перед публикацией комплекта.
 
-OpenAPI-snapshot frontend `1.3.0` побайтно совпадает с контрактом backend `2.4.0`.
-Backend `2.4.0` добавляет одну аддитивную миграцию: таблицу
-`TbankInstrumentClassification` (только `CREATE TABLE`). Штатный `deploy.sh`
+OpenAPI-snapshot frontend `2.0.0` побайтно совпадает с контрактом backend
+`3.0.0`; оба компонента нужно обновлять одной парой. Backend
+`3.0.0` добавляет историю индексов и миграцию RUB-only: удаляет не-RUB строки
+истории стоимости, старые снимки портфеля и прогнозы выплат; ближайший проход
+синхронизации пересоздаёт снимки. Скрипт делает 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.7`
-с этой таблицей в базе не проверялся.
+данные, `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.3.0
-BACKEND_IMAGE=nexus.personal.ksv741.ru/docker-hosted/wealthledger/backend:2.4.0
+FRONTEND_IMAGE=nexus.personal.ksv741.ru/docker-hosted/wealthledger/frontend:2.0.0
+BACKEND_IMAGE=nexus.personal.ksv741.ru/docker-hosted/wealthledger/backend:3.0.0