Files
web-app-launcher/plans/phase-3-advanced-features/CONTEXT.md
T
alexei.dolgolyov 7d8a8fb0fc feat(phase3): phase 7 - integration & polish
Fix all build/type/lint errors, write 46 new tests (222 total across
20 files), regenerate Prisma client, update seed with user preferences.
Fix SvelteSet usage, add {#each} keys, clean unused imports.
2026-03-25 01:12:11 +03:00

39 lines
2.6 KiB
Markdown

# Feature Context: Phase 3 — Advanced Features
## Current State
Phase 7 (Integration & Polish) is complete. 222 tests across 20 test files, full build passes, `npm run check` 0 errors, `npm run lint` 0 errors. All phases 1-7 are done.
### Phase 1 (Import/Export) Summary
exportService, importService, admin API endpoints, ImportExportPanel UI, Zod validation schema, i18n EN/RU translations.
### Phase 2 (Sparklines) Summary
- History API at `/api/apps/[id]/history` — returns last 288 status records with uptime percentage
- `SparklineChart.svelte` — inline SVG bar chart with color-coded status bars (green/red/yellow/gray)
- `AppWidget.svelte` and `AppCard.svelte` updated to fetch and display sparklines on mount
- `pruneOldStatuses()` in healthcheck service — deletes records >24h, caps at 288 per app
- Hourly cleanup cron job in healthcheck scheduler
- i18n keys: `app.uptime`, `app.history_loading` (EN/RU)
### Phase 3 (User Theme Overrides) Summary
- Prisma migration: added `themeMode`, `primaryHue`, `primarySaturation`, `backgroundType`, `locale` nullable fields to User model
- Preferences API at `/api/users/me/preferences` — GET returns preferences, PATCH updates subset
- Settings page at `/settings` with `ThemeCustomizer.svelte` — hue/saturation sliders, mode toggle (dark/light/system), background selector, locale picker, save button
- Theme store `loadFromServer(prefs)` method applies server preferences over localStorage defaults
- `+layout.server.ts` passes `userPreferences` in layout data; `+layout.svelte` applies them on mount
- Header user menu includes "Settings" link
- i18n keys: `settings.title`, `settings.theme`, `settings.primary_color`, `settings.hue`, `settings.saturation`, `settings.background`, `settings.language`, `settings.save`, `settings.saving`, `settings.saved` (EN/RU)
### Phase 7 (Integration & Polish) Summary
- Prisma client regenerated with user preference fields
- Fixed lint errors: SvelteSet for reactive Set in DiscoveryPanel, `{#each}` keys in DiscoveryPanel/SparklineChart, unused vars in ThemeCustomizer/AppWidget
- 46 new tests: exportService (4), importService (9), discoveryService (10), preferences API (11), quick-add API (8), broadcastSync (4)
- Seed script updated: user preferences on admin/regular user, quick-add style Wiki.js app
- Final state: 222 tests, 0 build errors, 0 type errors, 0 lint errors
## Cross-Phase Dependencies
- Phases 1-3 are independent (import/export, sparklines, user themes)
- Phase 4 (PWA) is independent
- Phase 5 (auto-discovery) is independent
- Phase 6 (bookmarklet/sync) depends on existing API
- Phase 7 (integration) depends on all prior phases