Skip to content

Open source personal finance application

docs: record cold-start measurements and blob-cache decision in todo

Ilya Komichevda25eaac5e7f
diff --git a/todo.md b/todo.md
index 555a0920..373720a3 100644
--- a/todo.md
+++ b/todo.md
@@ -11,15 +11,15 @@
### Перф: стоимость стартовой загрузки trns
-Одна связанная цепочка **1 → 2 → 3**, всё про стоимость полного набора trns. Порядок обязателен: замеры (1) питают решение (2), решение определяет, нужен ли вообще (3). **Не брать 3 раньше 2, не решать 2 без замеров 1.**
+Одна связанная цепочка **1 → 2 → 3**. Пункты 1 и 2 закрыты 2026-06-12 (замеры на проде, аккаунт 8.2k trns / 200 категорий / 28 кошельков, perf-марки `ps:watch:*` / `cache:prime` / `trns:first-transform` оставлены в коде).
-- [ ] **1. Замеры cold-start** (investigation-first, делать первым). `startWatches()` (`useInitApp.ts:60`) поднимает **5** `db.watch('SELECT * FROM ...')` (user / rates / categories / wallets / trns) - ~250ms из ~607ms cold-start (trns ~148ms), сериализованы на одном PowerSync-соединении/воркере. Блоб-кеш это уже **прячет** для вернувшегося юзера (первый кадр из снапшота до завершения запросов) → выигрыш в основном для свежего логина / cache-miss и для скорости reconcile (truth поверх прайма). Выяснить: (1) сериализует ли `@powersync/web` чтения на единственном WASM-соединении или их реально можно гнать параллельно; (2) можно ли сократить/слить 5 select'ов; (3) что дороже - скан таблицы или per-row materialize+transform (`transforms.ts`). Результат замеров → вход для пункта 2.
-
-- [ ] **2. Решение по архитектуре: два слоя локального хранения** (развилка, после замеров). Блоб-кеш (`useStoreCache.ts`) + PowerSync SQLite - легитимный read-кеш поверх единственного источника правды (инвариант «блоб = кеш, SQLite = правда» через reconcile + uid-ключ), НЕ костыль. Платит: дублирование в IndexedDB (SQLite-страницы + JSON-блоб) и write-amplification. Основной выигрыш блоба - пропуск per-row transform, не пропуск SQLite. Развилка (зависит от замеров пункта 1):
- - (а) **один слой + shell-first** (уже частично - `showShell` по hint) + скелет цифр - убирает слой и риск утечки между юзерами;
- - (б) **оставить кеш** → тогда подпункт 3.
-
-- [ ] **3. Блоб-кеш: инкрементальная запись** (low, только если в пункте 2 выбрана ветка «б»). Сейчас на каждую мутацию переписывается весь снапшот (`useStoreCache.ts` `persistStoreCache`, RMW целого блоба, write-amplification). При 30-50к+ переписать на запись по слайсам. **Не брать до решения пункта 2.**
+- [x] **1. Замеры cold-start** (done 2026-06-12). Результаты (prod-билд, warm SQLite, reload):
+ - Чтения **сериализованы** на одном воркер-соединении: 5 watch'ей армируются одновременно (~352ms), первые эмиссии лесенкой - user_settings 506 → rates 539 → categories 557 → wallets 561 → **trns 731ms**.
+ - Доминирует скан+передача trns (~170ms чистых после мелких запросов + ~150ms общий старт), мелкие 4 запроса вместе ~50ms сверху - сливать их почти нечего.
+ - **Per-row transform пренебрежим**: `trns:first-transform` = **2.6ms** на 8.2k строк. Дорог скан/сериализация из воркера, не JS-преобразование.
+ - Блоб-кеш праймит сторы за **72ms** (старт 212ms → данные в сторах ~284ms) против первой эмиссии trns в 731ms → выигрыш ~450ms на данных на экране.
+- [x] **2. Решение: оставить два слоя (ветка «б»)** (done 2026-06-12). Блоб-кеш даёт данные на экране на ~450ms раньше, чем SQLite-watch, и его польза - именно ранний прайм (не пропуск transform, как предполагалось). Цена (дублирование в IndexedDB + write-amplification) принимается; инкрементальная запись - пункт 3.
+- [ ] **3. Блоб-кеш: инкрементальная запись** (low, актуален после выбора «б»). Сейчас на каждую мутацию переписывается весь снапшот (`useStoreCache.ts` `persistStoreCache`, RMW целого блоба, write-amplification). При 30-50к+ переписать на запись по слайсам.
### Прочий перф
@@ -27,6 +27,16 @@
> Рассмотрено и отклонено: **date-windowed watch** (`WHERE date >= ?` вместо `SELECT *`) ломает тоталы - `walletTotals`/`recentWalletIds`/`usedCategoryIds` считаются по всей истории; индексы (`AppSchema.ts` `trns.userDate`) уже есть. **manualChunks разнести вендоры** - рискованно: дробление reka-ui ломает `inject`/createContext в проде.
+- [ ] **(low) Остаточный CLS** - после скелетона dashboard CLS: авторизованный reload 0.18, первый вход в демо 0.60 (было 1.10). Сдвиги в ~427-479ms - наполнение сайдбара (кошельки) и анимированный `md:pl-72` (`transition-all` в layoutClasses засчитывается как layout shift). Лечится скелетоном сайдбара / снятием transition на первом кадре.
+
+### Сделано: бандл/загрузка (2026-06-12)
+
+- **@powersync/web лениво** (`db.ts` `getPowerSyncDb()` - dynamic import либы+схемы+коннектора; `uploadErrorHandler.ts` выделен, чтобы статический импорт плагина не тянул либу; `UpdateType` в `uploadReconcile.ts` заменён строковым литералом). Entry: 1066 → **845 KB** (-25%, у main 752 KB). Авторизованный reload (8.2k trns): LCP 544 → **406ms**.
+- **swiper лениво** (`default.vue`: `LazyTrnFormBottom/Sidebar` монтируются после первого открытия формы, idle-prefetch чанка) - ушёл из критического пути загрузки.
+- **echarts после idle** (`useIdleMount.ts`, `stat/chart/Wrap.vue` - плейсхолдер той же высоты) - не конкурирует с LCP.
+- **Скелетон dashboard** (`stat/PageSkeleton.vue`, `dashboard.vue` по `hasAnyData`).
+- **WASM precache сужен** (`nuxt.config.ts` workbox: только `wa-sqlite-async.<hash>.wasm`, вместо 8 вариантов ~14MB → ~2.5MB; mc-сборки нужны только при `encryptionKey`, проверено по dist). Офлайн-загрузка авторизованного приложения проверена в браузере - работает.
+
### Прочее
- [ ] **WASM precache glob-сужение** - в precache все 8 wasm-вариантов (~14 MB), в рантайме грузится только `wa-sqlite-async` (`IDBBatchAtomicVFS`). Сузить glob - **после** ручного офлайн-теста в браузере, подтвердив грузимый вариант. Текущее безопасно, цена +14 MB при установке SW.