@nightkatana/kronosys-app 1.0.0-beta.2 → 1.0.0-beta.21

package/components/dashboard/useReportingInteractionState.ts

@@ -0,0 +1,80 @@
+"use client";
+
+import { useCallback, useEffect, useRef, useState } from "react";
+
+import {
+  readWeekStartsOnFromStorage,
+  type ReportingWeekStartsOn,
+} from "@/lib/reportingWeekLayout";
+
+type ModalAnchor = { x: number; y: number };
+type ModalRect = { left: number; top: number; width: number; height: number };
+
+export function useReportingInteractionState<TScope>() {
+  const [weekStartsOn, setWeekStartsOn] = useState<ReportingWeekStartsOn>("monday");
+  const [chartWeekNavIndex, setChartWeekNavIndex] = useState(-1);
+  const [tagWeekRollupOpenKeys, setTagWeekRollupOpenKeys] = useState<Set<string>>(
+    () => new Set<string>(),
+  );
+  const [projectWeekTagBreakdownOpenKeys, setProjectWeekTagBreakdownOpenKeys] =
+    useState<Set<string>>(() => new Set<string>());
+  const [reportingTourOpen, setReportingTourOpen] = useState(false);
+  const [taskInspectScope, setTaskInspectScope] = useState<TScope | null>(null);
+  const [taskInspectAnchor, setTaskInspectAnchor] = useState<ModalAnchor | null>(null);
+  const [taskInspectModalRect, setTaskInspectModalRect] = useState<ModalRect | null>(null);
+  const [portalReady, setPortalReady] = useState(false);
+  const taskInspectModalRef = useRef<HTMLDivElement | null>(null);
+
+  const toggleTagWeekRollup = useCallback((key: string) => {
+    setTagWeekRollupOpenKeys((prev) => {
+      const next = new Set(prev);
+      if (next.has(key)) {
+        next.delete(key);
+      } else {
+        next.add(key);
+      }
+      return next;
+    });
+  }, []);
+
+  const toggleProjectWeekTagBreakdown = useCallback((key: string) => {
+    setProjectWeekTagBreakdownOpenKeys((prev) => {
+      const next = new Set(prev);
+      if (next.has(key)) {
+        next.delete(key);
+      } else {
+        next.add(key);
+      }
+      return next;
+    });
+  }, []);
+
+  useEffect(() => {
+    setWeekStartsOn(readWeekStartsOnFromStorage());
+  }, []);
+
+  useEffect(() => {
+    setPortalReady(true);
+  }, []);
+
+  return {
+    weekStartsOn,
+    setWeekStartsOn,
+    chartWeekNavIndex,
+    setChartWeekNavIndex,
+    tagWeekRollupOpenKeys,
+    toggleTagWeekRollup,
+    projectWeekTagBreakdownOpenKeys,
+    toggleProjectWeekTagBreakdown,
+    reportingTourOpen,
+    setReportingTourOpen,
+    taskInspectScope,
+    setTaskInspectScope,
+    taskInspectAnchor,
+    setTaskInspectAnchor,
+    taskInspectModalRect,
+    setTaskInspectModalRect,
+    portalReady,
+    taskInspectModalRef,
+  };
+}

package/lib/appShellHeaderClasses.ts

@@ -10,3 +10,16 @@ export const appShellHeaderClassName =
  */
 export const appShellHeaderToolRowClassName =
   "flex w-full flex-col gap-3 sm:flex-row sm:items-start sm:justify-between";
+
+/**
+ * Première ligne d’en-tête : bloc titre (gauche) et colonne contexte session (droite), comme sur le tableau de bord.
+ */
+export const appShellHeaderTitleMetaRowClassName =
+  "mb-3 flex w-full flex-col gap-3 sm:mb-4 sm:flex-row sm:items-start sm:justify-between sm:gap-6";
+
+/**
+ * Barre d’actions à droite : même empilement que le tableau de bord (recherche / raccourcis,
+ * navigation, thème, rafraîchissement, langue) pour éviter les décalages entre routes.
+ */
+export const appShellHeaderToolbarClassName =
+  "flex min-h-10 shrink-0 flex-wrap items-center justify-end gap-1.5";

package/lib/businessRulesMatrix.ts

