Glossary

Reference definitions for terminology used across Beacon Platform documentation.

---

Organization

• Community: logical tenant (community_id).
• Source: chat/source identifier (source_id).

Data types

• Export: raw WhatsApp text export stored in R2 and tracked in exports.
• Daily digest: AI-generated summary per day stored in daily_digests.
• Weekly summary: public aggregate stored in weekly_summaries_public.

Metrics

• Sentiment score: numeric value from -1.0 (very negative) to +1.0 (very positive).
  • Positive: > 0.15
  • Neutral: -0.15 to 0.15
  • Negative: < -0.15
• Data confidence: 0.0 to 1.0 indicator based on days, messages, and participant diversity. Measures data availability, not accuracy.
• Sentiment trend: overall direction of sentiment over time using confidence-weighted linear regression.
  • Improving: slope > 0.06 and change >= 0.10
  • Declining: slope < -0.06 and change >= 0.10
  • Stable: |slope| < 0.03
  • Insufficient data: requirements not met

Processing

• Deduplication: content + sender hashing per day to prevent double counting.
• Embed: public /pulse/embed HTML widget.

Environments

• Production: live deployment serving real users.
• Staging: pre-production validation environment.
• Preview: per-PR test deployments.

Sources: beacon-platform/docs/glossary.md, beacon-platform/apps/pulse-public/src/index.ts