@7365admin1/layer-common 4.136.0 → 4.137.0

package/components/ScheduleTaskMain.vue

@@ -5,10 +5,52 @@
         :org-id="orgId"
         :site="site"
         :service-type="serviceType"
-        text="An extra visit adds one more round to your daily schedule at the time you choose, once or on a repeat. Staff on this site get a push notification when it is added."
-      />
+        text="An extra visit adds one more round to the Daily Checklist at a time you choose - once, or on a repeat."
+        how-title="How extra visits work"
+        how-key="extra-visits"
+      >
+        <ol class="sg-steps">
+          <li>
+            Every night the app makes the <strong>Daily Checklist</strong>
+            for every area on this site. You do not need to do anything for
+            that.
+          </li>
+          <li>
+            An <strong>extra visit</strong> adds one more round to that
+            checklist, in the areas you pick, at the time you set - once, or
+            repeating (every day, weekdays, chosen days, or monthly).
+          </li>
+          <li>
+            At that time, staff see the extra round in their mobile app's
+            daily checklist (with a push notification) and tick each unit as
+            they finish it.
+          </li>
+          <li>
+            Here and in the Daily Checklist you see how it went:
+            <strong>Done</strong>, <strong>In progress</strong>,
+            <strong>Needs redo</strong> or <strong>Missed</strong>.
+          </li>
+        </ol>
+        <div class="sg-example">
+          <strong>Example:</strong> the lobby toilets get busy at lunch. Add
+          an extra visit called "Lunch toilet check", pick the area "Lobby
+          Toilets", set 2:00 pm, every weekday. From the next weekday, staff
+          get one more toilet round at 2:00 pm, on top of their normal ones.
+        </div>
+        <div class="sg-h">What the words mean</div>
+        <dl class="sg-legend">
+          <template v-for="h in STATUS_HELP" :key="h.word">
+            <dt><StatusChip :status="h.word" :label="h.word" /></dt>
+            <dd>{{ h.meaning }}</dd>
+          </template>
+          <template v-for="h in RESULT_HELP" :key="'r' + h.word">
+            <dt><StatusChip :status="h.word" :label="h.word" /></dt>
+            <dd>Last visit: {{ h.meaning }}</dd>
+          </template>
+        </dl>
+      </ScheduleGuide>
       <TableMain
-        :title="'Extra Visits (Scheduled)'"
+        :title="'Extra Visits'"
         :items="items"
         :headers="headers"
         :loading="loading"
@@ -26,9 +68,14 @@
           <div class="st-empty">
             <strong>No extra visits yet.</strong>
             <span>
-              An extra visit adds one more round to your daily
-              {{ scheduleName }} at a time you choose. Set up your Areas and
-              Units first, then add one.
+              Your Daily Checklist already covers the normal rounds. Add an
+              extra visit when an area needs one more round at a set time -
+              for example "Lunch toilet check, Lobby Toilets, 2:00 pm every
+              weekday".
+            </span>
+            <span v-if="canCreateScheduleTask">
+              Press <strong>Add Extra Visit</strong> above to start. Your
+              Areas and Units must be set up first.
             </span>
           </div>
         </template>
@@ -61,27 +108,6 @@
           </v-row>
         </template>
 
-        <template #item.areas="{ value }">
-          <div v-if="value && value.length > 0">
-            <StatusChip
-              v-for="(area, idx) in value.slice(0, 2)"
-              :key="idx"
-              class="mr-1 mb-1"
-              :dot="false"
-              tone="neutral"
-              :label="area.name"
-            />
-            <StatusChip
-              v-if="value.length > 2"
-              class="mb-1"
-              :dot="false"
-              tone="neutral"
-              :label="`+${value.length - 2} more`"
-            />
-          </div>
-          <span v-else>N/A</span>
-        </template>
-
         <template #item.when="{ item }">
           <span class="st-when">{{ item.whenText }}</span>
         </template>
@@ -91,24 +117,34 @@
         </template>
 
         <template #item.lastRun="{ item }">
-          <StatusChip
-            v-if="item.lastRun && item.lastRunStatus === 'done'"
-            status="Done"
-            :label="item.lastRunText"
-          />
-          <StatusChip
-            v-else-if="item.lastRun && item.lastRunStatus === 'missed'"
-            status="Missed"
-            :label="item.lastRunText"
-          />
-          <span v-else>{{ item.lastRunText }}</span>
+          <div class="st-cell">
+            <StatusChip
+              v-if="item.lastRun && item.lastRunWord"
+              :status="item.lastRunWord"
+              :label="item.lastRunText"
+            />
+            <span v-else>{{ item.lastRunText }}</span>
+            <a
+              v-if="item.lastRun"
+              href="#"
+              class="st-link"
+              @click.prevent.stop="openChecklist(item)"
+            >
+              See that day's checklist
+            </a>
+          </div>
         </template>
 
         <template #item.status="{ item }">
