Clarity StreamClarity Stream
Create account
PRDArchitecture

Clarity Stream — Product Requirements

v0.1 · draft · last updated today

1. Vision

Clarity Stream is a multi-tenant operational intelligence platform for industrial fleets. Customers connect their own databases and brokers via an outbound-only connector agent; we ingest via CDC, materialize per-tenant analytics, and expose internal cross-tenant rollups on an allowlisted set of metrics.

2. Target users

  • ›Plant / fleet operators — live dashboards, alerts, downtime context.
  • ›Operations leadership — multi-site KPIs, SLA reports, exports.
  • ›IT / data teams — manage sources, retention, masking policies.
  • ›Internal Clarity Stream ops — executive cross-tenant analytics.

3. Differentiators vs Clarity Stream

  • ›Outbound-only connector (no inbound DB exposure required).
  • ›True multi-tenant: shared Postgres + RLS, partitioned streams, allowlisted global rollups.
  • ›Bronze → tenant read models → global rollups, with replayable DLQ.
  • ›Typed-extras store keeps schema-light JSON queryable without schema sprawl.
  • ›Modern UX — calm, dense, premium. Mobile-friendly with desktop-first dashboards.

4. Modules

  • ›Marketing site (Home, Platform, Solutions, Pricing, Security, Contact).
  • ›Auth + onboarding (email/password + SSO, workspace bootstrap).
  • ›Tenant admin (workspace, members/roles, retention, masking).
  • ›Connector wizard (pick source → install agent → pair → validate).
  • ›Data source management (status, throughput, lag, reconnect).
  • ›Dashboard builder (read-only first; widget catalog v2).
  • ›Alerts (thresholds, anomaly windows, multi-channel routing).
  • ›Reports + exports (CSV / PDF / Parquet, scheduled).
  • ›Internal ops console (fleet health, tenant lookup).
  • ›Global executive analytics (allowlisted rollups, breakdowns).

5. Roles

  • ›Owner — full control of workspace + billing.
  • ›Admin — sources, alerts, members.
  • ›Operator — dashboards + ack alerts.
  • ›Viewer — read-only dashboards.
  • ›Internal Ops (cross-tenant) — global analytics console only.

6. Success metrics

  • ›Median time-to-first-event after agent install < 2 minutes.
  • ›Ingest p99 < 250 ms; aggregator lag < 30 s p99.
  • ›Tenant dashboard TTFB < 300 ms.
  • ›Zero cross-tenant data leakage in RLS policy test suite.

7. Non-goals (v1)

  • ›On-prem deployment.
  • ›ML / forecasting features beyond simple anomalies.
  • ›Customer-facing white-label portals.