feat: Grafana-embed mode — hide native picker, follow Grafana time range

With ?embed=grafana on the URL the terminal hides its in-page window picker and drives the listed-carts window from Grafana's exact from/to (epoch ms) instead of a preset. Backend /overview now accepts from/to (aliased) via FROM_UNIXTIME, which resolves in the same DB session clock as NOW() so timezone handling is unchanged. Standalone behaviour (own picker + preset window) is untouched. Includes rebuilt dist.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

api/routes.py

@@ -67,6 +67,16 @@ _PLANT = os.getenv("PLANT_NAME", "Cadolzburg")
 _WINDOW_MINUTES: dict[str, int] = {"12h": 720, "1T": 1440, "7T": 10080, "14T": 20160, "30T": 43200}
 _DEFAULT_WINDOW = "7T"
 
+
+def _abs_window_label(from_ms: int, to_ms: int) -> str:
+    """Compact human label for an absolute (Grafana) window, returned in `window`
+    where the preset code used to be — e.g. '26 h', '3 d'. Purely cosmetic."""
+    minutes = max(0, round((to_ms - from_ms) / 60000))
+    if minutes < 90:
+        return f"{minutes} min"
+    hours = minutes / 60
+    return f"{round(hours)} h" if hours < 48 else f"{round(hours / 24)} d"
+
 # Cap the listed carts so a wide window can't return an unbounded payload (the
 # frontend renders one card per entry). Newest-first, so the cap drops the oldest.
 _MAX_ENTRIES = 500
@@ -403,9 +413,36 @@ class RejectBody(BaseModel):
 
 
 @router.get("/overview", summary="Tempered carts per ttId, newest first (live)")
