Files
server-26/drb-frontend/components/TimeScrubber.tsx
T
Logan CusanoandClaude Opus 5.5 aa5b71d853 Live ops wall + pluggable camera providers with licence gating (server-26#198)
Backend (c2-core):
- app/internal/cameras/: provider interface, licence model, per-provider
  catalog cache; one adapter per source in design-canvas/camera-sources.md.
  Implemented: 511NY (legacy shape + tolerant XML inventory parser, 511x
  endpoints UNVERIFIED), Caltrans, DelDOT, Ontario 511, DriveBC, Calgary,
  TfL, NSW, Fintraffic. Stubs: NYC DOT, Westchester DPW, TRANSCOM, CTroads,
  511NJ, Austin, TxDOT, MD CHART, WSDOT, Tallinn, Tarktee, Warendorf,
  TrafficLand, Windy, EarthCam.
- Every provider defaults OFF (config/camera_providers). Gated licences
  (agreement required / unverified / non-commercial / paid) need an explicit
  acknowledgement stored with who/when and written to audit_log; the audit
  write is a precondition. Stubs and prohibited sources cannot be enabled.
  Ack is bound to the licence status it was given for.
- GET /cameras (signed-in), GET/PUT /admin/camera-providers (admin only).
- /traffic/511 follows the ny511 provider switch and returns the DAA credit
  + NYSDOT as-is disclaimer; 511NY event descriptions no longer truncated
  ("may not alter the substance of a report").

Frontend:
- LiveView becomes the ops wall: Region > Incident > Camera drill-down,
  worst-first rail (MapView), KPIs, transcript ticker, scrubber incident
  bands, auto-tour, deep links (#inc=&cam=&tour), Esc steps up.
- Incident panel: nearest cameras (path-weighted), fused situational context
  (ADS-B, AIS, 511NY events, NEXRAD tile sample), units, call spine.
- MapView keeps every layer; adds Camera Viewsheds (approx.) overlay and a
  nearest-camera layer for the selected incident.
- CameraFeed hygiene: hidden-tab/off-screen gating, 2 concurrent HLS cap,
  last good frame + stale badge, frozen-frame signature, HLS stall watchdog,
  provider attribution rendered on the imagery.
- Camera/event popups show source credit, update time and the disclaimer.
- Admin > Camera providers tab with licence status, health, gated confirm.
- Camera detection is not built (blocked on #199/#200); seam only.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-04 17:56:06 -04:00

131 lines
5.4 KiB
TypeScript

"use client";
/**
* Live's time scrubber — call-density bars over the selected window, tinted
* by the worst severity in each bucket, playhead pinned to NOW. Range
* presets change which window is densitized; the playhead itself does not
* move in this build — history scrub needs `resolved_at` on incidents,
* which doesn't exist yet (UI_REDESIGN.md chunk 13, blocked on backend,
* tracked in DEFERRED.md). This is real call density from live data, not a
* fixture — only the scrub interaction is deferred.
*/
import { useMemo, useState } from "react";
import type { CallRecord, IncidentRecord } from "@/lib/types";
import { isKnownSeverity, SEVERITY_COLORS, severityRank } from "@/lib/severity";
const RANGES = [
{ label: "1h", ms: 60 * 60 * 1000 },
{ label: "6h", ms: 6 * 60 * 60 * 1000 },
{ label: "24h", ms: 24 * 60 * 60 * 1000 },
{ label: "7d", ms: 7 * 24 * 60 * 60 * 1000 },
] as const;
const BUCKETS = 48;
/**
* `incidents` (optional) adds one band per active incident from its start to
* its last update, tinted by severity — click a band to drill into it (live
* ops wall). The playhead still does not move; see the header.
*/
export function TimeScrubber({ calls, incidents = [], selectedIncidentId = null, onSelectIncident }: {
calls: CallRecord[];
incidents?: IncidentRecord[];
selectedIncidentId?: string | null;
onSelectIncident?: (id: string) => void;
}) {
const [rangeIdx, setRangeIdx] = useState(2); // default 24h
const range = RANGES[rangeIdx];
const buckets = useMemo(() => {
const now = Date.now();
const start = now - range.ms;
const bucketMs = range.ms / BUCKETS;
const counts = Array.from({ length: BUCKETS }, () => ({ count: 0, worstRank: -1 }));
for (const c of calls) {
const t = new Date(c.started_at).getTime();
if (Number.isNaN(t) || t < start || t > now) continue;
const idx = Math.min(BUCKETS - 1, Math.floor((t - start) / bucketMs));
counts[idx].count += 1;
const rank = severityRank(c.severity);
if (rank > counts[idx].worstRank) counts[idx].worstRank = rank;
}
return counts;
// eslint-disable-next-line react-hooks/exhaustive-deps
}, [calls, rangeIdx]);
const maxCount = Math.max(1, ...buckets.map((b) => b.count));
const bands = useMemo(() => {
const now = Date.now();
const start = now - range.ms;
return incidents
.map((inc) => {
const a = Math.max(start, new Date(inc.started_at).getTime());
const b = Math.min(now, new Date(inc.updated_at || inc.started_at).getTime());
if (Number.isNaN(a) || Number.isNaN(b) || b < start) return null;
return { inc, left: ((a - start) / range.ms) * 100, width: Math.max(0.6, ((Math.max(a, b) - a) / range.ms) * 100) };
})
.filter((x): x is { inc: IncidentRecord; left: number; width: number } => x !== null)
.sort((x, y) => severityRank(x.inc.severity) - severityRank(y.inc.severity));
// eslint-disable-next-line react-hooks/exhaustive-deps
}, [incidents, rangeIdx]);
return (
<div className="h-[84px] bg-surface/90 border-t border-line px-4 flex items-center gap-4">
<div className="flex-1 h-12 flex items-end gap-[2px] relative">
{bands.length > 0 && (
<div className="absolute left-0 right-0 -top-3 h-2" aria-label="Incident bands">
{bands.map(({ inc, left, width }) => {
const color = isKnownSeverity(inc.severity) ? SEVERITY_COLORS[inc.severity] : "var(--ink-muted)";
const sel = inc.incident_id === selectedIncidentId;
return (
<button key={inc.incident_id} type="button" title={inc.title ?? "Incident"}
onClick={() => onSelectIncident?.(inc.incident_id)}
className={`absolute top-0 h-2 rounded-sm ${sel ? "ring-1 ring-ink" : ""}`}
style={{ left: `${left}%`, width: `${width}%`, background: color, opacity: sel ? 1 : 0.55 }} />
);
})}
</div>
)}
{buckets.map((b, i) => {
const heightPct = b.count === 0 ? 4 : Math.max(10, (b.count / maxCount) * 100);
const color =
b.worstRank === 3
? SEVERITY_COLORS.major
: b.worstRank === 2
? SEVERITY_COLORS.moderate
: b.worstRank >= 0
? "var(--ink-2)"
: "var(--line-strong)";
return (
<div
key={i}
title={b.count > 0 ? `${b.count} call${b.count !== 1 ? "s" : ""}` : undefined}
style={{ height: `${heightPct}%`, background: color, flex: 1, borderRadius: 1, minWidth: 2 }}
/>
);
})}
{/* Playhead — pinned to NOW; doesn't move yet (see file header) */}
<div className="relative w-0">
<div className="absolute right-0 -top-14 bottom-0 w-[2px] bg-accent" />
</div>
</div>
<div className="flex items-center gap-1 shrink-0">
{RANGES.map((r, i) => (
<button
key={r.label}
onClick={() => setRangeIdx(i)}
className={`px-2 py-1 rounded text-xs font-mono transition-colors ${
i === rangeIdx ? "bg-accent text-white" : "text-ink-muted hover:text-ink-2"
}`}
>
{r.label}
</button>
))}
<span className="ml-2 text-xs text-ink-muted font-mono">NOW</span>
</div>
</div>
);
}