From d155b3ce4ae1d7df92ca8cf3e2987793ce7132fd Mon Sep 17 00:00:00 2001 From: "alexei.dolgolyov" Date: Wed, 25 Mar 2026 00:16:41 +0300 Subject: [PATCH] chore: add plan files for Phase 3 advanced features --- plans/phase-3-advanced-features/CONTEXT.md | 11 +++++ plans/phase-3-advanced-features/PLAN.md | 46 +++++++++++++++++++ .../phase-1-import-export.md | 18 ++++++++ .../phase-2-sparklines.md | 18 ++++++++ .../phase-3-user-themes.md | 19 ++++++++ .../phase-3-advanced-features/phase-4-pwa.md | 16 +++++++ .../phase-5-autodiscovery.md | 23 ++++++++++ .../phase-6-bookmarklet-sync.md | 21 +++++++++ .../phase-7-integration.md | 21 +++++++++ 9 files changed, 193 insertions(+) create mode 100644 plans/phase-3-advanced-features/CONTEXT.md create mode 100644 plans/phase-3-advanced-features/PLAN.md create mode 100644 plans/phase-3-advanced-features/phase-1-import-export.md create mode 100644 plans/phase-3-advanced-features/phase-2-sparklines.md create mode 100644 plans/phase-3-advanced-features/phase-3-user-themes.md create mode 100644 plans/phase-3-advanced-features/phase-4-pwa.md create mode 100644 plans/phase-3-advanced-features/phase-5-autodiscovery.md create mode 100644 plans/phase-3-advanced-features/phase-6-bookmarklet-sync.md create mode 100644 plans/phase-3-advanced-features/phase-7-integration.md diff --git a/plans/phase-3-advanced-features/CONTEXT.md b/plans/phase-3-advanced-features/CONTEXT.md new file mode 100644 index 0000000..51ff6e4 --- /dev/null +++ b/plans/phase-3-advanced-features/CONTEXT.md @@ -0,0 +1,11 @@ +# Feature Context: Phase 3 — Advanced Features + +## Current State +Phase 2 is complete and merged. 176 tests, full build passes. Starting Phase 3 advanced features. + +## 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 diff --git a/plans/phase-3-advanced-features/PLAN.md b/plans/phase-3-advanced-features/PLAN.md new file mode 100644 index 0000000..c62d019 --- /dev/null +++ b/plans/phase-3-advanced-features/PLAN.md @@ -0,0 +1,46 @@ +# Feature: Phase 3 — Advanced Features + +**Branch:** `feature/phase-3-advanced-features` +**Base branch:** `master` +**Created:** 2026-03-25 +**Status:** 🟡 In Progress +**Strategy:** Big Bang +**Mode:** Automated +**Execution:** Orchestrator + +## Summary +Add import/export, ping history sparklines, user theme overrides, PWA support, Docker/Traefik auto-discovery, quick-add bookmarklet, and multi-tab sync. + +## Build & Test Commands +- **Build:** `npm run build` +- **Test:** `npm test` +- **Lint:** `npm run lint` +- **Type Check:** `npm run check` + +## Phases + +- [ ] Phase 1: Import/Export [fullstack] → [subplan](./phase-1-import-export.md) +- [ ] Phase 2: Ping History Sparklines [fullstack] → [subplan](./phase-2-sparklines.md) +- [ ] Phase 3: User Theme Overrides [fullstack] → [subplan](./phase-3-user-themes.md) +- [ ] Phase 4: PWA Support [frontend] → [subplan](./phase-4-pwa.md) +- [ ] Phase 5: Auto-Discovery Docker/Traefik [backend] → [subplan](./phase-5-autodiscovery.md) +- [ ] Phase 6: Bookmarklet & Multi-Tab Sync [fullstack] → [subplan](./phase-6-bookmarklet-sync.md) +- [ ] Phase 7: Integration & Polish [fullstack] → [subplan](./phase-7-integration.md) + +## Phase Progress Log + +| Phase | Domain | Status | Review | Build | Committed | +|-------|--------|--------|--------|-------|-----------| +| Phase 1: Import/Export | fullstack | ⬜ Not Started | ⬜ | ⬜ | ⬜ | +| Phase 2: Sparklines | fullstack | ⬜ Not Started | ⬜ | ⬜ | ⬜ | +| Phase 3: User Themes | fullstack | ⬜ Not Started | ⬜ | ⬜ | ⬜ | +| Phase 4: PWA | frontend | ⬜ Not Started | ⬜ | ⬜ | ⬜ | +| Phase 5: Auto-Discovery | backend | ⬜ Not Started | ⬜ | ⬜ | ⬜ | +| Phase 6: Bookmarklet/Sync | fullstack | ⬜ Not Started | ⬜ | ⬜ | ⬜ | +| Phase 7: Integration | fullstack | ⬜ Not Started | ⬜ | ⬜ | ⬜ | + +## Final Review +- [ ] Comprehensive code review +- [ ] Full build passes +- [ ] Full test suite passes +- [ ] Merged to `master` diff --git a/plans/phase-3-advanced-features/phase-1-import-export.md b/plans/phase-3-advanced-features/phase-1-import-export.md new file mode 100644 index 0000000..fc2d73d --- /dev/null +++ b/plans/phase-3-advanced-features/phase-1-import-export.md @@ -0,0 +1,18 @@ +# Phase 1: Import/Export + +**Status:** ⬜ Not Started +**Parent plan:** [PLAN.md](./PLAN.md) +**Domain:** fullstack + +## Tasks +- [ ] Task 1: Create `src/lib/server/services/exportService.ts` — export all data (apps, boards, sections, widgets, groups, settings) as JSON +- [ ] Task 2: Create `src/lib/server/services/importService.ts` — import JSON with conflict resolution (skip/overwrite) +- [ ] Task 3: Create `src/routes/api/admin/export/+server.ts` — GET endpoint, returns JSON file download +- [ ] Task 4: Create `src/routes/api/admin/import/+server.ts` — POST endpoint, accepts JSON upload +- [ ] Task 5: Update admin settings page — add Import/Export section with download button and file upload +- [ ] Task 6: Create `src/lib/components/admin/ImportExportPanel.svelte` — UI with export button, file picker, preview, and import button +- [ ] Task 7: Add Zod schema for validating import data structure +- [ ] Task 8: Add i18n translations for import/export strings (EN/RU) + +## Handoff to Next Phase + diff --git a/plans/phase-3-advanced-features/phase-2-sparklines.md b/plans/phase-3-advanced-features/phase-2-sparklines.md new file mode 100644 index 0000000..496c2ad --- /dev/null +++ b/plans/phase-3-advanced-features/phase-2-sparklines.md @@ -0,0 +1,18 @@ +# Phase 2: Ping History Sparklines + +**Status:** ⬜ Not Started +**Parent plan:** [PLAN.md](./PLAN.md) +**Domain:** fullstack + +## Tasks +- [ ] Task 1: Create `src/routes/api/apps/[id]/history/+server.ts` — GET last 24h of healthcheck results +- [ ] Task 2: Create `src/lib/components/app/SparklineChart.svelte` — tiny inline SVG sparkline (green=up, red=down) +- [ ] Task 3: Update `src/lib/components/widget/AppWidget.svelte` — show sparkline below status badge +- [ ] Task 4: Update `src/lib/components/app/AppCard.svelte` — show sparkline on app cards +- [ ] Task 5: Calculate and display uptime percentage (last 24h) +- [ ] Task 6: Update healthcheck service to retain last 288 records per app (24h at 5min intervals) +- [ ] Task 7: Add cleanup job to prune old AppStatus records beyond retention period +- [ ] Task 8: Add i18n translations (EN/RU) + +## Handoff to Next Phase + diff --git a/plans/phase-3-advanced-features/phase-3-user-themes.md b/plans/phase-3-advanced-features/phase-3-user-themes.md new file mode 100644 index 0000000..9661f38 --- /dev/null +++ b/plans/phase-3-advanced-features/phase-3-user-themes.md @@ -0,0 +1,19 @@ +# Phase 3: User Theme Overrides + +**Status:** ⬜ Not Started +**Parent plan:** [PLAN.md](./PLAN.md) +**Domain:** fullstack + +## Tasks +- [ ] Task 1: Add `themeMode`, `primaryHue`, `primarySaturation`, `backgroundType`, `locale` fields to User model (Prisma migration) +- [ ] Task 2: Create `src/routes/api/users/me/preferences/+server.ts` — GET/PATCH user preferences +- [ ] Task 3: Create `src/routes/settings/+page.server.ts` — user settings page data +- [ ] Task 4: Create `src/routes/settings/+page.svelte` — user settings page with theme customization +- [ ] Task 5: Create `src/lib/components/settings/ThemeCustomizer.svelte` — HSL color picker, background selector, mode toggle +- [ ] Task 6: Update theme store to load user preferences from server on login +- [ ] Task 7: Update `+layout.server.ts` to pass user preferences +- [ ] Task 8: Add user settings link to header user menu +- [ ] Task 9: Add i18n translations (EN/RU) + +## Handoff to Next Phase + diff --git a/plans/phase-3-advanced-features/phase-4-pwa.md b/plans/phase-3-advanced-features/phase-4-pwa.md new file mode 100644 index 0000000..f4dbbe8 --- /dev/null +++ b/plans/phase-3-advanced-features/phase-4-pwa.md @@ -0,0 +1,16 @@ +# Phase 4: PWA Support + +**Status:** ⬜ Not Started +**Parent plan:** [PLAN.md](./PLAN.md) +**Domain:** frontend + +## Tasks +- [ ] Task 1: Create `static/manifest.json` — web app manifest with name, icons, theme color, display: standalone +- [ ] Task 2: Create app icons in `static/` — 192x192 and 512x512 PNG (simple grid icon) +- [ ] Task 3: Create `src/service-worker.ts` — SvelteKit service worker with cache-first for static assets, network-first for API +- [ ] Task 4: Update `src/app.html` — add manifest link, theme-color meta, apple-mobile-web-app meta tags +- [ ] Task 5: Create offline fallback page — show when no network and no cache +- [ ] Task 6: Add install prompt UI — detect `beforeinstallprompt` event, show install banner + +## Handoff to Next Phase + diff --git a/plans/phase-3-advanced-features/phase-5-autodiscovery.md b/plans/phase-3-advanced-features/phase-5-autodiscovery.md new file mode 100644 index 0000000..691e6e3 --- /dev/null +++ b/plans/phase-3-advanced-features/phase-5-autodiscovery.md @@ -0,0 +1,23 @@ +# Phase 5: Auto-Discovery (Docker/Traefik) + +**Status:** ⬜ Not Started +**Parent plan:** [PLAN.md](./PLAN.md) +**Domain:** backend + +## Tasks +- [ ] Task 1: Create `src/lib/server/services/discoveryService.ts` — Docker socket scanning and Traefik API parsing +- [ ] Task 2: Create `src/routes/api/admin/discover/+server.ts` — POST triggers discovery scan, returns found services +- [ ] Task 3: Create `src/routes/api/admin/discover/approve/+server.ts` — POST approves discovered apps (creates them) +- [ ] Task 4: Create `src/lib/components/admin/DiscoveryPanel.svelte` — UI to trigger scan, review results, approve/reject +- [ ] Task 5: Add discovery settings to SystemSettings (Docker socket path, Traefik API URL, auto-scan toggle) +- [ ] Task 6: Update admin settings page with discovery configuration section +- [ ] Task 7: Add env vars: DOCKER_SOCKET_PATH, TRAEFIK_API_URL +- [ ] Task 8: Add i18n translations (EN/RU) + +## Notes +- Docker discovery: read from `/var/run/docker.sock` (or configured path), list containers, extract labels for name/URL +- Traefik discovery: query Traefik API `/api/http/routers` and `/api/http/services` +- Both are optional — gracefully handle when Docker socket or Traefik API is unavailable + +## Handoff to Next Phase + diff --git a/plans/phase-3-advanced-features/phase-6-bookmarklet-sync.md b/plans/phase-3-advanced-features/phase-6-bookmarklet-sync.md new file mode 100644 index 0000000..41c2a5d --- /dev/null +++ b/plans/phase-3-advanced-features/phase-6-bookmarklet-sync.md @@ -0,0 +1,21 @@ +# Phase 6: Quick-Add Bookmarklet & Multi-Tab Sync + +**Status:** ⬜ Not Started +**Parent plan:** [PLAN.md](./PLAN.md) +**Domain:** fullstack + +## Tasks +- [ ] Task 1: Create `src/routes/api/apps/quick-add/+server.ts` — POST endpoint that accepts URL + title, creates app with defaults +- [ ] Task 2: Create `src/lib/components/admin/BookmarkletGenerator.svelte` — generates bookmarklet JS code with user's API token +- [ ] Task 3: Add bookmarklet section to user settings page +- [ ] Task 4: Create `src/lib/utils/broadcastSync.ts` — BroadcastChannel wrapper for cross-tab sync +- [ ] Task 5: Sync theme changes across tabs (dark/light toggle, primary color) +- [ ] Task 6: Sync board changes across tabs (new boards appear in sidebar) +- [ ] Task 7: Add i18n translations (EN/RU) + +## Notes +- Bookmarklet: `javascript:void(fetch('ORIGIN/api/apps/quick-add',{method:'POST',headers:{'Content-Type':'application/json','Authorization':'Bearer TOKEN'},body:JSON.stringify({url:location.href,name:document.title})}))` +- BroadcastChannel: create channel 'wal-sync', post messages on theme/board changes, listen in layout + +## Handoff to Next Phase + diff --git a/plans/phase-3-advanced-features/phase-7-integration.md b/plans/phase-3-advanced-features/phase-7-integration.md new file mode 100644 index 0000000..081d042 --- /dev/null +++ b/plans/phase-3-advanced-features/phase-7-integration.md @@ -0,0 +1,21 @@ +# Phase 7: Integration & Polish + +**Status:** ⬜ Not Started +**Parent plan:** [PLAN.md](./PLAN.md) +**Domain:** fullstack + +## Tasks +- [ ] Task 1: Fix all TypeScript/build errors +- [ ] Task 2: Verify `npm run build` succeeds +- [ ] Task 3: Verify `npm run check` passes +- [ ] Task 4: Verify `npm run lint` passes +- [ ] Task 5: Write tests for export/import services +- [ ] Task 6: Write tests for discovery service +- [ ] Task 7: Write tests for user preferences API +- [ ] Task 8: Write tests for quick-add API +- [ ] Task 9: Update seed script with sample data +- [ ] Task 10: Verify all existing tests pass +- [ ] Task 11: Run Prisma migrations + +## Handoff +