@@ -0,0 +1,210 @@
+import type { Lang } from "./dashboardCopy";
+
+export type BusinessRuleStatus = "todo" | "validated" | "partial";
+
+export type BusinessRuleItem = {
+  id: string;
+  domain: string;
+  title: string;
+  status: BusinessRuleStatus;
+  codeRefs: string[];
+  testRefs: string[];
+  note?: string;
+};
+
+export type BusinessRulesMatrixBundle = {
+  heading: string;
+  subtitle: string;
+  statusLegend: string;
+  columns: {
+    id: string;
+    domain: string;
+    rule: string;
+    status: string;
+    code: string;
+    tests: string;
+    note: string;
+  };
+  statuses: Record<BusinessRuleStatus, string>;
+  rows: BusinessRuleItem[];
+};
+
+const rowsFr: BusinessRuleItem[] = [
+  {
+    id: "BR-001",
+    domain: "Session",
+    title: "Une session live cumule une durée murale tant qu'elle n'est ni en pause ni terminée.",
+    status: "todo",
+    codeRefs: ["server/sessionWallHydrate.ts", "server/actionDispatch.ts"],
+    testRefs: ["server/sessionWallHydrate.test.ts", "server/actionDispatch.test.ts"],
+  },
+  {
+    id: "BR-002",
+    domain: "Session",
+    title: "La pause session gèle la durée murale sans modifier directement les durées de tâches déjà persistées.",
+    status: "todo",
+    codeRefs: ["server/actionDispatch.ts"],
+    testRefs: ["server/actionDispatch.test.ts"],
+  },
+  {
+    id: "BR-003",
+    domain: "Session",
+    title: "La fin de session ferme les segments actifs et garde un état cohérent pour l'historique.",
+    status: "todo",
+    codeRefs: ["server/actionDispatch.ts"],
+    testRefs: ["server/actionDispatch.test.ts"],
+  },
+  {
+    id: "BR-004",
+    domain: "Tâches",
+    title: "Le minuteur tâche cumule en durationMs via segments, distinct du mur session.",
+    status: "todo",
+    codeRefs: ["server/actionTaskSession.ts", "server/mainTimerHydrate.ts"],
+    testRefs: ["server/actionTaskSession.test.ts", "server/mainTimerHydrate.test.ts"],
+  },
+  {
+    id: "BR-005",
+    domain: "Tâches",
+    title: "Une sous-tâche active exclut le cumul parallèle du minuteur principal.",
+    status: "todo",
+    codeRefs: ["server/actionTaskSession.ts"],
+    testRefs: ["server/actionTaskSession.test.ts"],
+  },
+  {
+    id: "BR-006",
+    domain: "Tâches",
+    title: "Les bornes temporelles tâche respectent les modes keep/manual/from_bounds.",
+    status: "todo",
+    codeRefs: ["server/actionTaskSession.ts", "server/actionDispatch.ts"],
+    testRefs: ["server/actionTaskSession.test.ts", "server/actionDispatch.test.ts"],
+  },
+  {
+    id: "BR-007",
+    domain: "Pause globale",
+    title: "Le contexte de pause globale restaure correctement les minuteurs concernés.",
+    status: "todo",
+    codeRefs: ["server/actionDispatch.ts"],
+    testRefs: ["server/actionDispatch.test.ts"],
+  },
+  {
+    id: "BR-008",
+    domain: "Planning futur",
+    title: "Le statut planifié (futur) reste un comportement UI sans casser les invariants serveur.",
+    status: "todo",
+    codeRefs: ["lib/temporalDisplayPlanned.ts", "lib/sessionTaskSidebarStats.ts", "app/page.tsx"],
+    testRefs: ["lib/temporalDisplayPlanned.test.ts", "lib/sessionTaskSidebarStats.test.ts"],
+  },
+  {
+    id: "BR-009",
+    domain: "Reporting",
+    title: "Les agrégats distinguent explicitement temps mur session et temps tâches.",
+    status: "todo",
+    codeRefs: ["lib/reportingAggregate.ts"],
+    testRefs: ["lib/reportingAggregate.test.ts"],
+  },
+  {
+    id: "BR-010",
+    domain: "Reporting",
+    title: "Les filtres tags/projets et l'exclusion d'archives respectent la logique attendue.",
+    status: "todo",
+    codeRefs: ["lib/reportingAggregate.ts", "app/reporting/page.tsx"],
+    testRefs: ["lib/reportingTagWeekBreakdown.test.ts", "lib/reportingAggregate.test.ts"],
+  },
+  {
+    id: "BR-011",
+    domain: "Métadonnées",
+    title: "Renommer/purger tag ou projet propage les effets partout.",
+    status: "todo",
+    codeRefs: ["server/actionDispatch.ts", "server/actionTaskSession.ts"],
+    testRefs: ["server/actionDispatch.test.ts"],
+  },
+  {
+    id: "BR-012",
+    domain: "API état",
+    title: "/api/state renvoie un contrat stable (type, payload, headers cache).",
+    status: "todo",
+    codeRefs: ["app/api/state/route.ts"],
+    testRefs: ["test/integration/apiState.test.ts"],
+  },
+  {
+    id: "BR-013",
+    domain: "API action",
+    title: "/api/action valide l'entrée minimale et homogénéise les erreurs d'entrée.",
+    status: "todo",
+    codeRefs: ["app/api/action/route.ts"],
+    testRefs: ["test/integration/apiActionValidation.test.ts"],
+  },
+  {
+    id: "BR-014",
+    domain: "API restore",
+    title: "/api/restore valide format, taille et forme des données importées.",
+    status: "todo",
+    codeRefs: ["app/api/restore/route.ts"],
+    testRefs: ["test/integration/apiRestore.test.ts"],
+  },
+  {
+    id: "BR-015",
+    domain: "Persistance",
+    title: "Les mutations payload sensibles sont sérialisées/transactionnelles.",
+    status: "partial",
+    codeRefs: ["server/payloadStore.ts", "server/actionDispatch.ts"],
+    testRefs: ["server/actionDispatch.test.ts"],
+    note: "Ajouter des tests de concurrence dédiés.",
+  },
+  {
+    id: "BR-016",
+    domain: "Schéma DB",
+    title: "Le schéma centralisé évite la duplication de DDL et les divergences.",
+    status: "todo",
+    codeRefs: ["server/dbSchema.ts", "server/db.ts"],
+    testRefs: ["test/integration/apiState.test.ts", "test/integration/apiRestore.test.ts"],
+  },
+];
+
+const frBundle: BusinessRulesMatrixBundle = {
+  heading: "Matrice de validation métier",
+  subtitle:
+    "Référentiel de vérification des règles métier critiques. Source dépôt: docs/BUSINESS_RULES_VALIDATION_MATRIX.md.",
+  statusLegend: "Statuts: À vérifier / À compléter / Validé.",
+  columns: {
+    id: "ID",
+    domain: "Domaine",
+    rule: "Règle métier",
+    status: "Statut",
+    code: "Code",
+    tests: "Tests",
+    note: "Note",
+  },
+  statuses: {
+    todo: "À vérifier",
+    partial: "À compléter",
+    validated: "Validé",
+  },
+  rows: rowsFr,
+};
+
+const enBundle: BusinessRulesMatrixBundle = {
+  heading: "Business validation matrix",
+  subtitle:
+    "Verification register for critical business rules. Repo source: docs/BUSINESS_RULES_VALIDATION_MATRIX.md.",
+  statusLegend: "Statuses: To verify / Partial / Validated.",
+  columns: {
+    id: "ID",
+    domain: "Domain",
+    rule: "Business rule",
+    status: "Status",
+    code: "Code",
+    tests: "Tests",
+    note: "Note",
+  },
+  statuses: {
+    todo: "To verify",
+    partial: "Partial",
+    validated: "Validated",
+  },
+  rows: rowsFr.map((row) => ({ ...row })),
+};
+
+export function businessRulesMatrixBundle(lang: Lang): BusinessRulesMatrixBundle {
+  return lang === "fr" ? frBundle : enBundle;
+}

