feat: add the settings page with the audit trail

Shop identity, the cantonal code that drives the holiday calendar, the two wake intervals and the image format, plus the device list and a translation self-test. The audit trail sits at the bottom, rendered field by field in French rather than as raw JSON. Regenerating a device token shows it once and stores only its digest, so the panel has to be re-paired through the captive portal afterwards. That is the point rather than a drawback: this is the control you reach for when a token may have leaked, and a version that let you read the old one back would not be one. The server URL to type into the captive portal is reconstructed from the incoming request, so the value shown is the one the device would actually have to reach — not one assembled from configuration that may not match what the proxy is serving. Wake intervals are bounded by the same constants the device API enforces, so a value the settings page accepts cannot be one the panel is refused. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_012cSY9pVhZmJUKNN7wf1Myd
2026-09-20 21:26:05 +02:00
parent 830e595393
commit 1668240724
4 changed files with 556 additions and 0 deletions
@@ -0,0 +1,169 @@
+'use server';
+
+import { revalidatePath } from 'next/cache';
+
+import { diffOf, recordAudit } from '@/lib/audit';
+import { requireAdmin } from '@/lib/auth/actions';
+import { prisma } from '@/lib/db';
+import { generateDeviceToken, hashToken } from '@/lib/device/auth';
+import { MAX_REFRESH_SEC, MIN_REFRESH_SEC } from '@/lib/device/refresh';
+import { translateToEnglish } from '@/lib/translation/service';
+
+export type ActionResult<T = undefined> = { ok: true; value: T } | { ok: false; error: string };
+
+export type SettingsInput = {
+  shopName: string;
+  timezone: string;
+  countryIsoCode: string;
+  subdivisionCode: string;
+  refreshRateOpenSec: number;
+  refreshRateClosedSec: number;
+  imageFormat: 'bmp' | 'png';
+};
+
+export async function saveSettings(input: SettingsInput): Promise<ActionResult> {
+  const gate = await requireAdmin();
+  if (!gate.ok) {
+    return { ok: false, error: gate.error };
+  }
+
+  const shopName = input.shopName.trim();
+  if (!shopName) {
+    return { ok: false, error: 'Le nom de la boutique ne peut pas être vide.' };
+  }
+  if (!isValidTimezone(input.timezone)) {
+    return { ok: false, error: `Fuseau horaire inconnu : « ${input.timezone} ».` };
+  }
+  for (const [label, value] of [
+    ['ouverture', input.refreshRateOpenSec],
+    ['fermeture', input.refreshRateClosedSec],
+  ] as const) {
+    if (!Number.isFinite(value) || value < MIN_REFRESH_SEC || value > MAX_REFRESH_SEC) {
+      return {
+        ok: false,
+        error: `L’intervalle en ${label} doit être compris entre ${MIN_REFRESH_SEC} et ${MAX_REFRESH_SEC} secondes.`,
+      };
+    }
+  }
+
+  const before = await prisma.settings.findUnique({ where: { id: 'singleton' } });
+  const data = {
+    shopName,
+    timezone: input.timezone.trim(),
+    countryIsoCode: input.countryIsoCode.trim().toUpperCase(),
+    subdivisionCode: input.subdivisionCode.trim().toUpperCase(),
+    refreshRateOpenSec: input.refreshRateOpenSec,
+    refreshRateClosedSec: input.refreshRateClosedSec,
+    imageFormat: input.imageFormat,
+  };
+
+  await prisma.settings.upsert({
+    where: { id: 'singleton' },
+    update: data,
+    create: { id: 'singleton', ...data },
+  });
+
+  await recordAudit({
+    userEmail: gate.value.email,
+    action: 'settings.update',
+    entity: 'Settings',
+    diff: diffOf(before ? asAudit(before) : null, asAudit(data)),
+  });
+
+  revalidatePath('/admin');
+  revalidatePath('/admin/parametres');
+  return { ok: true, value: undefined };
+}
+
+/**
+ * Issues a fresh token for a panel.
+ *
+ * The new token is returned once and never again — only its digest is stored.
+ * The device has to be re-paired through the captive portal afterwards, which
+ * is the point: this is what you reach for when a token may have leaked.
+ */
+export async function regenerateDeviceToken(id: string): Promise<ActionResult<{ token: string }>> {
+  const gate = await requireAdmin();
+  if (!gate.ok) {
+    return { ok: false, error: gate.error };
+  }
+
+  const device = await prisma.device.findUnique({ where: { id } });
+  if (!device) {
+    return { ok: false, error: 'Cet appareil n’existe plus.' };
+  }
+
+  const token = generateDeviceToken();
+  await prisma.device.update({ where: { id }, data: { apiKeyHash: hashToken(token) } });
+
+  await recordAudit({
+    userEmail: gate.value.email,
+    action: 'device.regenerate_token',
+    entity: 'Device',
+    entityId: id,
+    diff: { jeton: { before: 'précédent', after: 'régénéré' } },
+  });
+
+  revalidatePath('/admin/parametres');
+  return { ok: true, value: { token } };
+}
+
+export async function forgetDevice(id: string): Promise<ActionResult> {
+  const gate = await requireAdmin();
+  if (!gate.ok) {
+    return { ok: false, error: gate.error };
+  }
+
+  const device = await prisma.device.findUnique({ where: { id } });
+  if (!device) {
+    return { ok: false, error: 'Cet appareil n’existe plus.' };
+  }
+
+  await prisma.device.delete({ where: { id } });
+
+  await recordAudit({
+    userEmail: gate.value.email,
+    action: 'device.forget',
+    entity: 'Device',
+    entityId: id,
+    diff: diffOf({ adresse: device.macAddress, identifiant: device.friendlyId }, null),
+  });
+
+  revalidatePath('/admin/parametres');
+  return { ok: true, value: undefined };
+}
+
+/** Round-trips a short phrase so the service can be checked without a message. */
+export async function testTranslation(): Promise<ActionResult<{ text: string }>> {
+  const gate = await requireAdmin();
+  if (!gate.ok) {
+    return { ok: false, error: gate.error };
+  }
+
+  const outcome = await translateToEnglish('Fermeture exceptionnelle jeudi après-midi');
+  return outcome.ok
+    ? { ok: true, value: { text: outcome.text } }
+    : { ok: false, error: outcome.error };
+}
+
+function isValidTimezone(value: string): boolean {
+  try {
+    new Intl.DateTimeFormat('en', { timeZone: value.trim() });
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+/** Accepts a stored row too, whose imageFormat is a plain string. */
+function asAudit(settings: Omit<SettingsInput, 'imageFormat'> & { imageFormat: string }): Record<string, unknown> {
+  return {
+    nom: settings.shopName,
+    fuseau: settings.timezone,
+    pays: settings.countryIsoCode,
+    canton: settings.subdivisionCode,
+    'réveil ouvert (s)': settings.refreshRateOpenSec,
+    'réveil fermé (s)': settings.refreshRateClosedSec,
+    'format image': settings.imageFormat,
+  };
+}