SPB Git

Repository Public

MaintenanceScreen.tsx 9.9 KB 163 lines tsx

1"use client";2import { useRouter, useSearchParams } from "next/navigation";3import { Suspense, useMemo, useRef, useState } from "react";4import type { Schemas } from "@/api/client";5import { useApiQuery } from "@/api/query";6import { useNodeOptions } from "@/features/shared/nodes";7import { useI18n } from "@/i18n";8import { usePref } from "@/lib/prefs";9import { Page, RequirePermission } from "@/shell/AppShell";10import { useSession } from "@/shell/session";11import { Banner, Button, Combobox, DataStamp, EmptyState, ErrorState, Icon, IconButton, Kbd, SelectField, Skeleton, TabPanel, Tabs } from "@/ui";12import { addDays, dayKeyOf, monthGrid, parseDayKey, segmentsByDay, shiftAnchor, visibleDays, visibleRange, weekStartFor, zoneLabel, type CalendarView, type DayKey } from "./calendar";13import { AgendaView, DayList, MonthView, WeekView, useDayFormat } from "./CalendarViews";14import { NotesPanel } from "./NotesPanel";15import { CategoryLegend } from "./parts";16import { WindowDialog, browserZone } from "./WindowDialog";17import { emptyForm, type WindowForm } from "./windowForm";1819type Status = Schemas["MaintenanceStatus"];20type ZoneMode = "local" | "utc";21const VIEWS: readonly CalendarView[] = ["month", "week", "agenda"];22const STATUSES: readonly Status[] = ["scheduled", "in_progress", "completed", "cancelled"];2324export function MaintenanceScreen() {25  return (26    <RequirePermission permission="maintenance.read">27      <Suspense fallback={null}>28        <Inner />29      </Suspense>30    </RequirePermission>31  );32}3334function Inner() {35  const { t } = useI18n();36  const router = useRouter();37  const params = useSearchParams();38  const tab = params.get("tab") === "notes" ? "notes" : "calendar";39  return (40    <div data-testid="screen-maintenance">41      <Page title={t("maintenance.title")} sub={t("maintenance.sub")}>42        <Tabs label={t("maintenance.title")} idPrefix="mt" value={tab} onChange={(v) => router.replace(v === "notes" ? "/maintenance?tab=notes" : "/maintenance")} tabs={[{ id: "calendar", label: t("maintenance.tabs.calendar") }, { id: "notes", label: t("maintenance.tabs.notes") }]} />43        <TabPanel idPrefix="mt" id={tab}>44          {tab === "calendar" ? <CalendarTab /> : (45            <>46              <p className="muted">{t("maintenance.notes.allLead")}</p>47              <NotesPanel scope={{}} showContext />48            </>49          )}50        </TabPanel>51      </Page>52    </div>53  );54}5556function CalendarTab() {57  const { t, locale } = useI18n();58  const session = useSession();59  const canWrite = session.can("maintenance.write");60  const nodes = useNodeOptions();61  const localeTag = locale === "fr" ? "fr-CA" : "en-CA";62  const weekStart = useMemo(() => weekStartFor(localeTag), [localeTag]);63  const df = useDayFormat(localeTag);6465  const [storedView, setView] = usePref<string>("maintenance.view", "month");66  const view: CalendarView = (VIEWS as readonly string[]).includes(storedView) ? (storedView as CalendarView) : "month";67  const [zoneMode, setZoneMode] = useState<ZoneMode>("local");68  const zone = zoneMode === "utc" ? "UTC" : browserZone();69  const [now] = useState(() => Date.now());70  const today = dayKeyOf(now, zone);71  const [picked, setPicked] = useState<DayKey | null>(null);72  const selected = picked ?? today;73  const [nodeId, setNodeId] = useState<string | null>(null);74  const [status, setStatus] = useState<Status | "">("");75  const [dialog, setDialog] = useState<WindowForm | null>(null);76  const dayPanel = useRef<HTMLHeadingElement>(null);7778  const days = useMemo(() => visibleDays(view, selected, weekStart), [view, selected, weekStart]);79  const range = useMemo(() => visibleRange(view, selected, weekStart, zone), [view, selected, weekStart, zone]);80  const q = useApiQuery("/maintenance/windows", { query: { from: range.from, to: range.to, ...(nodeId ? { node_id: nodeId } : {}), ...(status ? { status } : {}) } }, { placeholderData: (prev) => prev, refetchInterval: 60_000 });81  const items = useMemo(() => q.data?.items ?? [], [q.data]);82  const segments = useMemo(() => segmentsByDay(items, days, zone), [items, days, zone]);8384  const create = canWrite ? (day: DayKey, hour?: number) => setDialog(emptyForm(browserZone(), day, hour)) : undefined;85  const heading = view === "month" ? df.month(selected) : view === "week" ? `${df.short(days[0] ?? selected)} – ${df.short(days[6] ?? selected)} ${parseDayKey(days[6] ?? selected).y}` : `${df.short(selected)} – ${df.short(addDays(selected, 29))} ${parseDayKey(addDays(selected, 29)).y}`;86  const ics = `/api/v1/maintenance/calendar.ics?${new URLSearchParams({ from: range.from, to: range.to, ...(nodeId ? { node_id: nodeId } : {}) }).toString()}`;87  const viewProps = { zone, localeTag, today, selected, onSelect: setPicked, onCreate: create, segments };88  const daySegs = segments.get(selected) ?? [];8990  return (91    <>92      <div className="mt-toolbar">93        <div className="row-wrap">94          <div className="row" role="group" aria-label={t("maintenance.calendar.navigate")}>95            <IconButton icon="chevron-left" variant="secondary" label={t(`maintenance.calendar.prev.${view}`)} onClick={() => setPicked(shiftAnchor(view, selected, -1))} data-testid="mt-prev" />96            <Button onClick={() => setPicked(null)} data-testid="mt-today">{t("common.today")}</Button>97            <IconButton icon="chevron-right" variant="secondary" label={t(`maintenance.calendar.next.${view}`)} onClick={() => setPicked(shiftAnchor(view, selected, 1))} data-testid="mt-next" />98          </div>99          <h2 className="mt-heading" aria-live="polite" data-testid="mt-heading">{heading}</h2>100        </div>101        <div className="row-wrap">102          <div role="radiogroup" aria-label={t("maintenance.calendar.view")} className="mcc-seg"103            onKeyDown={(e) => {104              const dir = e.key === "ArrowRight" || e.key === "ArrowDown" ? 1 : e.key === "ArrowLeft" || e.key === "ArrowUp" ? -1 : 0;105              if (!dir) return;106              e.preventDefault();107              const next = VIEWS[(VIEWS.indexOf(view) + dir + VIEWS.length) % VIEWS.length] ?? "month";108              setView(next);109              e.currentTarget.querySelector<HTMLElement>(`[data-view="${next}"]`)?.focus();110            }}>111            {VIEWS.map((v) => (112              <button key={v} type="button" role="radio" aria-checked={v === view} tabIndex={v === view ? 0 : -1} data-view={v} data-testid={`mt-view-${v}`} onClick={() => setView(v)}>{t(`maintenance.calendar.views.${v}`)}</button>113            ))}114          </div>115          {canWrite ? <Button variant="primary" icon="plus" onClick={() => create?.(selected)} data-testid="mt-new-window">{t("maintenance.calendar.new")}</Button> : null}116        </div>117      </div>118119      <div className="mt-filters">120        <SelectField label={t("maintenance.calendar.zone")} value={zoneMode} onChange={setZoneMode} options={[{ value: "local", label: t("maintenance.calendar.zoneLocal", { zone: browserZone() }) }, { value: "utc", label: "UTC" }]} data-testid="mt-zone" />121        <Combobox label={t("maintenance.calendar.filterNode")} placeholder={t("maintenance.calendar.allNodes")} options={nodes.options} value={nodeId} onChange={setNodeId} />122        <SelectField label={t("maintenance.calendar.filterStatus")} value={status} onChange={setStatus} options={[{ value: "", label: t("maintenance.calendar.allStatuses") }, ...STATUSES.map((s) => ({ value: s, label: t(`states.maintenance.${s}`) }))]} />123        <div className="mt-filters-end">124          <a className="mcc-btn" href={ics} download="mcc-maintenance.ics" data-testid="mt-ics-link" title={t("maintenance.calendar.icsHelp")}><Icon name="download" size={15} />{t("maintenance.calendar.ics")}</a>125        </div>126      </div>127      <div className="row-between mt-zone-line">128        <p className="mcc-hint num" data-testid="mt-zone-label"><Icon name="globe" size={13} /> {t("maintenance.calendar.zoneShown", { zone: zoneLabel(zone, now) })} · {t("maintenance.calendar.icsHelp")}</p>129        {q.data ? <DataStamp at={q.dataUpdatedAt} /> : null}130      </div>131132      {q.data?.truncated ? <Banner tone="warning">{t("maintenance.calendar.truncated")}</Banner> : null}133      {q.isError && q.data ? <Banner tone="stale">{t("ui.stale.refetchFailed")}</Banner> : null}134135      {q.isError && !q.data ? <ErrorState error={q.error} onRetry={() => void q.refetch()} /> : !q.data ? (136        <div className="stack" role="status" aria-label={t("common.loading")}><Skeleton height="xl" /></div>137      ) : (138        <>139          <CategoryLegend />140          {view === "month" ? (141            <>142              <MonthView {...viewProps} weeks={monthGrid(selected, weekStart)} month={parseDayKey(selected).m} onOpenDay={(d) => { setPicked(d); dayPanel.current?.focus(); }} />143              <p className="mcc-hint mt-keys"><Kbd>←</Kbd><Kbd>→</Kbd><Kbd>↑</Kbd><Kbd>↓</Kbd> {t("maintenance.calendar.keysMove")} · <Kbd>PgUp</Kbd><Kbd>PgDn</Kbd> {t("maintenance.calendar.keysMonth")} · <Kbd>↵</Kbd> {t("maintenance.calendar.keysOpen")}</p>144            </>145          ) : view === "week" ? <WeekView {...viewProps} days={days} /> : <AgendaView {...viewProps} days={days} />}146147          {view !== "agenda" ? (148            <section className="section mt-daypanel" aria-labelledby="mt-daypanel-h" data-testid="mt-day-panel">149              <div className="section-head">150                <h2 id="mt-daypanel-h" tabIndex={-1} ref={dayPanel}>{df.full(selected)}</h2>151                {create ? <Button size="sm" icon="plus" onClick={() => create(selected)} data-testid="mt-new-on-day">{t("maintenance.calendar.newOnShort")}</Button> : null}152              </div>153              {daySegs.length === 0 ? <EmptyState compact icon="calendar" title={t("maintenance.calendar.dayEmpty")}>{canWrite ? t("maintenance.calendar.dayEmptyHint") : undefined}</EmptyState> : <DayList day={selected} segs={daySegs} zone={zone} />}154            </section>155          ) : null}156        </>157      )}158159      <WindowDialog open={dialog !== null} onClose={() => setDialog(null)} initial={dialog ?? undefined} loaded={items} />160    </>161  );162}163
Files main
Menu

Theme