Responsibilities

  • Serve public JSON endpoints and HTML UI.
  • Provide embeddable card for current week.
  • Host admin helpers for communities and sources.

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


Public endpoints

PathMethodPurpose
/pulse.jsonGETCurrent week summary
/pulse/history.jsonGETWeekly history
/pulse/trends.jsonGETSentiment trend analysis
/pulseGETHTML UI
/pulse/embedGETEmbed card

Sources: beacon-platform/docs/architecture.md


Daily digests endpoint

  • /pulse/daily.json returns daily digests.
  • It should be admin-only unless PUBLIC_DAILY_DIGESTS is enabled.

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


Admin helpers

  • /admin/communities
  • /admin/sources
  • /admin/exports/assign-source

These should be guarded by Access or ADMIN_TOKEN.

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


Embed notes

  • /pulse/embed renders the same data as /pulse.json in a compact card.
  • Embed guidelines and iframe notes are documented in infra/EMBED.md.

Sources: beacon-platform/infra/EMBED.md