Phase 4: Webhooks, Backup/Restore UI, Onboarding/Tutorial

- Webhooks Backend: model, schema, service (HMAC-SHA256, httpx), routes, event bus dispatcher, migration 0042
- Webhooks Frontend: SettingsWebhooksPage (CRUD, test button, event multi-select), API client
- Backup/Restore Backend: model, schema, service (pg_dump/pg_restore), routes (admin-only), migration 0043
- Backup/Restore Frontend: SettingsBackupPage (create, list, restore dialog with RESTORE confirmation, auto-refresh)
- Onboarding: OnboardingTour (8 steps, custom CSS overlay), WelcomeDialog, onboardingStore (zustand + localStorage)
- Onboarding integrated into AppShell
- Routes: /settings/webhooks, /settings/backup registered
- Settings nav: Webhooks, Backup & Restore entries added
- Migration conflict fixed: 0042_webhooks → 0043_backups chain
This commit is contained in:
Agent Zero
2026-07-26 03:17:40 +02:00
parent 10dcc8ae90
commit 79ece0fe2e
23 changed files with 3094 additions and 0 deletions
+102
View File
@@ -0,0 +1,102 @@
import { create } from 'zustand';
/**
* Onboarding Store — manages the guided tour state for first-time users.
* Persists to localStorage so progress survives page reloads.
*/
const STORAGE_KEY = 'leocrm_onboarding';
export interface OnboardingState {
isActive: boolean;
step: number;
completed: boolean;
skipped: boolean;
start: () => void;
next: () => void;
prev: () => void;
skip: () => void;
complete: () => void;
goToStep: (n: number) => void;
reset: () => void;
}
interface PersistedData {
step: number;
completed: boolean;
skipped: boolean;
}
function loadPersisted(): Partial<OnboardingState> {
try {
const raw = localStorage.getItem(STORAGE_KEY);
if (!raw) return {};
const data: PersistedData = JSON.parse(raw);
return {
step: data.step ?? 0,
completed: data.completed ?? false,
skipped: data.skipped ?? false,
};
} catch {
return {};
}
}
function persist(state: OnboardingState): void {
try {
const data: PersistedData = {
step: state.step,
completed: state.completed,
skipped: state.skipped,
};
localStorage.setItem(STORAGE_KEY, JSON.stringify(data));
} catch {
// localStorage may be unavailable in some contexts
}
}
const initial = loadPersisted();
export const useOnboardingStore = create<OnboardingState>((set, get) => ({
isActive: false,
step: initial.step ?? 0,
completed: initial.completed ?? false,
skipped: initial.skipped ?? false,
start: () => {
set({ isActive: true, step: 0, completed: false, skipped: false });
persist(get());
},
next: () => {
const s = get();
set({ step: s.step + 1 });
persist(get());
},
prev: () => {
const s = get();
set({ step: Math.max(0, s.step - 1) });
persist(get());
},
skip: () => {
set({ isActive: false, skipped: true });
persist(get());
},
complete: () => {
set({ isActive: false, completed: true, step: 0 });
persist(get());
},
goToStep: (n: number) => {
set({ step: Math.max(0, n) });
persist(get());
},
reset: () => {
set({ isActive: false, step: 0, completed: false, skipped: false });
persist(get());
},
}));