@7365admin1/layer-common 4.97.1-staging.588 → 4.97.1-staging.589

package/components/Nfc/NFCPatrolReportMain.vue

@@ -100,6 +100,7 @@ import {
   reportFileName,
   type CsvSection,
 } from "../../utils/report-export";
+import { reportYear } from "../../utils/nfc-patrol-report";
 
 import PatrolReportTab from "./PatrolReport/PatrolReportTab.vue";
 import DailyReportTab from "./PatrolReport/DailyReportTab.vue";
@@ -137,6 +138,7 @@ function updateFilters(value: NFCPatrolReportFilters) {
   filters.route = value.route;
   filters.timeRange = value.timeRange;
   filters.date = value.date;
+  filters.year = value.year;
 }
 
 const { exportReportPdf } = useReportPdf();
@@ -147,10 +149,10 @@ function reportMeta(report: HTMLElement, extension: "pdf" | "csv"): ReportPdfMet
   const route = options.value.routes.find(({ value }) => value === filters.route)?.title;
   const text = (selector: string) => report.querySelector(selector)?.textContent?.trim() || undefined;
 
-  // The yearly table always covers the current year (useNFCPatrolMonthlyReport).
+  // The yearly table covers the year picked on the Monthly Report.
   const period =
     activeTab.value === "monthly"
