Files
vliaudatandClaude Opus 5 1668240724 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

170 lines
5.2 KiB
TypeScript
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
'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,
};
}