-          <StatusChip
-            :status="item.stateLabel"
-            :label="item.stateLabel"
-          />
+          <div class="st-cell">
+            <StatusChip
+              :status="item.stateLabel"
+              :label="item.stateLabel"
+            />
+            <span v-if="item.stateKey === 'ended'" class="st-note">
+              {{ item.finishedText }}
+            </span>
+          </div>
         </template>
 
         <template #item.actions="{ item }">
@@ -123,6 +159,17 @@
             >
               Edit
             </v-btn>
+            <v-btn
+              v-if="canUpdateScheduleTask && item.stateKey === 'ended'"
+              size="small"
+              variant="tonal"
+              color="primary"
+              class="text-none"
+              prepend-icon="mdi-calendar-refresh"
+              @click.stop="onExtendRow(item)"
+            >
+              Extend or repeat
+            </v-btn>
             <v-btn
               v-if="canUpdateScheduleTask && item.stateKey !== 'ended'"
               size="small"
@@ -155,6 +202,7 @@
         v-model:show="showForm"
         :mode="formMode"
         :taskData="selectedTask"
+        :start-step="formStartStep"
         :site="props.site"
         :serviceType="props.serviceType"
         @refresh="getTaskRefresh"
@@ -194,7 +242,7 @@
 
                 <v-row no-gutters class="mb-2">
                   <v-col cols="5" class="text-subtitle-2 font-weight-bold">
-                    Next run:
+                    Next visit:
                   </v-col>
                   <v-col cols="7" class="text-subtitle-2">
                     {{ selectedNext || "-" }}
@@ -203,10 +251,18 @@
 
                 <v-row no-gutters class="mb-2">
                   <v-col cols="5" class="text-subtitle-2 font-weight-bold">
-                    Last run:
+                    Last visit:
                   </v-col>
                   <v-col cols="7" class="text-subtitle-2">
                     {{ lastRunLabel(selectedTask) }}
+                    <a
+                      v-if="selectedTask.lastRun"
+                      href="#"
+                      class="st-link d-block"
+                      @click.prevent="openChecklist(selectedTask)"
+                    >
+                      See that day's checklist
+                    </a>
                   </v-col>
                 </v-row>
 
@@ -319,7 +375,7 @@
                                 </div>
                                 <span v-else class="text-caption text-disabled"
                                   >No units in this area, so it is skipped when
-                                  this visit runs.</span
+                                  this visit is added.</span
                                 >
                               </v-card-text>
                             </div>
@@ -348,6 +404,12 @@
                       :status="stateOf(selectedTask).label"
                       :label="stateOf(selectedTask).label"
                     />
+                    <div
+                      v-if="stateOf(selectedTask).key === 'ended'"
+                      class="st-note mt-1"
+                    >
+                      {{ finishedReason(selectedTask as any) }}
+                    </div>
                   </v-col>
                 </v-row>
 
@@ -383,8 +445,8 @@
           </v-card-title>
 
           <v-card-text class="screen-modal__body">
-            This stops all future runs of this extra visit. Visits that already
-            happened are kept. Delete it?
+            This stops all future extra visits from it. Visits that already
+            happened stay on their Daily Checklists. Delete it?
           </v-card-text>
 
           <div class="screen-modal__footer">
