added a help system, replaced the words "tenant" and "Pwa" with better alternatives. corrected and implemented cron jobs. prepared going live on a coolify-powered system.

2025-11-10 16:23:09 +01:00
parent ba9e64dfcb
commit 447a90a742
123 changed files with 6398 additions and 153 deletions
--- a/resources/js/guest/pages/GalleryPage.tsx
+++ b/resources/js/guest/pages/GalleryPage.tsx
@@ -13,11 +13,19 @@ import PhotoLightbox from './PhotoLightbox';
 import { fetchEvent, getEventPackage, fetchStats, type EventData, type EventPackage, type EventStats } from '../services/eventApi';
 import { useTranslation } from '../i18n/useTranslation';

+const allowedGalleryFilters: GalleryFilter[] = ['latest', 'popular', 'mine', 'photobooth'];
+
+const parseGalleryFilter = (value: string | null): GalleryFilter =>
+  allowedGalleryFilters.includes(value as GalleryFilter) ? (value as GalleryFilter) : 'latest';
+
 export default function GalleryPage() {
  const { token } = useParams<{ token?: string }>();
  const navigate = useNavigate();
  const { photos, loading, newCount, acknowledgeNew } = usePollGalleryDelta(token ?? '');
-  const [filter, setFilter] = React.useState<GalleryFilter>('latest');
+  const [searchParams, setSearchParams] = useSearchParams();
+  const photoIdParam = searchParams.get('photoId');
+  const modeParam = searchParams.get('mode');
+  const [filter, setFilterState] = React.useState<GalleryFilter>(() => parseGalleryFilter(modeParam));
  const [currentPhotoIndex, setCurrentPhotoIndex] = React.useState<number | null>(null);
  const [hasOpenedPhoto, setHasOpenedPhoto] = useState(false);

@@ -28,8 +36,16 @@ export default function GalleryPage() {
  const { t } = useTranslation();
  const locale = typeof window !== 'undefined' ? window.navigator.language : 'de-DE';

-  const [searchParams] = useSearchParams();
-  const photoIdParam = searchParams.get('photoId');
+  useEffect(() => {
+    setFilterState(parseGalleryFilter(modeParam));
+  }, [modeParam]);
+
+  const setFilter = React.useCallback((next: GalleryFilter) => {
+    setFilterState(next);
+    const params = new URLSearchParams(searchParams);
+    params.set('mode', next);
+    setSearchParams(params, { replace: true });
+  }, [searchParams, setSearchParams]);
  // Auto-open lightbox if photoId in query params
  useEffect(() => {
    if (photoIdParam && photos.length > 0 && currentPhotoIndex === null && !hasOpenedPhoto) {
@@ -79,6 +95,9 @@ export default function GalleryPage() {
      arr.sort((a: any, b: any) => (b.likes_count ?? 0) - (a.likes_count ?? 0));
    } else if (filter === 'mine') {
      arr = arr.filter((p: any) => myPhotoIds.has(p.id));
+    } else if (filter === 'photobooth') {
+      arr = arr.filter((p: any) => p.ingest_source === 'photobooth');
+      arr.sort((a: any, b: any) => new Date(b.created_at ?? 0).getTime() - new Date(a.created_at ?? 0).getTime());
    } else {
      arr.sort((a: any, b: any) => new Date(b.created_at ?? 0).getTime() - new Date(a.created_at ?? 0).getTime());
    }
--- a/resources/js/guest/pages/HelpArticlePage.tsx
+++ b/resources/js/guest/pages/HelpArticlePage.tsx
@@ -0,0 +1,121 @@
+import React from 'react';
+import { Link, useParams } from 'react-router-dom';
+import { Badge } from '@/components/ui/badge';
+import { Button } from '@/components/ui/button';
+import { Loader2 } from 'lucide-react';
+import { Page } from './_util';
+import { useLocale } from '../i18n/LocaleContext';
+import { useTranslation } from '../i18n/useTranslation';
+import { getHelpArticle, type HelpArticleDetail } from '../services/helpApi';
+
+export default function HelpArticlePage() {
+  const params = useParams<{ token?: string; slug: string }>();
+  const slug = params.slug;
+  const { locale } = useLocale();
+  const { t } = useTranslation();
+  const [article, setArticle] = React.useState<HelpArticleDetail | null>(null);
+  const [state, setState] = React.useState<'loading' | 'ready' | 'error'>('loading');
+  const [servedFromCache, setServedFromCache] = React.useState(false);
+  const basePath = params.token ? `/e/${encodeURIComponent(params.token)}/help` : '/help';
+
+  const loadArticle = React.useCallback(async () => {
+    if (!slug) {
+      setState('error');
+      return;
+    }
+    setState('loading');
+    try {
+      const result = await getHelpArticle(slug, locale);
+      setArticle(result.article);
+      setServedFromCache(result.servedFromCache);
+      setState('ready');
+    } catch (error) {
+      console.error('[HelpArticle] Failed to load article', error);
+      setState('error');
+    }
+  }, [slug, locale]);
+
+  React.useEffect(() => {
+    loadArticle();
+  }, [loadArticle]);
+
+  const title = article?.title ?? t('help.article.unavailable');
+
+  return (
+    <Page title={title}>
+      <div className="mb-4">
+        <Button variant="ghost" size="sm" asChild>
+          <Link to={basePath}>
+            {t('help.article.back')}
+          </Link>
+        </Button>
+      </div>
+
+      {state === 'loading' && (
+        <div className="flex items-center gap-2 text-sm text-muted-foreground">
+          <Loader2 className="h-4 w-4 animate-spin" />
+          {t('common.actions.loading')}
+        </div>
+      )}
+
+      {state === 'error' && (
+        <div className="space-y-3 rounded-lg border border-destructive/30 bg-destructive/10 p-4 text-sm text-destructive">
+          <p>{t('help.article.unavailable')}</p>
+          <Button variant="secondary" size="sm" onClick={loadArticle}>
+            {t('help.article.reload')}
+          </Button>
+        </div>
+      )}
+
+      {state === 'ready' && article && (
+        <article className="space-y-6">
+          <div className="space-y-2 text-sm text-muted-foreground">
+            {article.updated_at && (
+              <div>{t('help.article.updated', { date: formatDate(article.updated_at, locale) })}</div>
+            )}
+            {servedFromCache && (
+              <Badge variant="secondary" className="bg-amber-200/70 text-amber-900 dark:bg-amber-500/30 dark:text-amber-100">
+                {t('help.center.offlineBadge')}
+              </Badge>
+            )}
+          </div>
+          <div
+            className="prose prose-sm max-w-none dark:prose-invert"
+            dangerouslySetInnerHTML={{ __html: article.body_html ?? article.body_markdown ?? '' }}
+          />
+          {article.related && article.related.length > 0 && (
+            <section className="space-y-3">
+              <h3 className="text-base font-semibold text-foreground">{t('help.article.relatedTitle')}</h3>
+              <div className="flex flex-wrap gap-2">
+                {article.related.map((rel) => (
+                  <Button
+                    key={rel.slug}
+                    variant="outline"
+                    size="sm"
+                    asChild
+                  >
+                    <Link to={`${basePath}/${encodeURIComponent(rel.slug)}`}>
+                      {rel.slug}
+                    </Link>
+                  </Button>
+                ))}
+              </div>
+            </section>
+          )}
+        </article>
+      )}
+    </Page>
+  );
+}
+
+function formatDate(value: string, locale: string): string {
+  try {
+    return new Date(value).toLocaleDateString(locale, {
+      day: '2-digit',
+      month: 'short',
+      year: 'numeric',
+    });
+  } catch (error) {
+    return value;
+  }
+}
--- a/resources/js/guest/pages/HelpCenterPage.tsx
+++ b/resources/js/guest/pages/HelpCenterPage.tsx
@@ -0,0 +1,153 @@
+import React from 'react';
+import { Link, useParams } from 'react-router-dom';
+import { Badge } from '@/components/ui/badge';
+import { Button } from '@/components/ui/button';
+import { Input } from '@/components/ui/input';
+import { Loader2, RefreshCcw } from 'lucide-react';
+import { Page } from './_util';
+import { useLocale } from '../i18n/LocaleContext';
+import { useTranslation } from '../i18n/useTranslation';
+import { getHelpArticles, type HelpArticleSummary } from '../services/helpApi';
+
+export default function HelpCenterPage() {
+  const params = useParams<{ token?: string }>();
+  const { locale } = useLocale();
+  const { t } = useTranslation();
+  const [articles, setArticles] = React.useState<HelpArticleSummary[]>([]);
+  const [query, setQuery] = React.useState('');
+  const [state, setState] = React.useState<'idle' | 'loading' | 'ready' | 'error'>('loading');
+  const [servedFromCache, setServedFromCache] = React.useState(false);
+  const basePath = params.token ? `/e/${encodeURIComponent(params.token)}/help` : '/help';
+
+  const loadArticles = React.useCallback(async (forceRefresh = false) => {
+    setState('loading');
+    try {
+      const result = await getHelpArticles(locale, { forceRefresh });
+      setArticles(result.articles);
+      setServedFromCache(result.servedFromCache);
+      setState('ready');
+    } catch (error) {
+      console.error('[HelpCenter] Failed to load articles', error);
+      setState('error');
+    }
+  }, [locale]);
+
+  React.useEffect(() => {
+    loadArticles();
+  }, [loadArticles]);
+
+  const filteredArticles = React.useMemo(() => {
+    if (!query.trim()) {
+      return articles;
+    }
+    const needle = query.trim().toLowerCase();
+    return articles.filter((article) =>
+      `${article.title} ${article.summary}`.toLowerCase().includes(needle),
+    );
+  }, [articles, query]);
+
+  return (
+    <Page title={t('help.center.title')}>
+      <p className="mb-4 text-sm text-muted-foreground">{t('help.center.subtitle')}</p>
+
+      <div className="flex flex-col gap-2 rounded-xl border border-border/60 bg-background/50 p-3">
+        <div className="flex flex-col gap-3 sm:flex-row">
+          <Input
+            placeholder={t('help.center.searchPlaceholder')}
+            value={query}
+            onChange={(event) => setQuery(event.target.value)}
+            className="flex-1"
+            aria-label={t('help.center.searchPlaceholder')}
+          />
+          <Button
+            variant="outline"
+            className="sm:w-auto"
+            onClick={() => loadArticles(true)}
+            disabled={state === 'loading'}
+          >
+            {state === 'loading' ? (
+              <span className="flex items-center gap-2">
+                <Loader2 className="h-4 w-4 animate-spin" />
+                {t('common.actions.loading')}
+              </span>
+            ) : (
+              <span className="flex items-center gap-2">
+                <RefreshCcw className="h-4 w-4" />
+                {t('help.center.retry')}
+              </span>
+            )}
+          </Button>
+        </div>
+        {servedFromCache && (
+          <div className="flex items-center gap-2 rounded-lg bg-amber-50/70 px-3 py-2 text-xs text-amber-900 dark:bg-amber-400/10 dark:text-amber-200">
+            <Badge variant="secondary" className="bg-amber-200/80 text-amber-900 dark:bg-amber-500/40 dark:text-amber-100">
+              {t('help.center.offlineBadge')}
+            </Badge>
+            <span>{t('help.center.offlineDescription')}</span>
+          </div>
+        )}
+      </div>
+
+      <section className="mt-6 space-y-4">
+        <h2 className="text-base font-semibold text-foreground">{t('help.center.listTitle')}</h2>
+        {state === 'loading' && (
+          <div className="flex items-center gap-2 text-sm text-muted-foreground">
+            <Loader2 className="h-4 w-4 animate-spin" />
+            {t('common.actions.loading')}
+          </div>
+        )}
+        {state === 'error' && (
+          <div className="rounded-lg border border-destructive/30 bg-destructive/10 p-4 text-sm text-destructive">
+            <p>{t('help.center.error')}</p>
+            <Button
+              variant="secondary"
+              size="sm"
+              className="mt-3"
+              onClick={() => loadArticles(false)}
+            >
+              {t('help.center.retry')}
+            </Button>
+          </div>
+        )}
+        {state === 'ready' && filteredArticles.length === 0 && (
+          <div className="rounded-lg border border-dashed border-muted-foreground/30 p-4 text-sm text-muted-foreground">
+            {t('help.center.empty')}
+          </div>
+        )}
+        {state === 'ready' && filteredArticles.length > 0 && (
+          <div className="space-y-3">
+            {filteredArticles.map((article) => (
+              <Link
+                key={article.slug}
+                to={`${basePath}/${encodeURIComponent(article.slug)}`}
+                className="block rounded-2xl border border-border/60 bg-card/70 p-4 transition-colors hover:border-primary/60"
+              >
+                <div className="flex items-start justify-between gap-3">
+                  <div>
+                    <h3 className="text-base font-semibold text-foreground">{article.title}</h3>
+                    <p className="mt-1 text-sm text-muted-foreground line-clamp-3">{article.summary}</p>
+                  </div>
+                  <span className="text-xs text-muted-foreground">
+                    {article.updated_at ? formatDate(article.updated_at, locale) : ''}
+                  </span>
+                </div>
+              </Link>
+            ))}
+          </div>
+        )}
+      </section>
+    </Page>
+  );
+}
+
+function formatDate(value: string, locale: string): string {
+  try {
+    return new Date(value).toLocaleDateString(locale, {
+      day: '2-digit',
+      month: 'short',
+      year: 'numeric',
+    });
+  } catch (error) {
+    return value;
+  }
+}