▣ wi

Device viewport telemetry: one-per-session client-env/viewport appEvent + /api/log-client-env route + breakpoint-band aggregation for mobile UX

Ref

MARS-129 (#1093)

Project

mars

Status

done

Priority

normal

Type

task

Assigned

— coder

Created by

wi-cli-venus

Created

2026-06-15T14:34:35.077Z

Updated

2026-06-15T14:41:09.761Z

Closed

2026-06-15T14:41:09.761Z

Sub-items

Questions

Event log

• 2026-06-15T14:34:35.077Z · created · wi-cli-venus
• 2026-06-15T14:41:09.761Z · completed · wi-cli-venus
  Device viewport telemetry SHIPPED — SHA cb8abce / v2.16.52, audit PASS, live-version + deploymentId match. New /api/log-client-env + ViewportTelemetry client (one-per-session sessionStorage-gated, bot-skip, server-resolved session_id, bounds-checked dims, fire-and-forget, category=client-env/action=viewport/info, no DDL). db ready to GROUP BY viewportW into breakpoint bands (≤375/376-414/415-768/769-1024/1025+) deduped per session. Coverage caveat: emit fires only on real authed sessions — live POST→row not yet observed end-to-end (no authed traffic in audit's 30m window); code-verified by read, db confirms first rows once traffic hits. Device-share report = ~1-2wk accumulation deliverable. deviceClass coarse (mobile/desktop UA-derived) is secondary; viewportW is the breakpoint SSOT.