Refresh admin help articles for event PWA
This commit is contained in:
Codex Agent
@@ -1,37 +1,42 @@
|
||||
---
|
||||
title: "Troubleshooting & Issue Resolution"
|
||||
title: "Troubleshooting & FAQ"
|
||||
locale: en
|
||||
slug: admin-issue-resolution
|
||||
audience: admin
|
||||
summary: "Playbooks for the most common admin-side incidents, from stuck uploads to billing locks."
|
||||
summary: "Quick answers for the most common admin-side issues."
|
||||
version_introduced: 2025.4
|
||||
requires_app_version: "^3.2.0"
|
||||
status: draft
|
||||
translation_state: aligned
|
||||
last_reviewed_at: 2025-02-22
|
||||
last_reviewed_at: 2026-01-23
|
||||
owner: reliability@fotospiel.app
|
||||
related:
|
||||
- slug: live-ops-control
|
||||
- slug: privacy-and-support
|
||||
- slug: event-prep-checklist
|
||||
---
|
||||
|
||||
## Upload incidents
|
||||
| Symptom | Diagnosis | Fix |
|
||||
| --- | --- | --- |
|
||||
| Queue stuck >10 min | Check Live Ops health widget | Run `php artisan media:backfill-thumbnails --tenant=XYZ` then reopen event |
|
||||
| Specific guest blocked | Guest reached per-device limit | Increase limit under Event → Upload rules or ask them to clear drafts |
|
||||
| Photos missing EXIF | Guest imported screenshots | No action; remind them that EXIF is optional |
|
||||
## FAQ
|
||||
**Photos are not showing up. What now?**
|
||||
- Check whether the event is **Published**.
|
||||
- Verify the guest used the correct join link or QR.
|
||||
- If moderation is enabled, approve the upload in Live Ops.
|
||||
|
||||
## Access issues
|
||||
- **Admin cannot log in**: verify invite accepted; reset via *Team → Resend invite*. Check SSO mapping if enforced.
|
||||
- **Guest cannot join**: confirm event status is *Published* and share direct join URL `https://app.fotospiel.com/join/<code>`.
|
||||
**Guests cannot join the event.**
|
||||
- Confirm the event status is **Published**.
|
||||
- Re-share the QR or join link from the dashboard.
|
||||
- Ask the guest to refresh or reopen the app.
|
||||
|
||||
## Billing & quotas
|
||||
- Paddle webhook failure locks uploads: check `storage/logs/paddle.log`, re-send webhook via Paddle dashboard, then toggle the subscription status.
|
||||
- Storage 90% full: run archive early or purchase add-on via Paddle customer portal.
|
||||
**Uploads are stuck in the queue.**
|
||||
- Use Live Ops to approve or hide items and clear backlog.
|
||||
- If the queue keeps growing, tighten moderation and reduce Live Show effects.
|
||||
|
||||
## Communication templates
|
||||
Reuse the canned responses under `docs/content/fotospiel_howto_artikel_detailliert.md` to keep messaging consistent.
|
||||
**Live Show is empty.**
|
||||
- Ensure Live Show is enabled and the correct show link is open.
|
||||
- Check if photos are waiting in the Live Show queue.
|
||||
|
||||
**Moderation feels too strict or too loose.**
|
||||
- Adjust upload visibility rules in Event Settings.
|
||||
- Use trusted uploader rules if staff devices should skip review.
|
||||
|
||||
### Need more help?
|
||||
Escalate to reliability@fotospiel.app with the event ID, customer account, and timestamp. Attach screenshots/logs when possible.
|
||||
Escalate to reliability@fotospiel.app with event name, timestamp, and screenshots.
|
||||
|
||||
@@ -3,36 +3,39 @@ title: "Event Preparation Checklist"
|
||||
locale: en
|
||||
slug: event-prep-checklist
|
||||
audience: admin
|
||||
summary: "A 48-hour countdown to ensure devices, guests, and automations are ready before doors open."
|
||||
summary: "The essential steps to prepare an event before guests arrive."
|
||||
version_introduced: 2025.4
|
||||
requires_app_version: "^3.2.0"
|
||||
status: draft
|
||||
translation_state: aligned
|
||||
last_reviewed_at: 2025-02-22
|
||||
last_reviewed_at: 2026-01-23
|
||||
owner: ops@fotospiel.app
|
||||
related:
|
||||
- slug: tenant-dashboard-overview
|
||||
- slug: live-ops-control
|
||||
- slug: post-event-wrapup
|
||||
- slug: live-show-setup
|
||||
---
|
||||
|
||||
## 48–24 hours before
|
||||
- [ ] Create the event in the Admin app with correct timezone + retention policy.
|
||||
- [ ] Upload cover artwork (1200×630) and ensure translations exist for titles/descriptions.
|
||||
- [ ] Import guest lists or generate QR badges if needed.
|
||||
- [ ] Test push notification templates (reminders, achievement unlocks).
|
||||
- [ ] **Create the event** with correct date, timezone, and retention policy.
|
||||
- [ ] **Upload branding** (cover image, logo, welcome text) in all required languages.
|
||||
- [ ] **Define tasks**: pick a task package, adjust tasks, add emotions/collections.
|
||||
- [ ] **Prepare guest entry**: QR code, join link, or invitations.
|
||||
|
||||
## 24–2 hours before
|
||||
- [ ] Run `tenant:attach-demo-event` in staging to rehearse workflow with staff.
|
||||
- [ ] Print or display the join QR near entrance and photobooth areas.
|
||||
- [ ] Prepare onsite Wi-Fi SSID/password signage.
|
||||
- [ ] Confirm that automatic moderation rules match the client contract (e.g., block explicit content, require approval).
|
||||
- [ ] Verify Paddle/RevenueCat status dashboards show green.
|
||||
- [ ] **Publish the event** once everything is approved.
|
||||
- [ ] **Verify uploads** using a test device (camera permission + first upload).
|
||||
- [ ] **Review moderation** settings (guest visibility, approval rules).
|
||||
- [ ] **Check Live Show settings** if you plan a big screen display.
|
||||
|
||||
## Final 2 hours
|
||||
- [ ] Clear demo data from the live event.
|
||||
- [ ] Open the guest app on test devices and complete the getting-started flow.
|
||||
- [ ] Start the Live Ops screen on a tablet/laptop near the stage.
|
||||
- [ ] Brief staff on escalation paths (support contacts, backup devices, photo guidelines).
|
||||
- [ ] **Share the QR** at entrances and photobooth areas.
|
||||
- [ ] **Open Live Ops** on a staff device for moderation.
|
||||
- [ ] **Brief staff** on what to do for flagged content or support requests.
|
||||
|
||||
### Tips
|
||||
- Keep the event in Draft until tasks and branding are final.
|
||||
- Use a test guest to verify the full flow end-to-end.
|
||||
|
||||
### Need more help?
|
||||
Open `live-ops-control` for real-time monitoring tips or reach out to ops@fotospiel.app.
|
||||
Open `live-ops-control` for real-time moderation or `live-show-setup` for the display setup.
|
||||
|
||||
@@ -1,26 +1,25 @@
|
||||
---
|
||||
title: "Customer Admin Help Center"
|
||||
title: "Event Admin Help Center"
|
||||
locale: en
|
||||
slug: admin-help-index
|
||||
audience: admin
|
||||
summary: "Operational playbooks for event owners: onboarding, event setup, live control, and post-event delivery."
|
||||
summary: "Guides for setup, live operations, and troubleshooting in the Event Admin app."
|
||||
version_introduced: 2025.4
|
||||
status: draft
|
||||
translation_state: aligned
|
||||
last_reviewed_at: 2025-02-22
|
||||
last_reviewed_at: 2026-01-23
|
||||
owner: cx-team@fotospiel.app
|
||||
related: []
|
||||
---
|
||||
|
||||
This portal collects everything event admins need to configure customer accounts, run events smoothly, and resolve issues quickly. Articles are grouped by lifecycle:
|
||||
This portal collects everything event admins need to configure events, run live operations, and resolve issues quickly.
|
||||
|
||||
| Phase | Key Questions | Article Slug |
|
||||
| Section | Key Questions | Article Slug |
|
||||
| --- | --- | --- |
|
||||
| Account Setup | How do I invite staff and configure branding? | `tenant-dashboard-overview` |
|
||||
| Event Preparation | What checklists should I complete before doors open? | `event-prep-checklist` |
|
||||
| Live Operations | How do I monitor uploads, moderate content, and trigger announcements? | `live-ops-control` |
|
||||
| Live Show | How do I set up and run the Live Show player? | `live-show-setup` |
|
||||
| Wrap-up & Compliance | How are exports, archives, and privacy handled? | `post-event-wrapup` |
|
||||
| Troubleshooting | How to handle upload issues, device loss, billing, etc. | `admin-issue-resolution` |
|
||||
| Dashboard | Where do I see status, KPIs, and quick actions? | `tenant-dashboard-overview` |
|
||||
| Event Preparation | What do I need before guests arrive? | `event-prep-checklist` |
|
||||
| Live Operations | How do I moderate uploads and manage queues? | `live-ops-control` |
|
||||
| Live Show | How do I configure the Live Show player? | `live-show-setup` |
|
||||
| FAQ & Troubleshooting | What are the most common issues? | `admin-issue-resolution` |
|
||||
|
||||
Use the navigation sidebar inside the admin app for faster access, or open `/help/admin` in a desktop browser for the full layout with breadcrumbs and related links.
|
||||
Use the in-app help center for mobile-friendly reading, or open `/help/admin` on desktop for the full layout.
|
||||
|
||||
@@ -3,12 +3,12 @@ title: "Live Ops Control"
|
||||
locale: en
|
||||
slug: live-ops-control
|
||||
audience: admin
|
||||
summary: "Monitor uploads, moderate content, and push announcements while the event is live."
|
||||
summary: "Moderate uploads, manage queues, and keep the event running smoothly."
|
||||
version_introduced: 2025.4
|
||||
requires_app_version: "^3.2.0"
|
||||
status: draft
|
||||
translation_state: aligned
|
||||
last_reviewed_at: 2025-02-22
|
||||
last_reviewed_at: 2026-01-23
|
||||
owner: ops@fotospiel.app
|
||||
related:
|
||||
- slug: event-prep-checklist
|
||||
@@ -16,25 +16,27 @@ related:
|
||||
- slug: live-show-setup
|
||||
---
|
||||
|
||||
## Dashboard widgets
|
||||
- **Upload throughput** – photos/minute, highlighted when backlog >25.
|
||||
- **Device health** – top devices experiencing errors (permission denied, storage full).
|
||||
- **Moderation queue** – flagged photos awaiting approval; assign to moderators.
|
||||
- **Announcements** – compose push/banner messages; supports locale-specific text.
|
||||
## What this page is for
|
||||
Live Ops is the command center during an event. Use it to moderate uploads, manage the Live Show queue, and keep quality high.
|
||||
|
||||
## Typical workflow
|
||||
1. Pin the Live Ops page on a tablet. Set auto-refresh to 15 seconds.
|
||||
2. Watch the throughput graph as doors open; expect spike to 40+/min right after ceremonies.
|
||||
3. If backlog grows, broadcast a banner reminding guests to stay online or reduce burst uploads.
|
||||
4. Moderate flagged items quickly; policies require action within 10 minutes.
|
||||
5. Use the *Achievement trigger* widget to award badges manually if automation criteria fail.
|
||||
## Moderation tab
|
||||
- **Approve** publishes a photo for guests.
|
||||
- **Hide** removes it from the gallery immediately.
|
||||
- **Highlight** adds it to featured content.
|
||||
- **Filters** let you focus on pending or highlighted items.
|
||||
|
||||
## Escalation matrix
|
||||
| Issue | First action | Escalate to |
|
||||
| --- | --- | --- |
|
||||
| Upload queue stuck | Run health check → re-sync event | Reliability on-call |
|
||||
| Offensive content | Hide photo → download evidence → notify organizer | Legal duty officer |
|
||||
| Billing lock | Check Paddle dashboard → confirm payment status | Finance |
|
||||
## Live Show tab
|
||||
- **Queue** shows what is waiting to appear on the big screen.
|
||||
- **Approve + Live** pushes a photo to both the gallery and Live Show.
|
||||
- **Remove from Live** takes an item off the screen without deleting it.
|
||||
|
||||
## Automation switches
|
||||
- Use auto-approval rules only if the client expects fast turnaround.
|
||||
- Trusted uploaders can skip review, while flagged devices stay queued.
|
||||
|
||||
### Tips
|
||||
- Keep Live Ops open on a staff device throughout the event.
|
||||
- If the queue grows, switch to stricter moderation or reduce Live Show effects.
|
||||
|
||||
### Need more help?
|
||||
Open `admin-issue-resolution` for detailed troubleshooting or ping #ops-help in Slack.
|
||||
See `admin-issue-resolution` for troubleshooting or `live-show-setup` for player settings.
|
||||
|
||||
@@ -3,80 +3,42 @@ title: "Set up & run Live Show"
|
||||
locale: en
|
||||
slug: live-show-setup
|
||||
audience: admin
|
||||
summary: "Step-by-step guide for Live Show, moderation, effects, and recommended projector hardware."
|
||||
summary: "Configure the Live Show player, moderation mode, and playback pace."
|
||||
version_introduced: 2025.4
|
||||
requires_app_version: "^3.2.0"
|
||||
status: draft
|
||||
translation_state: aligned
|
||||
last_reviewed_at: 2025-02-22
|
||||
last_reviewed_at: 2026-01-23
|
||||
owner: ops@fotospiel.app
|
||||
related:
|
||||
- slug: live-ops-control
|
||||
- slug: admin-issue-resolution
|
||||
---
|
||||
|
||||
> This guide is for event admins who want to run Live Show on a big screen or projector.
|
||||
|
||||
## When is this relevant?
|
||||
- You want new uploads to appear live on a large display.
|
||||
- You need a stable flow with moderation, effects, and hardware guidance.
|
||||
- You want new uploads to appear live on a big screen.
|
||||
- You need a stable flow with moderation and effects.
|
||||
|
||||
## Prepare Live Show (Admin app)
|
||||
## Configure Live Show (Admin app)
|
||||
1. Open the event and go to **Live Show settings**.
|
||||
2. Choose a **moderation mode**:
|
||||
2. Pick a **moderation mode**:
|
||||
- **Off**: every photo appears immediately.
|
||||
- **Manual**: photos are held in the Live Show queue.
|
||||
- **Trusted only**: only approved sources are auto-added.
|
||||
3. Set the **pace** (auto or fixed seconds), **layout** (single/split/grid), and **effect preset**.
|
||||
- **Manual**: photos wait in the queue.
|
||||
- **Trusted only**: only approved devices publish automatically.
|
||||
3. Set the **pace**, **layout**, and **effects** that fit the venue.
|
||||
4. Save the settings.
|
||||
|
||||
## Open the Live Show link
|
||||
- Open the Live Show URL in the format `/show/<token>` on the playback device.
|
||||
- Share the link only with staff who should control the show.
|
||||
- Use the Live Show URL in the format `/show/<token>`.
|
||||
- The player is read-only and works without login.
|
||||
|
||||
> Tip: The Live Show player is read-only and works without login.
|
||||
## During the event
|
||||
- Approve photos in Live Ops if moderation is enabled.
|
||||
- If the show stutters, reduce effects or switch to single layout.
|
||||
|
||||
## Moderation during the event
|
||||
- Open the **Live Show queue** in the admin app and approve new photos.
|
||||
- Use **"Approve + Live"** to publish to gallery and Live Show in one step.
|
||||
- Act quickly on sensitive content (policy: ≤10 minutes).
|
||||
## Recommended hardware
|
||||
- Laptop or mini PC with Chrome/Edge and stable Wi-Fi or Ethernet.
|
||||
- Projector at least 3000 ANSI lumens (4500+ recommended for large venues).
|
||||
|
||||
## Effects & layouts (recommended defaults)
|
||||
- **Film Cut** + **Blur last**: calm, professional look.
|
||||
- **Shutter Flash**: more energy for party and gala moments.
|
||||
- **Grid Burst**: best for high-volume uploads and big screens.
|
||||
|
||||
## Recommended projector setup
|
||||
**Minimum (works):**
|
||||
- Laptop with Chrome/Edge, 8 GB RAM
|
||||
- HDMI cable (5–10 m)
|
||||
- Projector ≥3000 ANSI lumens, 1080p
|
||||
|
||||
**Recommended (stable):**
|
||||
- Mini PC or laptop with dedicated GPU
|
||||
- Ethernet connection (USB‑C → Ethernet adapter)
|
||||
- Projector ≥4500 ANSI lumens, 1080p/4K, 16:9
|
||||
- HDMI 2.0 + active HDMI extender (10 m or more)
|
||||
|
||||
**Optional:**
|
||||
- HDMI splitter (additional displays)
|
||||
- Presentation clicker for quick focus switching
|
||||
|
||||
## Screen & projector tuning
|
||||
1. Set resolution to **16:9**, scaling 100%.
|
||||
2. Enable fullscreen (press **F** in the player or browser F11).
|
||||
3. Disable sleep mode and screen lock.
|
||||
4. Disable OS notifications.
|
||||
|
||||
## Network & stability
|
||||
- Use 5 GHz Wi‑Fi or (better) Ethernet.
|
||||
- Avoid guest Wi‑Fi for the player device.
|
||||
- Keep the playback device **online at all times**.
|
||||
|
||||
## Common issues
|
||||
- **Photos not showing:** check moderation mode, clear the queue, reload the Live Show link.
|
||||
- **Stutter:** reduce effect intensity, switch to Single layout, check Wi‑Fi.
|
||||
- **Black screen:** verify projector input, toggle browser fullscreen off/on.
|
||||
|
||||
### Further help
|
||||
See `admin-issue-resolution` for troubleshooting or contact support.
|
||||
### Need more help?
|
||||
See `live-ops-control` for moderation flow or `admin-issue-resolution` for troubleshooting.
|
||||
|
||||
@@ -1,34 +1,38 @@
|
||||
---
|
||||
title: "Customer Control Center Overview"
|
||||
title: "Event Dashboard Overview"
|
||||
locale: en
|
||||
slug: tenant-dashboard-overview
|
||||
audience: admin
|
||||
summary: "Invite staff, configure branding, and understand how customer-wide settings affect every event."
|
||||
summary: "Understand event status, KPIs, and the setup checklist at a glance."
|
||||
version_introduced: 2025.4
|
||||
requires_app_version: "^3.2.0"
|
||||
status: draft
|
||||
translation_state: aligned
|
||||
last_reviewed_at: 2025-02-22
|
||||
last_reviewed_at: 2026-01-23
|
||||
owner: onboarding@fotospiel.app
|
||||
related:
|
||||
- slug: event-prep-checklist
|
||||
- slug: admin-issue-resolution
|
||||
- slug: live-ops-control
|
||||
---
|
||||
|
||||
## When to read this
|
||||
Right after receiving access to a new customer account or when onboarding new staff. The Customer Control Center lives in the Admin app (Filament) and mirrors most options on desktop.
|
||||
Use this guide right after creating an event or whenever you need a quick health check before going live.
|
||||
|
||||
## Key areas
|
||||
1. **Home** – snapshot of live events, storage usage, unresolved reports.
|
||||
2. **Team** – invite admins via email, assign roles (Owner, Manager, Moderator). SSO via Azure AD/Google is available if enabled in customer settings.
|
||||
3. **Branding** – upload logos, choose accent colors, set localized welcome text shown in the guest app.
|
||||
4. **Legal pages** – edit Impressum/Privacy/AGB via the Legal resource; changes propagate instantly.
|
||||
5. **Integrations** – manage Paddle keys, RevenueCat app IDs, webhooks, and Zapier tokens. Never paste secrets into articles.
|
||||
## What the dashboard shows
|
||||
- **Event status** (Draft / Published) so you always know what guests can see.
|
||||
- **KPIs** for guests, uploads, and engagement so you can spot momentum early.
|
||||
- **Setup checklist** with the remaining steps before launch.
|
||||
- **Quick actions** that jump to tasks, Live Show, branding, and QR tools.
|
||||
|
||||
## Best practices
|
||||
- Keep at least two Owner-level accounts for redundancy.
|
||||
- Use the staging customer account to test branding or automation before touching production.
|
||||
- Document invitations in a bd issue note.
|
||||
## How to use it
|
||||
1. **Confirm the status** and keep the event in Draft until everything is ready.
|
||||
2. **Work the checklist** from top to bottom; it mirrors the most common prep path.
|
||||
3. **Check KPIs** to validate that invites and uploads are coming in.
|
||||
4. **Jump into details** (tasks, QR, Live Show) using the quick actions.
|
||||
|
||||
### Tips
|
||||
- Publish only after branding, task setup, and QR sharing are complete.
|
||||
- If uploads look low, verify that the QR or join link is visible to guests.
|
||||
|
||||
### Need more help?
|
||||
See `event-prep-checklist` for event-level prep or contact cx-team@fotospiel.app for onboarding assistance.
|
||||
See `event-prep-checklist` for the full launch steps or open `live-ops-control` during the event.
|
||||
|
||||
Reference in New Issue
Block a user