hvp-shared 13.35.0 → 14.0.0

package/dist/constants/shift-checklist.enums.d.ts

@@ -1,11 +1,10 @@
 /**
  * Shift Checklist Enums
  *
- * Enums for the shift checklist module: a per-occasion ("run") list of recurring
- * tasks a collaborator reviews at check-in and before checkout. A master
- * `ChecklistActivity` defines the recurring task; a `ChecklistRun` is one
- * occasion (collaborator + moment + day); a `ChecklistCompletion` records a task
- * done/not-done within a run.
+ * Enums for the shift checklist module. A master `ChecklistActivity` defines a
+ * recurring task; a `ChecklistDailyStatus` records, per `(branch, day, activity)`,
+ * whether it was done/skipped/not-done and who did it. There is no per-person
+ * "run" — status is tracked at the branch+day grain (the matrix model, GH#454).
  */
 /**
  * When an activity applies (shown as a tag in the day checklist).
@@ -15,8 +14,8 @@
  * - `both`      (Ambos): relevant at both entrada and salida
  * - `any`       (Indistinto): do it once, doesn't matter entrada or salida
  *
- * `both` / `any` are valid ONLY on an activity definition. A run/completion
- * occasion is always `check_in` OR `check_out`.
+ * `both` / `any` are valid ONLY on an activity definition. A view is always
+ * requested for a single `check_in` OR `check_out` occasion.
  */
 export declare enum ChecklistMoment {
     check_in = "check_in",
@@ -25,8 +24,8 @@ export declare enum ChecklistMoment {
     any = "any"
 }
 export declare const CHECKLIST_MOMENT_LABELS: Record<ChecklistMoment, string>;
-/** Moments valid for a run/completion occasion (never `both` / `any`). */
-export declare const RUN_MOMENTS: Set<ChecklistMoment>;
+/** Moments a view can be requested for (never `both` / `any`). */
+export declare const VIEW_MOMENTS: Set<ChecklistMoment>;
 /**
  * Status of a task within a run (three conscious actions; "unmarked" = no action).
  *
@@ -70,14 +69,3 @@ export declare enum ChecklistPriority {
     low = "low"
 }
 export declare const CHECKLIST_PRIORITY_LABELS: Record<ChecklistPriority, string>;
-/**
- * Lifecycle of a per-occasion checklist run.
- *
- * - `open`: created, collaborator filling it
- * - `submitted`: collaborator confirmed/submitted the run
- */
-export declare enum ChecklistRunStatus {
-    open = "open",
-    submitted = "submitted"
-}
-export declare const CHECKLIST_RUN_STATUS_LABELS: Record<ChecklistRunStatus, string>;

package/dist/constants/shift-checklist.enums.js

@@ -2,14 +2,13 @@
 /**
  * Shift Checklist Enums
  *
- * Enums for the shift checklist module: a per-occasion ("run") list of recurring
- * tasks a collaborator reviews at check-in and before checkout. A master
- * `ChecklistActivity` defines the recurring task; a `ChecklistRun` is one
- * occasion (collaborator + moment + day); a `ChecklistCompletion` records a task
- * done/not-done within a run.
+ * Enums for the shift checklist module. A master `ChecklistActivity` defines a
+ * recurring task; a `ChecklistDailyStatus` records, per `(branch, day, activity)`,
+ * whether it was done/skipped/not-done and who did it. There is no per-person
+ * "run" — status is tracked at the branch+day grain (the matrix model, GH#454).
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.CHECKLIST_RUN_STATUS_LABELS = exports.ChecklistRunStatus = exports.CHECKLIST_PRIORITY_LABELS = exports.ChecklistPriority = exports.PER_BRANCH_MODES = exports.CHECKLIST_BRANCH_MODE_LABELS = exports.ChecklistBranchMode = exports.SATISFYING_COMPLETION_STATUSES = exports.CHECKLIST_COMPLETION_STATUS_HELP = exports.CHECKLIST_COMPLETION_STATUS_LABELS = exports.ChecklistCompletionStatus = exports.RUN_MOMENTS = exports.CHECKLIST_MOMENT_LABELS = exports.ChecklistMoment = void 0;
+exports.CHECKLIST_PRIORITY_LABELS = exports.ChecklistPriority = exports.PER_BRANCH_MODES = exports.CHECKLIST_BRANCH_MODE_LABELS = exports.ChecklistBranchMode = exports.SATISFYING_COMPLETION_STATUSES = exports.CHECKLIST_COMPLETION_STATUS_HELP = exports.CHECKLIST_COMPLETION_STATUS_LABELS = exports.ChecklistCompletionStatus = exports.VIEW_MOMENTS = exports.CHECKLIST_MOMENT_LABELS = exports.ChecklistMoment = void 0;
 // --- Moment of shift ---
 /**
  * When an activity applies (shown as a tag in the day checklist).
@@ -19,8 +18,8 @@ exports.CHECKLIST_RUN_STATUS_LABELS = exports.ChecklistRunStatus = exports.CHECK
  * - `both`      (Ambos): relevant at both entrada and salida
  * - `any`       (Indistinto): do it once, doesn't matter entrada or salida
  *
- * `both` / `any` are valid ONLY on an activity definition. A run/completion
- * occasion is always `check_in` OR `check_out`.
+ * `both` / `any` are valid ONLY on an activity definition. A view is always
+ * requested for a single `check_in` OR `check_out` occasion.
  */
 var ChecklistMoment;
 (function (ChecklistMoment) {
@@ -35,8 +34,8 @@ exports.CHECKLIST_MOMENT_LABELS = {
     [ChecklistMoment.both]: "Ambos",
     [ChecklistMoment.any]: "Indistinto",
 };
-/** Moments valid for a run/completion occasion (never `both` / `any`). */
-exports.RUN_MOMENTS = new Set([
+/** Moments a view can be requested for (never `both` / `any`). */
+exports.VIEW_MOMENTS = new Set([
     ChecklistMoment.check_in,
     ChecklistMoment.check_out,
 ]);
@@ -110,19 +109,3 @@ exports.CHECKLIST_PRIORITY_LABELS = {
     [ChecklistPriority.medium]: "Media",
     [ChecklistPriority.low]: "Baja",
 };
-// --- Run status ---
-/**
- * Lifecycle of a per-occasion checklist run.
- *
- * - `open`: created, collaborator filling it
- * - `submitted`: collaborator confirmed/submitted the run
- */
-var ChecklistRunStatus;
-(function (ChecklistRunStatus) {
-    ChecklistRunStatus["open"] = "open";
-    ChecklistRunStatus["submitted"] = "submitted";
-})(ChecklistRunStatus || (exports.ChecklistRunStatus = ChecklistRunStatus = {}));
-exports.CHECKLIST_RUN_STATUS_LABELS = {
-    [ChecklistRunStatus.open]: "Abierto",
-    [ChecklistRunStatus.submitted]: "Enviado",
-};

package/dist/contracts/shift-checklist/requests.d.ts

@@ -1,11 +1,11 @@
 /**
  * Shift Checklist Request Types
  *
- * Request DTOs for the shift checklist endpoints.
+ * Request DTOs for the shift checklist endpoints (matrix model, GH#454).
  *
- * @example POST   /api/shift-checklist/activities
- * @example GET    /api/shift-checklist/runs/view
- * @example POST   /api/shift-checklist/runs/:id/completions/batch
+ * @example POST  /api/shift-checklist/activities
+ * @example GET   /api/shift-checklist/view
+ * @example POST  /api/shift-checklist/record
  */
 import { ChecklistBranchMode, ChecklistCompletionStatus, ChecklistMoment, ChecklistPriority } from '../../constants/shift-checklist.enums';
 /**
@@ -61,51 +61,43 @@ export interface ListChecklistActivitiesFilters {
     isActive?: boolean;
 }
 /**
- * Query for the checkout view (find-or-create a run + its assembled view).
+ * Query for the day view: the activities for a branch + moment, each with its
+ * last-done history and today's status from the matrix. Run-less.
  *
- * @example GET /api/shift-checklist/runs/view?momentOfShift=check_out&branchId=...
+ * @example GET /api/shift-checklist/view?momentOfShift=check_out&branchId=...
  */
 export interface GetChecklistViewQuery {
-    /** check_in or check_out (never both) */
+    /** check_in or check_out (never both) — filters which activities show. */
     momentOfShift: ChecklistMoment;
     branchId: string;
-    /** YYYY-MM-DD; defaults to today (America/Mexico_City) server-side */
+    /** YYYY-MM-DD (Mexico calendar day); defaults to today (America/Mexico_City) server-side */
     shiftDate?: string;
-    /** link to the realized attendance occasion (TimeShift) when opened from checkout */
-    attendanceRecordId?: string;
 }
 /**
- * Update a run (e.g. correct the branch for the whole run, or add notes).
- *
- * @example PATCH /api/shift-checklist/runs/:id
+ * A single activity's status to record for the day. Upserted into the matrix
+ * cell `(branchId, shiftDate, activityId)`; performers are unioned, not replaced.
  */
-export interface UpdateChecklistRunRequest {
-    branchId?: string;
-    notes?: string;
-}
-/**
- * A single completion to record/update within a run.
- * Either `activityId` (master task) or `adHocTitle` (ad-hoc task) must be set.
- */
-export interface RecordCompletionItemRequest {
-    /** null/omitted = ad-hoc task (requires adHocTitle) */
-    activityId?: string | null;
-    adHocTitle?: string;
+export interface RecordChecklistStatusItem {
+    activityId: string;
     status: ChecklistCompletionStatus;
     /** who did it; defaults to [current user]. Multiple for shared tasks. */
     performedByIds?: string[];
-    /** required when status is "skipped" */
+    /** optional reason when status is "skipped" / "not_done" */
     skipReason?: string;
     notes?: string;
-    evidenceUrl?: string | null;
 }
 /**
- * Batch upsert completions in a run (idempotent per activity).
+ * Batch upsert the day's status for one branch (idempotent per activity).
  *
- * @example POST /api/shift-checklist/runs/:id/completions/batch
+ * @example POST /api/shift-checklist/record
  */
-export interface RecordCompletionsBatchRequest {
-    items: RecordCompletionItemRequest[];
+export interface RecordChecklistStatusRequest {
+    branchId: string;
+    /** YYYY-MM-DD (Mexico calendar day); defaults to today server-side */
+    shiftDate?: string;
+    /** context only (which moment the user was in); not stored on the cell */
+    momentOfShift?: ChecklistMoment;
+    items: RecordChecklistStatusItem[];
 }
 /**
  * Query filters for checklist statistics.

package/dist/contracts/shift-checklist/requests.js

@@ -2,10 +2,10 @@
 /**
  * Shift Checklist Request Types
  *
- * Request DTOs for the shift checklist endpoints.
+ * Request DTOs for the shift checklist endpoints (matrix model, GH#454).
  *
- * @example POST   /api/shift-checklist/activities
- * @example GET    /api/shift-checklist/runs/view
- * @example POST   /api/shift-checklist/runs/:id/completions/batch
+ * @example POST  /api/shift-checklist/activities
+ * @example GET   /api/shift-checklist/view
+ * @example POST  /api/shift-checklist/record
  */
 Object.defineProperty(exports, "__esModule", { value: true });

package/dist/contracts/shift-checklist/responses.d.ts

@@ -2,9 +2,10 @@
  * Shift Checklist Response Types
  *
  * Response DTOs for the shift checklist endpoints. Dates are ISO 8601 strings.
+ * Model (GH#454): the day view is run-less — activities + their matrix status.
  */
-import { ChecklistBranchMode, ChecklistMoment, ChecklistPriority, ChecklistRunStatus } from '../../constants/shift-checklist.enums';
-import { ChecklistAdHocItem, ChecklistCheckoutItem } from './types';
+import { ChecklistBranchMode, ChecklistMoment, ChecklistPriority } from '../../constants/shift-checklist.enums';
+import { ChecklistViewItem } from './types';
 /**
  * A master checklist activity.
  *
@@ -30,43 +31,50 @@ export interface ChecklistActivityResponse {
     updatedBy: string;
 }
 /**
- * A per-occasion checklist run.
+ * The assembled day view: the branch/day/moment context plus the activity rows
+ * (each with last-done, overdue, and today's status). Powers the checklist UI
+ * and the check-in/check-out modal. Run-less.
  *
- * @example GET /api/shift-checklist/runs/view
+ * @example GET  /api/shift-checklist/view
+ * @example POST /api/shift-checklist/record (refreshed view)
  */
-export interface ChecklistRunResponse {
-    id: string;
-    collaboratorId: string;
+export interface ChecklistViewResponse {
     branchId: string;
     branchName: string;
-    momentOfShift: ChecklistMoment;
+    /** YYYY-MM-DD, Mexico calendar day */
     shiftDate: string;
-    attendanceRecordId: string | null;
-    status: ChecklistRunStatus;
-    submittedAt: string | null;
-    notes: string;
+    /** the moment requested (check_in | check_out) */
+    momentOfShift: ChecklistMoment;
+    items: ChecklistViewItem[];
 }
 /**
- * The assembled checkout view: the run, its activity rows (with last-done +
- * overdue), and any ad-hoc items. Powers the checkout modal.
- *
- * @example GET /api/shift-checklist/runs/view
- * @example POST /api/shift-checklist/runs/:id/completions/batch (refreshed view)
+ * Per-activity rollup over the period at a branch (the matrix, aggregated).
  */
-export interface ChecklistCheckoutViewResponse {
-    run: ChecklistRunResponse;
-    items: ChecklistCheckoutItem[];
-    adHocItems: ChecklistAdHocItem[];
+export interface ChecklistActivityStat {
+    activityId: string;
+    name: string;
+    /** distinct days the activity was DONE in range */
+    doneDays: number;
+    /** distinct days marked "No hacía falta" */
+    skippedDays: number;
+    /** distinct days marked "No se pudo" */
+    notDoneDays: number;
 }
+/**
+ * Per-branch checklist statistics over a period.
+ */
 export interface ChecklistBranchStats {
     branchId: string;
     branchName: string;
-    totalCompletions: number;
+    /** matrix cells with status done in range */
     doneCount: number;
-    notDoneCount: number;
+    /** matrix cells with status skipped in range */
     skippedCount: number;
+    /** matrix cells with status not_done in range */
+    notDoneCount: number;
     /** master activities currently overdue at this branch */
     overdueActivityCount: number;
+    byActivity: ChecklistActivityStat[];
 }
 /**
  * Checklist statistics over a period.
@@ -77,9 +85,10 @@ export interface ChecklistStatsResponse {
     from: string | null;
     to: string | null;
     byBranch: ChecklistBranchStats[];
-    totalRuns: number;
-    /** done completions / total completions, 0..1 */
-    completionRate: number;
+    /** done cells in range */
+    totalDone: number;
+    /** all acted cells in range (done + skipped + not_done) */
+    totalActions: number;
 }
 /**
  * A one-off "pendiente" — created on the fly, stays open per branch across shifts

package/dist/contracts/shift-checklist/responses.js

@@ -3,5 +3,6 @@
  * Shift Checklist Response Types
  *
  * Response DTOs for the shift checklist endpoints. Dates are ISO 8601 strings.
+ * Model (GH#454): the day view is run-less — activities + their matrix status.
  */
 Object.defineProperty(exports, "__esModule", { value: true });

package/dist/contracts/shift-checklist/types.d.ts

@@ -1,43 +1,34 @@
 /**
  * Shift Checklist — shared building-block types
  *
- * Reusable shapes referenced by the endpoint responses (checkout view items,
- * completion shape). Dates are ISO 8601 strings on the wire.
+ * Reusable shapes referenced by the endpoint responses. Dates are ISO 8601
+ * strings on the wire.
+ *
+ * Model (GH#454): status is tracked per `(branch, day, activity)` — the matrix.
+ * There is no per-person "run"/"completion"; multiple people who did the same
+ * task on the same day are merged into a single row's `doneBy` list.
  */
 import { ChecklistBranchMode, ChecklistCompletionStatus, ChecklistMoment, ChecklistPriority } from '../../constants/shift-checklist.enums';
 /**
- * A recorded completion of a task within a run (or an ad-hoc task).
- *
- * @example POST /api/shift-checklist/runs/:id/completions/batch
+ * Today's recorded status for an activity at a branch (one matrix cell).
+ * `null` on a view item means no action has been taken today.
  */
-export interface ChecklistCompletionResponse {
-    id: string;
-    runId: string;
-    /** null = ad-hoc task (not on the master list) */
-    activityId: string | null;
-    /** present when activityId is null */
-    adHocTitle: string | null;
+export interface ChecklistTodayStatus {
     status: ChecklistCompletionStatus;
-    /** present when status is "skipped" */
+    /** Everyone who contributed today (union; nobody overwrites anyone). */
+    doneByIds: string[];
+    doneByNames: string[];
+    /** present when status is "skipped" / "not_done" */
     skipReason: string | null;
-    /** who performed the task (one or more, for shared tasks) */
-    performedByIds: string[];
-    performedByNames: string[];
-    /** who logged the completion */
-    reportedById: string;
-    evidenceUrl: string | null;
     notes: string;
-    completedAt: string | null;
-    /** denormalized from the run */
-    branchId: string;
-    shiftDate: string;
-    momentOfShift: ChecklistMoment;
+    /** when the latest action was recorded today */
+    lastActionAt: string | null;
 }
 /**
- * One row in the checkout view: a master activity plus its last-done history and
- * this run's completion (if any).
+ * One row in the day view: a master activity plus its last-done history and
+ * today's status (if any) at the viewed branch.
  */
-export interface ChecklistCheckoutItem {
+export interface ChecklistViewItem {
     activityId: string;
     name: string;
     /** When the activity is meant to be done (shown as a tag in the day list). */
@@ -51,7 +42,7 @@ export interface ChecklistCheckoutItem {
     instructions: string;
     requiresEvidence: boolean;
     frequencyDays: number | null;
-    /** last time this activity was DONE at this branch (drives overdue) */
+    /** last time this activity was DONE at this branch (drives overdue / "Última vez") */
     lastDoneAt: string | null;
     /** who did it last (may be several for a shared task) */
     lastDoneByIds: string[];
@@ -69,18 +60,8 @@ export interface ChecklistCheckoutItem {
         skipReason: string | null;
         notes: string;
     } | null;
-    /** lastDoneAt + frequencyDays < now (false when no cadence or never done) */
+    /** A full cadence was missed (Philosophy B). False when no cadence or never done. */
     isOverdue: boolean;
-    /** this run's completion for the activity, if recorded */
-    completion: ChecklistCompletionResponse | null;
-}
-/** An ad-hoc task added during a run (not tied to a master activity). */
-export interface ChecklistAdHocItem {
-    id: string;
-    adHocTitle: string;
-    status: ChecklistCompletionStatus;
-    performedByIds: string[];
-    performedByNames: string[];
-    completedAt: string | null;
-    notes: string;
+    /** today's matrix cell for this activity at this branch, if acted on */
+    today: ChecklistTodayStatus | null;
 }

package/dist/contracts/shift-checklist/types.js

@@ -2,7 +2,11 @@
 /**
  * Shift Checklist — shared building-block types
  *
- * Reusable shapes referenced by the endpoint responses (checkout view items,
- * completion shape). Dates are ISO 8601 strings on the wire.
+ * Reusable shapes referenced by the endpoint responses. Dates are ISO 8601
+ * strings on the wire.
+ *
+ * Model (GH#454): status is tracked per `(branch, day, activity)` — the matrix.
+ * There is no per-person "run"/"completion"; multiple people who did the same
+ * task on the same day are merged into a single row's `doneBy` list.
  */
 Object.defineProperty(exports, "__esModule", { value: true });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "hvp-shared",
-  "version": "13.35.0",
+  "version": "14.0.0",
   "description": "Shared types and utilities for HVP backend and frontend",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",