@nightkatana/kronosys-app 1.0.0-beta.18 → 1.0.0-beta.19

package/README.md

@@ -12,11 +12,38 @@ Stack : **Next 16** (App Router), **React 19**, **Tailwind 4**, **better-sqlite3
 | `npm run build` / `npm run start` | Production |
 | `npm run test` | Vitest |
 | `npm run test:coverage` | Vitest avec couverture LCOV pour SonarQube Cloud |
+| `npm run test:e2e` | Playwright — voir **Tests E2E** ci‑dessous ; démarre Next sur **5555** si besoin (`playwright.config.mjs`) |
+| `npm run test:e2e:install` | Télécharge Chromium, Chrome Headless Shell et ffmpeg pour la version installée de Playwright |
+| `npm run test:e2e:podman` | E2E dans une image Ubuntu officielle Playwright via Podman (voir ci‑dessous) |
 | `npm run hooks:install` | Installe Husky et active les hooks Git du dépôt |
 | `npm run release:dry` | Simule bump semver + `CHANGELOG.md` + tag (aucune écriture) |
 | `npm run release` | Bump `package.json` / `package-lock.json`, met à jour le journal, commit, tag `v…` |
 | `npm run release:first` | Une fois : journal complet pour la version courante **sans** bump (puis tag `v…`) |
 
