feat: Phases 4-7 — Full Feature Expansion (26 features)
Phase 4 — New Widget Types: - Clock/Weather, System Stats, RSS/Feed, Calendar, Markdown, Metric/Counter, Link Group, Camera/Stream widgets - Backend services with caching for each data source - Full creation form with dynamic config fields per type Phase 5 — Visual & Styling Enhancements: - Glassmorphism card style (solid/glass/outline) - Board-level themes with per-board hue/saturation - Animated SVG status rings replacing static dots - Card size options (compact/medium/large) - Custom CSS injection (admin + per-board, sanitized) - Wallpaper backgrounds with blur/overlay/parallax Phase 6 — Functional Features: - Favorites bar with drag-and-drop reordering - Recent apps tracking with privacy toggle - Uptime dashboard page (/status, guest-accessible) - Notifications system (Discord/Slack/Telegram/HTTP webhooks) - App tags with filtering in board view - Multi-URL app cards with expandable sub-links - Personal API tokens with scoped permissions - Audit log with retention and admin viewer Phase 7 — Quality of Life: - Onboarding wizard (5-step first-launch setup) - App URL health preview with favicon/title detection - Board templates (4 built-in + custom import/export) - Keyboard shortcut overlay (j/k nav, 1-9 boards, ? help) 212 files changed, 15641 insertions, 980 deletions. Build, lint, type check, and 222 tests all pass.
This commit is contained in:
@@ -1,12 +1,15 @@
|
||||
# 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
|
||||
@@ -15,6 +18,7 @@ exportService, importService, admin API endpoints, ImportExportPanel UI, Zod val
|
||||
- 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
|
||||
@@ -24,6 +28,7 @@ exportService, importService, admin API endpoints, ImportExportPanel UI, Zod val
|
||||
- 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)
|
||||
@@ -31,6 +36,7 @@ exportService, importService, admin API endpoints, ImportExportPanel UI, Zod val
|
||||
- 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
|
||||
|
||||
@@ -9,9 +9,11 @@
|
||||
**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`
|
||||
@@ -29,17 +31,18 @@ Add import/export, ping history sparklines, user theme overrides, PWA support, D
|
||||
|
||||
## Phase Progress Log
|
||||
|
||||
| Phase | Domain | Status | Review | Build | Committed |
|
||||
|-------|--------|--------|--------|-------|-----------|
|
||||
| Phase 1: Import/Export | fullstack | ✅ Done | ⬜ | ⬜ | ⬜ |
|
||||
| Phase 2: Sparklines | fullstack | ✅ Complete | ⬜ | ⬜ | ⬜ |
|
||||
| Phase 3: User Themes | fullstack | ✅ Complete | ⬜ | ⬜ | ⬜ |
|
||||
| Phase 4: PWA | frontend | ⬜ Not Started | ⬜ | ⬜ | ⬜ |
|
||||
| Phase 5: Auto-Discovery | backend | ⬜ Not Started | ⬜ | ⬜ | ⬜ |
|
||||
| Phase 6: Bookmarklet/Sync | fullstack | ⬜ Not Started | ⬜ | ⬜ | ⬜ |
|
||||
| Phase 7: Integration | fullstack | ✅ Complete | ✅ | ✅ | ⬜ |
|
||||
| Phase | Domain | Status | Review | Build | Committed |
|
||||
| ------------------------- | --------- | -------------- | ------ | ----- | --------- |
|
||||
| Phase 1: Import/Export | fullstack | ✅ Done | ⬜ | ⬜ | ⬜ |
|
||||
| Phase 2: Sparklines | fullstack | ✅ Complete | ⬜ | ⬜ | ⬜ |
|
||||
| Phase 3: User Themes | fullstack | ✅ Complete | ⬜ | ⬜ | ⬜ |
|
||||
| Phase 4: PWA | frontend | ⬜ Not Started | ⬜ | ⬜ | ⬜ |
|
||||
| Phase 5: Auto-Discovery | backend | ⬜ Not Started | ⬜ | ⬜ | ⬜ |
|
||||
| Phase 6: Bookmarklet/Sync | fullstack | ⬜ Not Started | ⬜ | ⬜ | ⬜ |
|
||||
| Phase 7: Integration | fullstack | ✅ Complete | ✅ | ✅ | ⬜ |
|
||||
|
||||
## Final Review
|
||||
|
||||
- [ ] Comprehensive code review
|
||||
- [ ] Full build passes
|
||||
- [ ] Full test suite passes
|
||||
|
||||
@@ -5,6 +5,7 @@
|
||||
**Domain:** fullstack
|
||||
|
||||
## Tasks
|
||||
|
||||
- [x] Task 1: Create `src/lib/server/services/exportService.ts` — export all data (apps, boards, sections, widgets, groups, settings) as JSON
|
||||
- [x] Task 2: Create `src/lib/server/services/importService.ts` — import JSON with conflict resolution (skip/overwrite)
|
||||
- [x] Task 3: Create `src/routes/api/admin/export/+server.ts` — GET endpoint, returns JSON file download
|
||||
|
||||
@@ -5,6 +5,7 @@
|
||||
**Domain:** fullstack
|
||||
|
||||
## Tasks
|
||||
|
||||
- [x] Task 1: Add `themeMode`, `primaryHue`, `primarySaturation`, `backgroundType`, `locale` fields to User model (Prisma migration)
|
||||
- [x] Task 2: Create `src/routes/api/users/me/preferences/+server.ts` — GET/PATCH user preferences
|
||||
- [x] Task 3: Create `src/routes/settings/+page.server.ts` — user settings page data
|
||||
@@ -16,4 +17,5 @@
|
||||
- [x] Task 9: Add i18n translations (EN/RU)
|
||||
|
||||
## Handoff to Next Phase
|
||||
|
||||
Phase 3 (User Theme Overrides) complete. Added nullable preference fields to User model, preferences API (GET/PATCH), settings page with ThemeCustomizer component (hue/saturation sliders, mode toggle, background selector, locale picker), server-side preference loading in layout, and Settings link in Header user menu. i18n translations added for EN and RU.
|
||||
|
||||
@@ -5,6 +5,7 @@
|
||||
**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
|
||||
@@ -13,4 +14,5 @@
|
||||
- [ ] Task 6: Add install prompt UI — detect `beforeinstallprompt` event, show install banner
|
||||
|
||||
## Handoff to Next Phase
|
||||
|
||||
<!-- Filled in after completion -->
|
||||
|
||||
@@ -5,6 +5,7 @@
|
||||
**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)
|
||||
@@ -15,9 +16,11 @@
|
||||
- [ ] 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
|
||||
|
||||
<!-- Filled in after completion -->
|
||||
|
||||
@@ -5,6 +5,7 @@
|
||||
**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
|
||||
@@ -14,8 +15,10 @@
|
||||
- [ ] 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
|
||||
|
||||
<!-- Filled in after completion -->
|
||||
|
||||
@@ -5,6 +5,7 @@
|
||||
**Domain:** fullstack
|
||||
|
||||
## Tasks
|
||||
|
||||
- [x] Task 1: Fix all TypeScript/build errors
|
||||
- [x] Task 2: Verify `npm run build` succeeds
|
||||
- [x] Task 3: Verify `npm run check` passes (0 errors, warnings only)
|
||||
@@ -26,4 +27,5 @@
|
||||
- Updated seed.ts: user preferences on admin/regular user, quick-add style Wiki.js app
|
||||
|
||||
## Handoff
|
||||
|
||||
<!-- Final phase -->
|
||||
|
||||
Reference in New Issue
Block a user