Repository Public
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