+### Tests E2E (Playwright)
+
+Après **`npm install`** ou une mise à jour de **`@playwright/test`**, exécuter une fois :
+
+```bash
+npm run test:e2e:install
+```
+
+Sans cela, les tests échouent souvent avec **`Executable doesn't exist`** ou **`browserType.launch`** : Playwright doit télécharger **Chromium**, **Chrome Headless Shell** (utilisé pour le projet « chromium ») et **ffmpeg**.
+
+Sous **Fedora**, ne pas utiliser `npx playwright install-deps` (script prévu pour Debian/Ubuntu). Si la validation « host » bloque le téléchargement :  
+`PLAYWRIGHT_SKIP_VALIDATE_HOST_REQUIREMENTS=1 npm run test:e2e:install`.
+
+Sous **Fedora** (ou si les binaires Playwright hôtent sur un fallback Ubuntu pénible), on peut lancer les E2E dans la **même image** que le pipeline GitLab (Ubuntu Noble, navigateurs inclus) avec **Podman** :
+
+```bash
+npm run test:e2e:podman
+```
+
+(équivalent : `bash scripts/e2e-podman.sh` — exécute `npm ci` puis `npm run test:e2e` *dans* le conteneur : ne pas réutiliser le `node_modules` de l’hôte).  
+Image par défaut : `mcr.microsoft.com/playwright:v1.59.1-noble` (voir `PLAYWRIGHT_IMAGE=…` pour surcharger). Le montage utilise le suffixe **`:Z`** pour SELinux.
+
+En cas de conflit avec un `.next` déjà présent sur l’hôte (autre `next dev`), le script utilise un **volume Podman** pour `/work/.next` (`kronosys-e2e-dot-next` par défaut, surcharge avec `PODMAN_E2E_NEXT_VOLUME`). Pour repartir à zéro : `podman volume rm kronosys-e2e-dot-next`.
+
 Les messages de commit doivent suivre les [Conventional Commits](https://www.conventionalcommits.org/) (`feat`, `fix`, etc.) pour que le journal regroupe correctement **nouveautés**, **corrections** et autres rubriques. Après `npm run release`, pousser avec `git push --follow-tags`. Si le dépôt n’a pas encore de tag pour la dernière entrée du `CHANGELOG.md`, créez `git tag vX.Y.Z <commit>` avant le prochain `release`, sinon l’historique serait dupliqué (voir l’en-tête du journal). Sur **GitHub**, le workflow **Release** crée une **GitHub Release** à chaque tag `v*.*.*`. Sur **GitLab**, créez une release à partir du même tag (interface ou `glab release create`) en réutilisant la section extraite : `bash scripts/extract-changelog-for-tag.sh CHANGELOG.md X.Y.Z`.
 
 Depuis la **racine** du monorepo : `npm run dev` délègue ici.
@@ -72,7 +99,7 @@ Sinon : `NODE_EXTRA_CA_CERTS` pointant vers le PEM racine de l’organisation, o
 
 ## Publication npm (`@nightkatana/kronosys-app`)
 
-La version est définie dans `package.json` (actuellement **0.1.0**). Avant la première publication : créer le scope **@nightkatana** sur [npmjs.com](https://www.npmjs.com/) si besoin, puis `npm login`. Depuis ce dossier :
+La version est définie dans `package.json` (référence actuelle : **`1.0.0-beta.19`**). Avant la première publication : créer le scope **@nightkatana** sur [npmjs.com](https://www.npmjs.com/) si besoin, puis `npm login`. Depuis ce dossier :
 
 ```bash
 npm publish --access public

package/app/api/action/route.ts

@@ -1,16 +1,52 @@
 import { NextResponse } from "next/server";
 
 import { dispatchKronosysAction } from "@/server/actionDispatch";
+import { clearUserActionLogs, logUserAction } from "@/server/userActionLog";
 
 export const runtime = "nodejs";
 
+function badRequest(error: string, status = 400) {
+  return NextResponse.json({ ok: false, error }, { status });
+}
+
+function isRecord(value: unknown): value is Record<string, unknown> {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+
 export async function POST(req: Request) {
-  let body: Record<string, unknown> = {};
+  let parsedBody: unknown;
   try {
-    body = (await req.json()) as Record<string, unknown>;
+    parsedBody = await req.json();
   } catch {
-    return NextResponse.json({ ok: false, error: "Invalid JSON" }, { status: 400 });
+    return badRequest("invalid_json");
+  }
+  if (!isRecord(parsedBody)) {
+    return badRequest("invalid_action_request");
   }
+  const actionType = typeof parsedBody.type === "string" ? parsedBody.type.trim() : "";
+  if (!actionType) {
+    return badRequest("missing_action_type");
+  }
+  const body = parsedBody;
   const out = await dispatchKronosysAction(body);
+  try {
+    if (actionType === "clearHistory") {
+      clearUserActionLogs();
+      return NextResponse.json({ ok: out.ok, result: out.result ?? {} });
+    }
+    const sourceIp =
+      req.headers.get("x-forwarded-for")?.split(",")[0]?.trim() ||
+      req.headers.get("x-real-ip") ||
+      null;
+    const userAgent = req.headers.get("user-agent");
+    logUserAction({
+      actionType,
+      ok: out.ok,
+      body,
+      context: { sourceIp, userAgent },
+    });
+  } catch {
+    /* ignore logging failure */
+  }
   return NextResponse.json({ ok: out.ok, result: out.result ?? {} });
 }

package/app/api/action-logs/route.ts

@@ -0,0 +1,24 @@
+import { NextResponse } from "next/server";
+
+import { readUserActionLogs } from "@/server/userActionLog";
+
+export const runtime = "nodejs";
+
+function parsePositiveInt(raw: string | null, fallback: number): number {
+  if (!raw) {
+    return fallback;
+  }
+  const n = Number.parseInt(raw, 10);
+  if (!Number.isFinite(n)) {
+    return fallback;
+  }
+  return n;
+}
+
+export function GET(req: Request) {
+  const url = new URL(req.url);
+  const limit = parsePositiveInt(url.searchParams.get("limit"), 100);
+  const offset = parsePositiveInt(url.searchParams.get("offset"), 0);
+  const logs = readUserActionLogs(limit, offset);
+  return NextResponse.json({ ok: true, logs });
+}

package/app/api/backup/route.ts

@@ -27,7 +27,7 @@ export function GET(req: Request) {
 
   if (format === "sqlite") {
     try {
-      getSqlite().pragma("wal_checkpoint(TRUNCATE)");
+      getSqlite().exec("PRAGMA wal_checkpoint(TRUNCATE);");
     } catch {
       /* ignore */
     }

package/app/api/restore/route.ts

@@ -12,6 +12,10 @@ export const runtime = "nodejs";
 const DB_NAME = "kronosys.sqlite";
 const MAX_UPLOAD_BYTES = 64 * 1024 * 1024;
 
+function badRequest(error: string, extra?: Record<string, unknown>, status = 400) {
+  return NextResponse.json({ ok: false, error, ...(extra ?? {}) }, { status });
+}
+
 function nowStamp(): string {
   return new Date().toISOString().replace(/\.\d{3}Z$/, "Z").replaceAll(":", "-");
 }
@@ -58,7 +62,7 @@ function restoreFromSqliteBuffer(buf: Buffer): { backupPath: string | null } {
 
   try {
     const db = getSqlite();
-    db.pragma("integrity_check");
+    db.exec("PRAGMA integrity_check;");
     db.exec("SELECT 1;");
   } catch (error) {
     resetSqliteConnection();
@@ -75,25 +79,24 @@ export async function POST(req: Request) {
   const ctype = req.headers.get("content-type") ?? "";
   const isMultipart = ctype.toLowerCase().includes("multipart/form-data");
   if (!isMultipart) {
-    return NextResponse.json(
-      { ok: false, error: "unsupported_content_type" },
-      { status: 415 },
-    );
+    return badRequest("unsupported_content_type", undefined, 415);
   }
 
-  const form = await req.formData();
+  let form: FormData;
+  try {
+    form = await req.formData();
+  } catch {
+    return badRequest("invalid_form_data");
+  }
   const file = form.get("file");
   const formatField = form.get("format");
   const formatRaw =
     typeof formatField === "string" ? formatField.trim().toLowerCase() : "";
   if (!(file instanceof File)) {
-    return NextResponse.json({ ok: false, error: "file_required" }, { status: 400 });
+    return badRequest("file_required");
   }
   if (file.size <= 0 || file.size > MAX_UPLOAD_BYTES) {
-    return NextResponse.json(
-      { ok: false, error: "invalid_file_size", maxBytes: MAX_UPLOAD_BYTES },
-      { status: 400 },
-    );
+    return badRequest("invalid_file_size", { maxBytes: MAX_UPLOAD_BYTES });
   }
 
   const lowerName = file.name.toLowerCase();
@@ -110,13 +113,10 @@ export async function POST(req: Request) {
     try {
       parsed = JSON.parse(text);
     } catch {
-      return NextResponse.json({ ok: false, error: "invalid_json" }, { status: 400 });
+      return badRequest("invalid_json");
     }
     if (!validatePayloadShape(parsed)) {
-      return NextResponse.json(
-        { ok: false, error: "invalid_kronosys_payload" },
-        { status: 400 },
-      );
+      return badRequest("invalid_kronosys_payload");
     }
     writePayload(parsed);
     return NextResponse.json({ ok: true, restored: "json" });
@@ -125,17 +125,11 @@ export async function POST(req: Request) {
   const bytes = await file.arrayBuffer();
   const buf = Buffer.from(bytes);
   if (buf.length < 1024) {
-    return NextResponse.json(
-      { ok: false, error: "sqlite_too_small" },
-      { status: 400 },
-    );
+    return badRequest("sqlite_too_small");
   }
   const header = buf.subarray(0, 16).toString("utf8");
   if (!header.startsWith("SQLite format 3")) {
-    return NextResponse.json(
-      { ok: false, error: "invalid_sqlite_file" },
-      { status: 400 },
-    );
+    return badRequest("invalid_sqlite_file");
   }
 
   try {

package/app/changelog/page.tsx

@@ -5,6 +5,7 @@ import Link from "next/link";
 import { useSearchParams } from "next/navigation";
 import ReactMarkdown, { type Components } from "react-markdown";
 import { AppVersionStamp } from "@/components/dashboard/AppVersionStamp";
+import { AppShellHeaderWallClock } from "@/components/dashboard/AppShellHeaderWallClock";
 import { ThemeToggle } from "@/components/dashboard/ThemeToggle";
 import { PageRefreshButton } from "@/components/dashboard/PageRefreshButton";
 import { ScrollToTopFab } from "@/components/dashboard/ScrollToTopFab";
@@ -105,6 +106,7 @@ function ChangelogBody() {
             </p>
           </div>
           <div className="flex flex-wrap items-center gap-1.5">
+            <AppShellHeaderWallClock lang={lang} dt={dt} />
             <ThemeToggle lang={lang} />
             <PageRefreshButton
               title={dt.pageRefreshTitle}

package/app/globals.css

@@ -51,17 +51,15 @@ body {
 @keyframes kronosys-route-transition-in-kf {
   from {
     opacity: 0;
-    transform: translateY(6px);
   }
   to {
     opacity: 1;
-    transform: translateY(0);
   }
 }
 
 .kronosys-route-transition-in {
   animation: kronosys-route-transition-in-kf 170ms ease-out both;
-  will-change: opacity, transform;
+  will-change: opacity;
 }
 
 /* Minuteur focus : clignotement sous 5 min (travail / longue pause), accent violet sous 30 s */
@@ -99,6 +97,32 @@ html.dark .kronosys-session-duration-alert {
   color: rgb(248 113 113);
 }
 
+/* Fin planifiée imminente (sessions/tâches): clignotement progressif avant échéance. */
+@keyframes kronosys-end-time-alert-blink-kf {
+  0%,
+  100% {
+    opacity: 1;
+  }
+  50% {
+    opacity: 0.42;
+  }
+}
+
+.kronosys-end-time-alert-slow {
+  color: rgb(220 38 38);
+  animation: kronosys-end-time-alert-blink-kf 2.2s ease-in-out infinite;
+}
+
+.kronosys-end-time-alert-fast {
+  color: rgb(220 38 38);
+  animation: kronosys-end-time-alert-blink-kf 0.95s ease-in-out infinite;
+}
+
+html.dark .kronosys-end-time-alert-slow,
+html.dark .kronosys-end-time-alert-fast {
+  color: rgb(248 113 113);
+}
+
 /* Saisie tâche « passé » : exactement deux assombrissements (pas de 3e pic dû au easing) */
 @keyframes kronosys-past-datetime-blink-twice-kf {
   0%,
@@ -271,7 +295,6 @@ html.dark .kronosys-datetime-popover select option {
 
   .kronosys-route-transition-in {
     animation: none;
-    transform: none;
   }
 
   .kronosys-krono-focus-time-blink {
@@ -285,6 +308,12 @@ html.dark .kronosys-datetime-popover select option {
     transform: none;
   }
 
+  .kronosys-end-time-alert-slow,
+  .kronosys-end-time-alert-fast {
+    animation: none;
+    opacity: 1;
+  }
+
   .kronosys-past-datetime-blink-twice {
     animation: none;
     opacity: 1;

package/app/guide/page.tsx

@@ -14,6 +14,7 @@ import {
 } from "@/lib/appShellHeaderClasses";
 import { AppShellCommandCenterPlaceholder } from "@/components/dashboard/AppShellCommandCenterPlaceholder";
 import { AppShellHeaderSessionMeta } from "@/components/dashboard/AppShellHeaderSessionMeta";
+import { AppShellHeaderWallClock } from "@/components/dashboard/AppShellHeaderWallClock";
 import { AppShellRouteNav } from "@/components/dashboard/AppShellRouteNav";
 import { UserGuideBodyText } from "@/components/dashboard/UserGuideBodyText";
 import { ThemeToggle } from "@/components/dashboard/ThemeToggle";
@@ -121,6 +122,7 @@ function GuideContent() {
         </div>
         <div className="flex w-full justify-end">
           <div className={appShellHeaderToolbarClassName}>
+            <AppShellHeaderWallClock lang={lang} dt={dt} />
             <AppShellCommandCenterPlaceholder />
             <AppShellRouteNav
               current="guide"