-def overview(window: str = Query(_DEFAULT_WINDOW, description="12h|1T|7T|14T|30T")) -> dict[str, Any]:
+def overview(
-    code = window if window in _WINDOW_MINUTES else _DEFAULT_WINDOW
+    window: str = Query(_DEFAULT_WINDOW, description="12h|1T|7T|14T|30T"),
-    limit_min = _WINDOW_MINUTES[code]
+    from_ms: Optional[int] = Query(
+        None, alias="from",
+        description="absolute window START, epoch ms (Grafana ${__from}). When paired "
+                    "with `to`, overrides `window` with an exact from→to range.",
+    ),
+    to_ms: Optional[int] = Query(
+        None, alias="to", description="absolute window END, epoch ms (Grafana ${__to}).",
+    ),
+) -> dict[str, Any]:
+    # Grafana embed passes an absolute [from,to] window (epoch ms); it wins over the
+    # preset `window`. FROM_UNIXTIME resolves in the same DB session clock as NOW(), so
+    # the timezone handling matches the preset path.
+    absolute = from_ms is not None and to_ms is not None and to_ms > from_ms
+    if absolute:
+        code = _abs_window_label(from_ms, to_ms)
+        bound_sql = (
+            "  AND NOW() >= ttOutOfOvenAt "
+            "  AND ttOutOfOvenAt >= FROM_UNIXTIME(:from_s) "
+            "  AND ttOutOfOvenAt <= FROM_UNIXTIME(:to_s) "
+        )
+        bounds: dict[str, Any] = {"from_s": from_ms / 1000.0, "to_s": to_ms / 1000.0}
+    else:
+        code = window if window in _WINDOW_MINUTES else _DEFAULT_WINDOW
+        bound_sql = (
+            "  AND NOW() >= ttOutOfOvenAt "                # fertig getempert
+            "  AND ttOutOfOvenAt >= (NOW() - INTERVAL :mins MINUTE) "
+        )
+        bounds = {"mins": _WINDOW_MINUTES[code]}
 
     try:
         rows = run_select_query(
@@ -415,11 +452,10 @@ def overview(window: str = Query(_DEFAULT_WINDOW, description="12h|1T|7T|14T|30T
             "WHERE ttPlant = :plant "
             "  AND ttReprintOf IS NULL "               # a reprint is not a new label
             "  AND ttOutOfOvenAt IS NOT NULL "
-            "  AND NOW() >= ttOutOfOvenAt "            # fertig getempert
+            + bound_sql
-            "  AND ttOutOfOvenAt >= (NOW() - INTERVAL :mins MINUTE) "
+            + "ORDER BY ttOutOfOvenAt DESC, ttId DESC "
-            "ORDER BY ttOutOfOvenAt DESC, ttId DESC "
             "LIMIT :lim",
-            {"plant": _PLANT, "mins": limit_min, "lim": _MAX_ENTRIES + 1},
+            {"plant": _PLANT, "lim": _MAX_ENTRIES + 1, **bounds},
         )
     except Exception as e:
         logger.error("temper_rejects overview query failed: %s", e, exc_info=True)

dist/index.html

@@ -9,8 +9,8 @@
     <meta charset="UTF-8" />
     <meta name="viewport" content="width=device-width, initial-scale=1.0" />
     <title>Ausschuss-Station</title>
-    <script type="module" crossorigin src="/module/temper_rejects/assets/index-CjCewD1P.js"></script>
+    <script type="module" crossorigin src="/module/temper_rejects/assets/index-E-o3DjeF.js"></script>
-    <link rel="stylesheet" crossorigin href="/module/temper_rejects/assets/index-CU7fLO-K.css">
+    <link rel="stylesheet" crossorigin href="/module/temper_rejects/assets/index-fYNT-3K2.css">
   </head>
   <body>
     <div id="app"></div>

src/components/StationHeader.vue

@@ -3,7 +3,7 @@ import { onMounted, onUnmounted, ref } from 'vue'
 import { useI18n } from 'vue-i18n'
 import type { WindowCode } from '@/types/station'
 
-defineProps<{ window: WindowCode; sample: boolean; disconnected?: boolean }>()
+defineProps<{ window: WindowCode; sample: boolean; disconnected?: boolean; embedded?: boolean }>()
 const emit = defineEmits<{ (e: 'update:window', code: WindowCode): void }>()
 
 const { t } = useI18n()
@@ -35,7 +35,9 @@ onUnmounted(() => {
     <span v-if="disconnected" class="reconnect"><span class="spinner sm" aria-hidden="true"></span>{{ t('conn.reconnecting') }}</span>
     <span v-else class="live"><span class="led"></span>{{ t('app.live') }}</span>
     <span class="clock num">{{ clock }}</span>
-    <span class="rangep" role="group" :aria-label="t('window.label')">
+    <!-- In a Grafana embed the window is driven by Grafana's own time picker, so the
+         native one is hidden to avoid two competing time controls. -->
+    <span v-if="!embedded" class="rangep" role="group" :aria-label="t('window.label')">
       <span class="rl">{{ t('window.label') }}</span>
       <button
         v-for="code in WINDOWS"

src/embed.ts

@@ -0,0 +1,37 @@
+// Grafana-embed detection + time range, read from the iframe URL.
+//
+// When this terminal is embedded in a Grafana text-panel iframe, the dashboard is
+// configured to pass `embed=grafana` plus Grafana's own time range as `from`/`to`
+// (epoch ms, via Grafana's ${__from}/${__to}). In that mode the board hides its own
+// window picker and queries Grafana's EXACT [from,to] window instead of a preset.
+//
+// A Grafana time-range change reloads the iframe with new from/to in the URL, so
+// reading the URL once per load is sufficient — no message channel needed.
+
+function urlParams(): URLSearchParams {
+  // The app uses hash-based routing, so params usually sit after the '#'
+  // (`…/#/?embed=grafana&from=…`). Tolerate them before it too and merge both.
+  const merged = new URLSearchParams()
+  const add = (qs: string) => {
+    for (const [k, v] of new URLSearchParams(qs)) merged.set(k, v)
+  }
+  add(window.location.search.replace(/^\?/, ''))
+  const hash = window.location.hash
+  const q = hash.indexOf('?')
+  if (q >= 0) add(hash.slice(q + 1))
+  return merged
+}
+
+/** True when hosted in Grafana (`?embed=grafana`) — hide the native window picker. */
+export function isGrafanaEmbed(): boolean {
+  return urlParams().get('embed') === 'grafana'
+}
+
+/** Grafana's absolute window as epoch-ms `{ from, to }`, or null if absent/invalid. */
+export function grafanaWindow(): { from: number; to: number } | null {
+  const p = urlParams()
+  const from = Number(p.get('from'))
+  const to = Number(p.get('to'))
+  if (!Number.isFinite(from) || !Number.isFinite(to) || to <= from) return null
+  return { from, to }
+}

src/stores/temperRejects.ts

@@ -3,6 +3,7 @@ import { ref, computed } from 'vue'
 import axios from 'axios'
 import api from '@/api'
 import { sampleStation, SAMPLE_REASONS } from '@/data/sample'
+import { isGrafanaEmbed, grafanaWindow } from '@/embed'
 import type { StationPayload, Reason, RejectRequest, RejectResult, WindowCode } from '@/types/station'
 
 // Same convention as PressV: loadCache() → hydrate() → refresh() → startPolling().
@@ -19,6 +20,12 @@ export const useTemperRejectsStore = defineStore('temperRejects', () => {
   const payload = ref<StationPayload | null>(null)
   const reasons = ref<Reason[]>([])
   const window = ref<WindowCode>('7T')
+  // Grafana embed: when hosted in a Grafana iframe (?embed=grafana), the native window
+  // picker is hidden and the listed-carts window is driven by Grafana's own time range
+  // (from/to epoch ms) instead of the preset. Read once from the URL — a Grafana time
+  // change reloads the iframe, which re-runs this store setup.
+  const embedded = ref(isGrafanaEmbed())
+  const grafanaWin = embedded.value ? grafanaWindow() : null
   const checkedPresses = ref<string[]>([]) // press filter (default = all)
   const loading = ref(false)
   const error = ref<string | null>(null)
@@ -78,7 +85,9 @@ export const useTemperRejectsStore = defineStore('temperRejects', () => {
   async function refresh() {
     error.value = null
     try {
-      const res = await api.get<StationPayload>('/overview', { params: { window: window.value } })
+      // Grafana embed → exact from→to window; standalone → the preset window.
+      const params = grafanaWin ? { from: grafanaWin.from, to: grafanaWin.to } : { window: window.value }
+      const res = await api.get<StationPayload>('/overview', { params })
       if (!res.data || !Array.isArray(res.data.entries)) {
         throw new Error('Unexpected /overview response (no backend?)')
       }
@@ -195,6 +204,7 @@ export const useTemperRejectsStore = defineStore('temperRejects', () => {
     payload,
     reasons,
     window,
+    embedded,
     checkedPresses,
     loading,
     error,

src/views/RejectStationPage.vue

@@ -23,7 +23,7 @@ import type { RejectEntry, RejectRequest } from '@/types/station'
 
 const { t } = useI18n()
 const store = useTemperRejectsStore()
-const { window, reasons, allPresses, checkedPresses, pressCounts, filteredEntries, usingSample, hasData, disconnected } = storeToRefs(store)
+const { window, embedded, reasons, allPresses, checkedPresses, pressCounts, filteredEntries, usingSample, hasData, disconnected } = storeToRefs(store)
 
 const pop = ref<InstanceType<typeof RejectPopover> | null>(null)
 const bookingEntry = ref<RejectEntry | null>(null)
@@ -82,7 +82,7 @@ onUnmounted(() => {
 
 <template>
   <div class="wrap">
-    <StationHeader :window="window" :sample="usingSample" :disconnected="disconnected" @update:window="store.setWindow" />
+    <StationHeader :window="window" :sample="usingSample" :disconnected="disconnected" :embedded="embedded" @update:window="store.setWindow" />
 
     <!-- Cold start / no data yet: never blank, never fake — spinner that keeps retrying. -->
     <div v-if="!hasData" class="state connect">