package/lib/copyToClipboard.ts

@@ -0,0 +1,43 @@
+/**
+ * Copie du texte dans le presse-papiers.
+ * Utilise l’API Clipboard lorsque le contexte est sécurisé ; sinon (HTTP hors localhost)
+ * ou en cas d’échec, retombe sur une sélection temporaire + execCommand.
+ */
+export async function copyTextToClipboard(text: string): Promise<boolean> {
+  if (typeof document === "undefined") {
+    return false;
+  }
+
+  const fallbackCopy = (): boolean => {
+    try {
+      const ta = document.createElement("textarea");
+      ta.value = text;
+      ta.setAttribute("readonly", "");
+      ta.style.position = "fixed";
+      ta.style.left = "-9999px";
+      ta.style.top = "0";
+      ta.setAttribute("tabindex", "-1");
+      document.body.appendChild(ta);
+      ta.focus();
+      ta.select();
+      ta.setSelectionRange(0, text.length);
+      /* Fallback intentionnel : Clipboard API indisponible (HTTP, permissions). */
+      const ok = document.execCommand("copy"); // NOSONAR — repli navigateur hors Clipboard API
+      ta.remove();
+      return ok;
+    } catch {
+      return false;
+    }
+  };
+
+  if (globalThis.window?.isSecureContext && navigator.clipboard?.writeText) {
+    try {
+      await navigator.clipboard.writeText(text);
+      return true;
+    } catch {
+      return fallbackCopy();
+    }
+  }
+
+  return fallbackCopy();
+}