Overview

The admin dashboard at /admin provides upload and management tools for Beacon Pulse.

Sources: beacon-platform/infra/ADMIN_UPLOAD.md


  • Protect /admin* with Cloudflare Access.
  • Protect the ingest worker domain with the same Access policy.
  • Use a custom domain for ingest to share Access cookies.

Sources: beacon-platform/infra/ADMIN_UPLOAD.md


Upload flow

  1. Open /admin and authenticate via Access.
  2. Enter community_id and select a WhatsApp export file.
  3. Upload to R2 and enqueue processing.
  4. Monitor progress and manage files.

Sources: beacon-platform/infra/ADMIN_UPLOAD.md


File management

  • View uploaded files, sizes, and timestamps.
  • Delete files to trigger cleanup and weekly regeneration.
  • Refresh file list as needed.

Sources: beacon-platform/infra/ADMIN_UPLOAD.md


Troubleshooting

  • Access denied: check Access policy and login.
  • Upload failed: verify export format and R2 permissions.
  • File not processing: check queue and worker logs.
  • Deletion not working: confirm Access protection for /files and R2 events.

Sources: beacon-platform/infra/ADMIN_UPLOAD.md, beacon-platform/infra/VIEW_LOGS.md, beacon-platform/infra/R2_EVENTS.md