-      ? { label: "Year", value: String(new Date().getFullYear()) }
+      ? { label: "Year", value: reportYear(filters.year) }
       : { label: "Date", value: formatReportDate(filters.date) };
   const details = [{ label: "Route", value: route ?? "-" }, period];
   if (activeTab.value === "patrol" && filters.timeRange) {

package/components/Nfc/NFCPatrolRouteForm.vue

@@ -111,7 +111,7 @@
               {{
                 form.timed
                   ? "Patrols start at the route's start times, within the tolerance."
-                  : "No time window: this route can be patrolled at any time."
+                  : "No time window: patrol at any time of day, on the selected Days only. Use Select all for every day."
               }}
             </div>
           </v-col>

package/components/Nfc/PatrolReport/MonthlyReportTab.vue

@@ -5,6 +5,7 @@
       :options="options"
       :show-time-filter="false"
       :show-date-filter="false"
+      show-year-filter
       @update:model-value="$emit('update:filters', $event)"
       @export="(type) => $emit('export', type, csvSections())"
     />
@@ -53,7 +54,7 @@ import type {
 } from "../../../types/nfc-patrol-report";
 
 import { useNFCPatrolMonthlyReport } from "../../../composables/useNFCPatrolMonthlyReport";
-import { monthlyReportCsv } from "../../../utils/nfc-patrol-report";
+import { monthlyReportCsv, reportYear } from "../../../utils/nfc-patrol-report";
 import PatrolMonthDialog from "./PatrolMonthDialog.vue";
 import type { CsvSection } from "../../../utils/report-export";
 
@@ -84,8 +85,7 @@ const monthTitle = ref("");
 const monthRows = shallowRef<NFCPatrolReportSummaryRow[]>([]);
 
 function openMonth(monthIndex: number) {
-  // The yearly report always covers the current year (useNFCPatrolMonthlyReport).
-  monthTitle.value = `${report.value?.rows[monthIndex]?.month ?? ""} ${new Date().getFullYear()}`;
+  monthTitle.value = `${report.value?.rows[monthIndex]?.month ?? ""} ${reportYear(props.filters.year)}`;
   monthRows.value = monthRuns(monthIndex);
   monthOpen.value = true;
 }
@@ -95,7 +95,7 @@ function csvSections() {
 }
 
 watch(
-  () => [props.filters.route, props.active],
+  () => [props.filters.route, props.filters.year, props.active],
   () => {
     if (props.active) {
       void fetchReport();

package/components/Nfc/PatrolReport/ReportFilters.vue

@@ -63,6 +63,25 @@
       />
     </v-col>
 
+    <!-- Monthly Report: which year. Each month's row then opens that month. -->
+    <v-col
+      v-if="showYearFilter"
+      cols="12"
+      md="2"
+      class="px-md-2 mb-2 mb-md-0"
+    >
+      <v-select
+        :model-value="reportYear(modelValue.year)"
+        :items="reportYears()"
+        label="Year"
+        class="filter-field"
+        variant="outlined"
+        density="comfortable"
+        hide-details
+        @update:model-value="updateFilter('year', $event)"
+      />
+    </v-col>
+
     <v-spacer />
 
     <v-col cols="12" md="2" class="pl-md-2">
@@ -99,6 +118,7 @@ import type {
   NFCPatrolReportFilters,
 } from "../../../types/nfc-patrol-report";
 import ReportDatePicker from "./ReportDatePicker.vue";
+import { reportYear, reportYears } from "../../../utils/nfc-patrol-report";
 
 const props = withDefaults(
   defineProps<{
@@ -106,12 +126,14 @@ const props = withDefaults(
     options: NFCPatrolReportFilterOptions;
     showTimeFilter?: boolean;
     showDateFilter?: boolean;
+    showYearFilter?: boolean;
   }>(),
   {
     showTimeFilter: true,
     showDateFilter: true,
+    showYearFilter: false,
   },
-);;
+);
 
 const emit = defineEmits<{
   "update:modelValue": [value: NFCPatrolReportFilters];

package/composables/useNFCPatrolMonthlyReport.ts

@@ -11,6 +11,7 @@ import {
   mapLogsToMonthlyRows,
   mapLogsToMonthRuns,
   monthIndexOf,
+  reportYear,
 } from "../utils/nfc-patrol-report";
 
 interface NFCPatrolLogListResponse {
@@ -53,7 +54,7 @@ export function useNFCPatrolMonthlyReport(
    */
   const failed = ref(false);
 
-  // The year's patrol logs, kept so a month's row can open its list without
+  // The picked year's patrol logs, kept so a month's row can open its list without
   // asking the server again. Not deep-reactive: nothing edits them.
   const logs = shallowRef<Record<string, any>[]>([]);
   let siteTimezone: string | undefined;
@@ -70,7 +71,7 @@ export function useNFCPatrolMonthlyReport(
     loading.value = true;
     notFound.value = false;
     failed.value = false;
-    const currentYear = new Date().getFullYear().toString();
+    const year = reportYear(filters.year);
     try {
       // The whole year, not page one of it. `collectAllPages` reads the page
       // count out of the first reply and walks the rest.
@@ -81,7 +82,8 @@ export function useNFCPatrolMonthlyReport(
             limit: 100,
             site,
             routeId: filters.route,
-            date: currentYear,
+            // "YYYY" + type "month": the server returns that whole year.
+            date: year,
             type: "month",
           }),
         ),

package/composables/useNFCPatrolReportFilters.ts

@@ -21,6 +21,7 @@ export function useNFCPatrolReportFilters(site: string) {
     route: "",
     timeRange: "",
     date: getTodayDate(),
+    year: String(new Date().getFullYear()),
   });
 
   const options = ref<NFCPatrolReportFilterOptions>({

package/package.json

@@ -2,7 +2,7 @@
   "name": "@7365admin1/layer-common",
   "license": "MIT",
   "type": "module",
-  "version": "4.97.1-staging.588",
+  "version": "4.97.1-staging.589",
   "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/types/nfc-patrol-report.ts

@@ -6,6 +6,8 @@ export interface NFCPatrolReportFilters {
   route: string;
   timeRange: string;
   date: string;
+  /** The Monthly Report's year, "YYYY". Absent = the current year. */
+  year?: string;
 }
 
 export interface NFCPatrolReportExportRequest {

package/utils/nfc-patrol-report.ts

@@ -102,6 +102,21 @@ export function isMissedCheckpoint(
   return Number.isFinite(end) && now.getTime() > end;
 }
 
+/** The Monthly Report's year: the one picked, or the current year. */
+export function reportYear(year?: string, now = new Date()) {
+  return /^\d{4}$/.test(year ?? "") ? (year as string) : String(now.getFullYear());
+}
+
+/**
+ * The years the Monthly Report offers, newest first: this year and the five
+ * before it.
+ */
+// ponytail: fixed 6-year window; derive from the oldest log if sites need more.
+export function reportYears(now = new Date(), count = 6) {
+  const current = now.getFullYear();
+  return Array.from({ length: count }, (_, i) => String(current - i));
+}
+
 /** The month (0-11) a patrol log counts under; NaN for a date that is not one. */
 export function monthIndexOf(log: Record<string, any>) {
   return new Date(log?.date).getMonth();