Beacon Platform Docs

Beacon Pulse

1 min read

  • Service: Beacon Pulse (production)
  • Workers: apps/pulse-ingest and apps/pulse-public
  • Purpose: ingest chat exports, generate daily/weekly summaries, serve public APIs and embeds

Sources: beacon-platform/README.md, beacon-platform/docs/architecture.md

Overview

  • Ingest worker handles uploads, queue processing, parsing, dedupe, AI summaries.
  • Public worker serves JSON and HTML endpoints and admin helpers.
  • Raw exports remain private; weekly summaries are public-safe.

Sources: beacon-platform/docs/architecture.md, beacon-platform/docs/privacy.md

Key user flows

  1. Admin upload → R2 → queue → ingest → D1.
  2. Public user → /pulse.json or /pulse → D1 summaries.
  3. Admin cleanup/replay → ingest worker.

Sources: beacon-platform/docs/architecture.md, beacon-platform/docs/operations.md

Data stores

  • R2 beacon-pulse-exports for raw exports.
  • D1 beacon-pulse-db for metadata and summaries.
  • Queue beacon-pulse-uploads for processing triggers.

Sources: beacon-platform/docs/operations.md

Detailed guides

3 items under this folder.