@@ -422,8 +484,12 @@ import useScheduleTask from "../composables/useScheduleTask";
 import useUtils from "../composables/useUtils";
 import useAreas from "../composables/useAreas";
 import {
+  RESULT_HELP,
+  STATUS_HELP,
   STATUS_LABELS,
+  describeRow,
   describeWhen,
+  finishedReason,
   fmtMoment,
   lastRunLabel,
   scheduleNameFor,
@@ -458,7 +524,16 @@ const canViewScheduleTaskDetails = computed(
   () => props.canViewScheduleTaskDetails
 );
 
-const scheduleName = scheduleNameFor(props.serviceType).title;
+const checklistRoute = scheduleNameFor(props.serviceType).route;
+
+/** Opens the Daily Checklist filtered to the day this extra visit was last added. */
+function openChecklist(row: Record<string, any>) {
+  const day = String(row?.lastRun || "").slice(0, 10);
+  navigateTo({
+    path: `/${props.orgId}/${props.site}/${checklistRoute}`,
+    query: /^\d{4}-\d{2}-\d{2}$/.test(day) ? { date: day } : {},
+  });
+}
 
 const page = ref(1);
 const pages = ref(0);
@@ -468,6 +543,7 @@ const searchInput = ref("");
 const showForm = ref(false);
 const selectedTask = ref<Record<string, any>>({});
 const formMode = ref<"add" | "edit">("add");
+const formStartStep = ref(1);
 const submitting = ref(false);
 const dialogShowMoreActions = ref(false);
 const dialogDeleteTask = ref(false);
@@ -517,11 +593,10 @@ watch(dialogShowMoreActions, async (isOpen) => {
 const items = ref<any[]>([]);
 
 const headers = [
-  { title: "Title", value: "title" },
-  { title: "Areas", value: "areas" },
-  { title: "When", value: "when", sortable: false },
-  { title: "Next run", value: "nextRun", sortable: false },
-  { title: "Last run", value: "lastRun", sortable: false },
+  { title: "Extra visit", value: "title" },
+  { title: "What will happen", value: "when", sortable: false },
+  { title: "Next visit", value: "nextRun", sortable: false },
+  { title: "Last visit", value: "lastRun", sortable: false },
   { title: "Status", value: "status", sortable: false },
   { title: "", value: "actions", sortable: false, align: "end" as const },
 ];
@@ -566,7 +641,9 @@ watchEffect(() => {
       const st = stateOf(row);
       return {
         ...row,
-        whenText: describeWhen(row),
+        whenText: describeRow(row),
+        finishedText: finishedReason(row),
+        lastRunWord: ({ done: "Done", missed: "Missed", pending: "In progress" } as Record<string, string>)[row.lastRunStatus] || "",
         nextRunText: fmtMoment(row.nextRun),
         lastRunText: lastRunLabel(row),
         stateKey: st.key,
@@ -590,6 +667,7 @@ watch(
 
 function openFormDialog() {
   formMode.value = "add";
+  formStartStep.value = 1;
   selectedTask.value = {};
   showForm.value = true;
 }
@@ -597,6 +675,15 @@ function openFormDialog() {
 function onEditRow(item: Record<string, any>) {
   selectedTask.value = item;
   formMode.value = "edit";
+  formStartStep.value = 1;
+  showForm.value = true;
+}
+
+// A finished extra visit: open its "When" step so a new end date or repeat is one change away.
+function onExtendRow(item: Record<string, any>) {
+  selectedTask.value = item;
+  formMode.value = "edit";
+  formStartStep.value = 3;
   showForm.value = true;
 }
 
@@ -612,8 +699,8 @@ async function togglePause(item: Record<string, any>) {
     await setScheduleTaskPaused(item._id, !resuming);
     showMessage(
       resuming
-        ? "Resumed. It will run again from its next date."
-        : "Paused. It will not run until you resume it.",
+        ? "Resumed. Extra visits are added again from its next date."
+        : "Paused. No extra visits are added until you resume it.",
       "success",
     );
     await getTaskRefresh();
@@ -649,6 +736,7 @@ async function onRowClick(data: any) {
 const onEditFromMoreAction = async () => {
   dialogShowMoreActions.value = false;
   formMode.value = "edit";
+  formStartStep.value = stateOf(selectedTask.value).key === "ended" ? 3 : 1;
   showForm.value = true;
 };
 
@@ -693,8 +781,27 @@ async function _deleteScheduleTask() {
   color: var(--text2);
 }
 .st-when {
+  display: inline-block;
+  min-width: 220px;
   white-space: normal;
 }
+.st-cell {
+  display: flex;
+  flex-direction: column;
+  align-items: flex-start;
+  gap: 4px;
+}
+.st-note {
+  font-size: var(--fs-chip-lg);
+  color: var(--text2);
+  white-space: normal;
+}
+.st-link {
+  font-size: var(--fs-chip-lg);
+  font-weight: 600;
+  color: rgb(var(--v-theme-primary));
+  text-decoration: underline;
+}
 .st-actions {
   display: flex;
   justify-content: flex-end;

package/components/StatusChip.vue

@@ -104,7 +104,7 @@ const toneClass = computed(() =>
   font-size: var(--fs-chip);
 }
 
-/* The role tag: `padding:3px 10px;border-radius:999px;font-size:11.5px`. */
+/* The role tag: `padding:3px 10px;border-radius:999px;font-size:12.5px`. */
 .status-chip--pill {
   padding: 3px 10px;
   font-size: var(--fs-chip);

package/components/VisitorsReportPreview.vue

@@ -397,12 +397,12 @@ onMounted(() => {
 
     :deep(.v-data-table thead tr th) {
         padding: 6px !important;
-        font-size: 11px !important;
+        font-size: 12px !important;
     }
 
     :deep(.v-data-table tbody tr td) {
         padding: 4px !important;
-        font-size: 10px !important;
+        font-size: 12px !important;
     }
 
     :deep(.v-img) {

package/package.json

@@ -2,7 +2,7 @@
   "name": "@7365admin1/layer-common",
   "license": "MIT",
   "type": "module",
-  "version": "4.136.0",
+  "version": "4.137.0",
   "author": "7365admin1",
   "main": "./nuxt.config.ts",
   "//files": "What a consumer extending this layer actually loads. Without this npm ships the whole working tree - the changesets, the CI workflows, the render harness in tools/ and any scratch directory that happened to exist at publish time. Nuxt resolves a layer by directory, so every runtime directory below has to stay listed; adding a new top-level runtime directory means adding it here too.",

package/utils/breadcrumb.ts

@@ -25,6 +25,13 @@ const ACRONYMS: Record<string, string> = {
 const RENAMED: [string, string][] = [
   ["Building Mgmt", "Occupancy Mgmt"],
   ["Event Mgmt", "Task Calendar"],
+  // Schedule screens (owner 21 Oct): the same names the menu and the mobile apps use.
+  ["Schedule Task", "Extra Visits"],
+  ...["Cleaning", "Technician", "Pest", "Pool", "Landscape"].flatMap((t): [string, string][] => [
+    [`${t} Schedule Area`, "Area"],
+    [`${t} Schedule Unit`, "Unit"],
+    [`${t} Schedule`, "Daily Checklist"],
+  ]),
 ];
 
 export function moduleNameFromRoute(route: {

package/utils/nav-sections.ts

@@ -50,6 +50,8 @@ export const NAV_SECTIONS: Record<string, string> = {
   Area: "SERVICE DELIVERY",
   Unit: "SERVICE DELIVERY",
   "Schedule Task": "SERVICE DELIVERY",
+  "Daily Checklist": "SERVICE DELIVERY",
+  "Extra Visits": "SERVICE DELIVERY",
 
   // EQUIPMENT
   "Equipment Management": "EQUIPMENT",

package/utils/schedule-task.ts

@@ -176,12 +176,20 @@ export function validateSchedule(f: TScheduleForm, now: Date = new Date()): TSch
   return e;
 }
 
-/** "at 08:00 every weekday from 21 Oct until 31 Dec" - the When, as a sentence fragment. */
+/** "08:00" -> "8:00 am", "14:30" -> "2:30 pm". Anything else is returned as given. */
+export function fmtTime(time: string | null | undefined): string {
+  const m = TIME_RE.exec(time || "");
+  if (!m) return time || "";
+  const h = Number(m[1]);
+  return `${h % 12 || 12}:${m[2]} ${h < 12 ? "am" : "pm"}`;
+}
+
+/** "every weekday at 8:00 am from 21 Oct until 31 Dec" - the When, as a sentence fragment. */
 export function describeWhen(
   t: Partial<TRule> & { time?: string },
   nowYear?: string,
 ): string {
-  const time = t.time ? `at ${t.time} ` : "";
+  const at = t.time ? ` at ${fmtTime(t.time)}` : "";
   const repeat = t.repeat || "none";
   const dates = t.dates || [];
   const range =
@@ -189,23 +197,23 @@ export function describeWhen(
     (t.endDate ? ` until ${fmtDate(t.endDate, nowYear)}` : "");
   switch (repeat) {
     case "daily":
-      return `${time}every day${range}`;
+      return `every day${at}${range}`;
     case "weekdays":
-      return `${time}every weekday${range}`;
+      return `every weekday${at}${range}`;
     case "weekly": {
       const names = WEEK_DAYS.filter((d) => (t.daysOfWeek || []).includes(d.value)).map((d) => d.title);
-      return `${time}every ${names.join(", ") || "week"}${range}`;
+      return `every ${names.join(", ") || "week"}${at}${range}`;
     }
     case "monthly": {
       const day = t.startDate ? Number(t.startDate.slice(8, 10)) : null;
       const on = day === null ? "every month" : day === 31 ? "on the last day of every month" : `on day ${day} of every month`;
-      return `${time}${on}${range}`;
+      return `${on}${at}${range}`;
     }
     default: {
       const sorted = [...dates].sort();
-      if (!sorted.length) return `${time}on no date`.trim();
+      if (!sorted.length) return `on no date${at}`;
       const shown = sorted.slice(0, 3).map((d) => fmtDate(d, nowYear)).join(", ");
-      return `${time}on ${shown}${sorted.length > 3 ? ` +${sorted.length - 3} more` : ""}${
+      return `on ${shown}${sorted.length > 3 ? ` +${sorted.length - 3} more` : ""}${at}${
         t.endDate ? ` (until ${fmtDate(t.endDate, nowYear)})` : ""
       }`;
     }
@@ -226,33 +234,93 @@ export function buildSummary(
   return `Adds 1 extra visit to ${areas} (${units}) ${describeWhen(f, year)} — next: ${nextText}.`;
 }
 
-export const STATUS_LABELS: Record<string, string> = { active: "Active", paused: "Paused", ended: "Ended" };
+/** The state of an extra visit as a whole. "ended" reads "Finished": nothing is left to run. */
+export const STATUS_LABELS: Record<string, string> = { active: "Active", paused: "Paused", ended: "Finished" };
+
+/** What each word means, shown on the page so nobody has to guess. Same words as the mobile apps. */
+export const STATUS_HELP: { word: string; meaning: string }[] = [
+  { word: "Active", meaning: "It will add a visit at its next date and time." },
+  { word: "Paused", meaning: "Stopped for now. Nothing is added until you press Resume." },
+  { word: "Finished", meaning: "Its last date has passed, so nothing more is added. Press \"Extend or repeat\" to keep it going." },
+];
+export const RESULT_HELP: { word: string; meaning: string }[] = [
+  { word: "Not started", meaning: "Nothing is ticked yet." },
+  { word: "In progress", meaning: "Some units are ticked; the rest can still be done today." },
+  { word: "Done", meaning: "Staff ticked every unit of the visit." },
+  { word: "Needs redo", meaning: "A supervisor sent a unit back to be done again." },
+  { word: "Missed", meaning: "The day ended with units not done." },
+];
 
-/** "Done 20 Oct" / "Missed 20 Oct" / "Not run yet". */
+/** "Done 20 Oct" / "Missed 20 Oct" / "No visit yet". */
 export function lastRunLabel(row: { lastRun?: string | null; lastRunStatus?: string | null }): string {
-  if (!row.lastRun) return "Not run yet";
+  if (!row.lastRun) return "No visit yet";
   const m = /^(\d{4}-\d{2}-\d{2})/.exec(row.lastRun);
   const day = m ? fmtDate(m[1]) : "";
-  const word = { done: "Done", missed: "Missed", pending: "In progress" }[row.lastRunStatus || ""] || "Ran";
+  const word = { done: "Done", missed: "Missed", pending: "In progress" }[row.lastRunStatus || ""] || "Added";
   return `${word} ${day}`.trim();
 }
 
+/** Why an extra visit says Finished, in one sentence. */
+export function finishedReason(row: Partial<TRule>, nowYear?: string): string {
+  if (row.repeat && row.repeat !== "none" && row.endDate) {
+    return `Its end date (${fmtDate(row.endDate, nowYear)}) has passed.`;
+  }
+  return "All the dates it was set for have passed.";
+}
+
 /**
- * One name and one page path per trade. The names are the web menu names (M&E
- * is "Technician Schedule" - the mobile app mirrors it); the path is the folder
- * the trade app serves its daily schedule from.
+ * One sentence per list row: "Every Mon, Wed at 2:00 pm in Lobby D — next on Wed 22 Oct".
+ * Paused and finished rows say so instead of a next date.
  */
-export const SCHEDULE_NAMES: Record<string, { title: string; route: string }> = {
-  cleaning_services: { title: "Cleaning Schedule", route: "cleaning-schedule" },
-  landscaping_services: { title: "Landscape Schedule", route: "landscape-schedule" },
-  pest_control_services: { title: "Pest Schedule", route: "pest-schedule" },
-  pool_maintenance_services: { title: "Pool Schedule", route: "pool-schedule" },
-  mechanical_electrical_services: { title: "Technician Schedule", route: "technician-schedule" },
+export function describeRow(
+  row: Partial<TRule> & {
+    areas?: { name?: string }[];
+    nextRun?: string | null;
+    scheduleStatus?: string | null;
+    paused?: boolean;
+  },
+  nowYear?: string,
+): string {
+  const when = describeWhen(row, nowYear);
+  const names = (row.areas || []).map((a) => a?.name).filter(Boolean) as string[];
+  const where = names.length
+    ? ` in ${names.slice(0, 3).join(", ")}${names.length > 3 ? ` +${names.length - 3} more` : ""}`
+    : "";
+  const state = row.scheduleStatus || (row.paused ? "paused" : "active");
+  const m = /^(\d{4}-\d{2}-\d{2})/.exec(row.nextRun || "");
+  const tail =
+    state === "paused"
+      ? " — paused, nothing is added until you resume it"
+      : state === "ended"
+        ? " — finished"
+        : m
+          ? ` — next on ${DAYS[weekdayOf(m[1])]} ${fmtDate(m[1], nowYear)}`
+          : "";
+  return `${when.charAt(0).toUpperCase()}${when.slice(1)}${where}${tail}`;
+}
+
+/**
+ * One trade word and one page path per trade. Every trade's menu says "Daily
+ * Checklist" (owner 21 Oct; the mobile apps use the same name); the page title
+ * adds the trade ("Daily Checklist – Cleaning"). The path is the folder the
+ * trade app serves its daily checklist from - unchanged, so links and
+ * permissions keep working.
+ */
+export const SCHEDULE_NAMES: Record<string, { title: string; trade: string; route: string }> = {
+  cleaning_services: { title: "Daily Checklist", trade: "Cleaning", route: "cleaning-schedule" },
+  landscaping_services: { title: "Daily Checklist", trade: "Landscape", route: "landscape-schedule" },
+  pest_control_services: { title: "Daily Checklist", trade: "Pest", route: "pest-schedule" },
+  pool_maintenance_services: { title: "Daily Checklist", trade: "Pool", route: "pool-schedule" },
+  mechanical_electrical_services: { title: "Daily Checklist", trade: "Technician", route: "technician-schedule" },
 };
 
 export const scheduleNameFor = (serviceType?: string) =>
   SCHEDULE_NAMES[serviceType || ""] || SCHEDULE_NAMES.cleaning_services;
 
+/** "Daily Checklist – Cleaning" / "– Technician" / ... */
+export const dailyChecklistTitle = (serviceType?: string) =>
+  `Daily Checklist – ${scheduleNameFor(serviceType).trade}`;
+
 /** Singapore "today" as YYYY-MM-DD, for "is today's list there yet". */
 export const sgtToday = (now: Date = new Date()) => sgtParts(now).date;
 
@@ -265,13 +333,28 @@ export function hasListForToday(rows: { createdAt?: string | Date }[], now: Date
   });
 }
 
-/** One spelling for the in-flight state ("Ongoing" / "On-going" -> "In progress"); other words pass through. */
+/**
+ * The daily checklist's words, the same on web and mobile: Open -> Not started,
+ * Ongoing / On-going -> In progress, Completed -> Done. Closed stays Closed (the
+ * day ended; anything not ticked counts as Missed). Other words pass through.
+ */
 export function dailyStatusLabel(status: string | null | undefined): string {
   const s = String(status ?? "").trim();
   if (!s) return "No status";
-  return /^on-?going$/i.test(s) ? "In progress" : s;
+  if (/^on-?going$/i.test(s)) return "In progress";
+  if (/^open$/i.test(s)) return "Not started";
+  if (/^completed?$/i.test(s)) return "Done";
+  return s;
 }
 
+/** What the daily checklist's words mean, shown on the page. */
+export const DAILY_STATUS_HELP: { word: string; meaning: string }[] = [
+  { word: "Not started", meaning: "The day's list is open and nothing is ticked yet." },
+  { word: "In progress", meaning: "Staff have ticked some units; the rest can still be done." },
+  { word: "Done", meaning: "Every unit on the list was ticked." },
+  { word: "Closed", meaning: "The day ended at midnight. The list is view-only, and anything not ticked counts as Missed." },
+];
+
 /** A unit's result in the history view: Done, Needs redo (rejected by a supervisor) or Missed (never done). */
 export function historyUnitLabel(status: string | null | undefined): "Done" | "Needs redo" | "Missed" {
   const s = String(status ?? "").trim().toLowerCase();