ahmido/TenantAtlas
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects 1 Releases Wiki Activity
dev
TenantAtlas/specs/058-tenant-ui-polish/contracts/polling.md
Ahmed Darrazi 8b17bbe9be spec: refine 057 + extend 058
2026-01-21 08:12:46 +01:00

732 B
Raw Permalink Blame History

Polling Contract — Calm UI Rules

Principle

Polling is allowed only when it materially improves UX (active operations). It must be DB-only and must stop when no longer needed.

Dashboard

  • Polling is enabled only while active runs exist (queued/running) for the current tenant.
  • Polling is disabled when:
    • No active runs exist.

Operations index

  • Polling is enabled only while active runs exist.
  • Polling is disabled when:
    • No active runs exist.

Modals

  • No polling inside modals.
  • When a modal is open, polling should not cause churn in the background.

Technical approach

  • Widgets: use $pollingInterval = null to disable polling.
  • Tables: apply $table->poll('10s') only when active runs exist.