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.mdindex 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.