Files
web-app-launcher/plans/phase-3-advanced-features/CONTEXT.md
T
alexei.dolgolyov c6a7de895d feat(phase3): import/export, sparklines, user theme overrides
- JSON import/export with conflict resolution (skip/overwrite) + admin UI
- Ping history sparklines on AppWidget and AppCard (24h, 288 points)
- Hourly cleanup job for old AppStatus records
- User theme preferences (hue, saturation, mode, background, locale)
- Settings page with ThemeCustomizer (sliders, toggles, live preview)
- Prisma migration for user preference fields
- i18n translations for all new strings (EN/RU)
2026-03-25 00:51:01 +03:00

2.1 KiB

Feature Context: Phase 3 — Advanced Features

Current State

Phase 2 is complete and merged. 176 tests, full build passes. Phase 3 in progress. Phase 1 (Import/Export), Phase 2 (Sparklines), and Phase 3 (User Theme Overrides) are complete.

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)

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