@7365admin1/layer-common 4.97.1-staging.599 → 4.97.1-staging.601

package/components/VehicleManagement.vue

@@ -17,7 +17,7 @@
           <AppButton v-if="qrStickersOn" icon="mdi-qrcode" variant="ghost" @click="openStickerDialog()">
             Print QR stickers
           </AppButton>
-          <AppButton v-if="canCreateVehicle" icon="mdi-plus" @click="handleAddVehicleClick">
+          <AppButton v-if="canCreateVehicle || canAddBlocklist" icon="mdi-plus" @click="handleAddVehicleClick">
             Add Vehicle
           </AppButton>
         </template>
@@ -103,26 +103,26 @@
         be drawn.
       -->
       <template #item.action="{ item }">
-        <v-menu v-if="rowHasVehicleActions(item, vehiclePermissions) || qrStickersOn" location="bottom end">
+        <v-menu v-if="rowHasVehicleActions(item, vehiclePermissions) || qrStickersOn || rowPlates(item).some(qrActionsOn)" location="bottom end">
           <template #activator="{ props: menuProps }">
             <AppButton v-bind="menuProps" variant="row" icon="mdi-dots-vertical" aria-label="Vehicle actions"
               @click.stop />
           </template>
           <v-list density="compact">
             <template v-for="plate in rowPlates(item)" :key="plate._id ?? plate.plateNumber">
-              <template v-if="vehiclePlateActions(plate, vehiclePermissions).length || qrStickersOn">
+              <template v-if="vehiclePlateActions(plate, vehiclePermissions).length || qrStickersOn || qrActionsOn(plate)">
                 <v-list-subheader v-if="rowPlates(item).length > 1">
                   {{ plate.plateNumber }}
                 </v-list-subheader>
                 <v-list-item v-if="qrStickersOn && plate.hasQrSticker" title="Print sticker again" prepend-icon="mdi-printer"
                   data-test="vehicle-qr-print-again" @click="openStickerDialog([String(plate._id)])" />
-                <v-list-item v-if="qrStickersOn" title="Re-issue sticker (lost or stolen)" prepend-icon="mdi-qrcode-edit"
+                <v-list-item v-if="qrActionsOn(plate)" title="Re-issue sticker (lost or stolen)" prepend-icon="mdi-qrcode-edit"
                   @click="askReissue(plate as TPlateNumber)" />
-                <v-list-item v-if="qrStickersOn" title="Undo re-issue" prepend-icon="mdi-undo"
+                <v-list-item v-if="qrActionsOn(plate)" title="Undo re-issue" prepend-icon="mdi-undo"
                   data-test="vehicle-qr-undo" @click="askUndo(plate as TPlateNumber)" />
-                <v-list-item v-if="qrStickersOn" title="Link QR sticker" prepend-icon="mdi-link-variant"
+                <v-list-item v-if="qrActionsOn(plate)" title="Link QR sticker" prepend-icon="mdi-link-variant"
                   @click="askLink(plate as TPlateNumber)" />
-                <v-list-item v-if="qrStickersOn" title="Remove QR sticker" prepend-icon="mdi-link-variant-off"
+                <v-list-item v-if="qrActionsOn(plate)" title="Remove QR sticker" prepend-icon="mdi-link-variant-off"
                   @click="askUnlink(plate as TPlateNumber)" />
                 <v-list-item v-for="action in vehiclePlateActions(plate, vehiclePermissions)" :key="action.key"
                   :title="action.title" :prepend-icon="action.icon" :base-color="action.color"
@@ -137,7 +137,7 @@
     <!-- <Snackbar v-model="messageSnackbar" :text="message" :color="messageColor" /> -->
 
     <v-dialog v-model="dialog.showSelection" width="450" persistent>
-      <VehicleAddSelection :can-manage-blocklist="canManageBlocklist" @cancel="dialog.showSelection = false" @select="handleSelectVehicleStatus" />
+      <VehicleAddSelection :can-manage-blocklist="canManageBlocklist" :can-add-whitelist="canCreateVehicle" @cancel="dialog.showSelection = false" @select="handleSelectVehicleStatus" />
     </v-dialog>
 
     <!-- Many whitelist vehicles at once. Wider than the one-vehicle form: it
@@ -232,7 +232,7 @@
                           <AnprCameraBadge :cameras="(plateNumberItem as any).anprCameras ?? []" :plate-number="value"
                             :plate-id="(plateNumberItem as any)._id ?? ''" :status="(plateNumberItem as any).status ?? ''"
                             :type="(plateNumberItem as any).type ?? ''" :end="(plateNumberItem as any).end ?? null"
-                            :active-counts="activeCameraCounts"
+                            :active-counts="activeCameraCounts" :can-sync="syncAllowed(plateNumberItem)"
                             @synced="handleSynced" />
                         </span>
                       </template>
@@ -244,20 +244,20 @@
                           v-tooltip:top="'History'" @click="openHistory(plateNumberItem as TPlateNumber)" />
                       </template>
                       <template #item.action="{ item: plateNumberItem }">
-                        <v-menu v-if="vehiclePlateActions(plateNumberItem, vehiclePermissions).length || qrStickersOn">
+                        <v-menu v-if="vehiclePlateActions(plateNumberItem, vehiclePermissions).length || qrStickersOn || qrActionsOn(plateNumberItem)">
                           <template #activator="{ props: menuProps }">
                             <v-btn icon="mdi-dots-vertical" v-bind="menuProps" flat size="x-small" />
                           </template>
                           <v-list density="compact">
                             <v-list-item v-if="qrStickersOn && (plateNumberItem as any).hasQrSticker" title="Print sticker again" prepend-icon="mdi-printer"
                               data-test="vehicle-qr-print-again" @click="openStickerDialog([String((plateNumberItem as any)._id)])" />
-                            <v-list-item v-if="qrStickersOn" title="Re-issue sticker (lost or stolen)" prepend-icon="mdi-qrcode-edit"
+                            <v-list-item v-if="qrActionsOn(plateNumberItem)" title="Re-issue sticker (lost or stolen)" prepend-icon="mdi-qrcode-edit"
                               @click="askReissue((plateNumberItem as any) as TPlateNumber)" />
-                            <v-list-item v-if="qrStickersOn" title="Undo re-issue" prepend-icon="mdi-undo"
+                            <v-list-item v-if="qrActionsOn(plateNumberItem)" title="Undo re-issue" prepend-icon="mdi-undo"
                               data-test="vehicle-qr-undo" @click="askUndo((plateNumberItem as any) as TPlateNumber)" />
-                            <v-list-item v-if="qrStickersOn" title="Link QR sticker" prepend-icon="mdi-link-variant"
+                            <v-list-item v-if="qrActionsOn(plateNumberItem)" title="Link QR sticker" prepend-icon="mdi-link-variant"
                               @click="askLink(plateNumberItem as TPlateNumber)" />
-                            <v-list-item v-if="qrStickersOn" title="Remove QR sticker" prepend-icon="mdi-link-variant-off"
+                            <v-list-item v-if="qrActionsOn(plateNumberItem)" title="Remove QR sticker" prepend-icon="mdi-link-variant-off"
                               @click="askUnlink(plateNumberItem as TPlateNumber)" />
                             <v-list-item
                               v-for="action in vehiclePlateActions(plateNumberItem, vehiclePermissions)"
@@ -296,7 +296,7 @@
         when the ANPR revoke could not be confirmed - the dialog stays open on
         that path so the operator can read it and retry.
       -->
-      <DialogDeleteConfirmation :loading="deletingVehicle" :message="deleteError" :no-permission="revoked.delete"
+      <DialogDeleteConfirmation :loading="deletingVehicle" :message="deleteError" :no-permission="revoked[rightFor('delete')]"
         :prompt-title="`Remove vehicle number ${selectedPlateNumberObject?.plateNumber} from this record? This revokes its ANPR access - it will no longer open the barrier. The resident and any other vehicle numbers on this record are not affected.`"
         @delete="submitDelete" @close="closeDeleteDialog" />
     </v-dialog>
@@ -314,19 +314,19 @@
     <!-- Like Delete, Restore says what it does at the barrier: a whitelist
          plate goes back on the allowed list and opens it again. -->
     <v-dialog v-model="dialog.restoreVehicle" persistent width="540">
-      <DialogReusablePrompt :loading="restoringVehicle" :message="actionError" message-error :no-permission="revoked.approve"
+      <DialogReusablePrompt :loading="restoringVehicle" :message="actionError" message-error :no-permission="revoked[restoreRight()]"
         :prompt-title="restorePrompt"
         @proceed="submitRestore" @close="closeActionDialog('restoreVehicle')" />
     </v-dialog>
     <!-- Block / Unblock say what happens on the cameras, because that is the
          part the operator cannot see from here. -->
     <v-dialog v-model="dialog.blockVehicle" persistent width="540">
-      <DialogReusablePrompt :loading="blockingVehicle" :message="actionError" message-error :no-permission="revoked.update"
+      <DialogReusablePrompt :loading="blockingVehicle" :message="actionError" message-error :no-permission="revoked[rightFor('update', true)]"
         :prompt-title="`Block vehicle ${selectedPlateNumberObject?.plateNumber}? It is added to every ANPR camera's blocklist and taken off the allowed list. Its status becomes Blocked and its category Block Listed.`"
         @proceed="submitBlock" @close="closeActionDialog('blockVehicle')" />
     </v-dialog>
     <v-dialog v-model="dialog.unblockVehicle" persistent width="540">
-      <DialogReusablePrompt :loading="unblockingVehicle" :message="actionError" message-error :no-permission="revoked.update"
+      <DialogReusablePrompt :loading="unblockingVehicle" :message="actionError" message-error :no-permission="revoked[rightFor('update', true)]"
         :prompt-title="`Unblock vehicle ${selectedPlateNumberObject?.plateNumber}? It is taken off every ANPR camera's blocklist. It is NOT whitelisted - the record stays with status Unblocked.`"
         @proceed="submitUnblock" @close="closeActionDialog('unblockVehicle')" />
     </v-dialog>
@@ -590,6 +590,14 @@ const vehicleTabs = computed<{ name: string; value: TVehicleTab }[]>(() => [
 ])
 const activeTab = ref<TVehicleTab>("residents");
 
+/**
+ * Adding to the Block Listed tab follows Manage Blocklist alone (owner,
+ * 2026-10-23), not Add Vehicle: a role with only that box still gets the Add
+ * Vehicle button, offering the Blocklist form only. Apps that do not pass the
+ * flag (undefined) keep today's rule - the button follows Add Vehicle.
+ */
+const canAddBlocklist = computed(() => props.canManageBlocklist === true);
+
 
 
 const { formatCamelCaseToWords, formatDate, debounce, maskNRIC } = useUtils();
@@ -605,6 +613,28 @@ const qrStickerFilterItems = [
   { title: "Without sticker", value: "without" },
 ];
 const qrStickersOn = computed(() => qrEnabled.value && props.canUpdateVehicle);
+
+/**
+ * Re-issue / Undo / Link / Remove on one plate change that vehicle, so on a
+ * Block Listed plate they follow Manage Blocklist (owner, 2026-10-23) when the
+ * host passes it; any other plate follows Update Vehicle. Printing stays with
+ * `qrStickersOn`.
+ */
+/** Sync on a Block Listed plate follows Manage Blocklist when the host passes it. */
+function syncAllowed(plate: any): boolean {
+  if (props.canManageBlocklist !== undefined && plate?.type === "blocklist") {
+    return !!vehiclePermissions.value.canManageBlocklist;
+  }
+  return true;
+}
+
+function qrActionsOn(plate: any): boolean {
+  if (!qrEnabled.value) return false;
+  if (props.canManageBlocklist !== undefined && plate?.type === "blocklist") {
+    return !!vehiclePermissions.value.canManageBlocklist;
+  }
+  return props.canUpdateVehicle;
+}
 const qrVehicleIds = ref<string[]>([]);
 const qrReissuePlate = ref<TPlateNumber | null>(null);
 const qrReissuing = ref(false);
@@ -635,7 +665,8 @@ const qrCodeToLink = computed(() => String(qrLinkCode.value || qrSearch.value ||
 
 // Saved blank codes still free to link + the site's printed / linked / available count.
 async function loadQrAvailable(search = "") {
-  if (!qrStickersOn.value) return;
+  // The Link dialog lists the blanks for whoever may link this plate.
+  if (!qrStickersOn.value && !(dialog.qrLink && qrActionsOn(qrPlate.value))) return;
   try {
     const res = await getAvailableBlankVehicleQr(props.site, { search, limit: 50 });
     qrSummary.value = res?.summary ?? null;
@@ -1139,7 +1170,10 @@ const vehiclePermissions = computed(() => ({
   canUpdateVehicle: props.canUpdateVehicle && !revoked.update,
   canDeleteVehicle: props.canDeleteVehicle && !revoked.delete,
   canApproveVehicle: props.canApproveVehicle && !revoked.approve,
-  canManageBlocklist: props.canManageBlocklist,
+  canManageBlocklist:
+    props.canManageBlocklist === undefined
+      ? undefined
+      : props.canManageBlocklist && !revoked.blocklist,
 }));
 
 /**
@@ -1153,8 +1187,26 @@ const vehiclePermissions = computed(() => ({
  * the local override is dropped and the host's answer stands again - so a
  * right given back is not kept hidden.
  */
-const revoked = reactive({ update: false, delete: false, approve: false });
+const revoked = reactive({ update: false, delete: false, approve: false, blocklist: false });
 watch(() => props.canUpdateVehicle, () => { revoked.update = false; });
+watch(() => props.canManageBlocklist, () => { revoked.blocklist = false; });
+
+/**
+ * Which right an action on the selected plate stands on. With Manage Blocklist
+ * passed by the host, Block / Unblock - and Edit / Delete on a Block Listed
+ * plate - are that right, so a refusal there takes only those off the menus.
+ */
+/** Restore on a Block Listed plate is a blocklist write; any other stays Approve. */
+function restoreRight(): keyof typeof revoked {
+  if (props.canManageBlocklist === undefined) return "approve";
+  return selectedPlateNumberObject.value?.type === "blocklist" ? "blocklist" : "approve";
+}
+
+function rightFor(base: "update" | "delete", blockAction = false): keyof typeof revoked {
+  if (props.canManageBlocklist === undefined) return base;
+  if (blockAction || selectedPlateNumberObject.value?.type === "blocklist") return "blocklist";
+  return base;
+}
 watch(() => props.canDeleteVehicle, () => { revoked.delete = false; });
 watch(() => props.canApproveVehicle, () => { revoked.approve = false; });
 
@@ -1167,6 +1219,7 @@ const NO_PERMISSION: Record<keyof typeof revoked, string> = {
   update: "You do not have permission to edit vehicles.",
   delete: "You do not have permission to delete vehicles.",
   approve: "You do not have permission to approve vehicles.",
+  blocklist: "You do not have permission to manage the block list.",
 };
 
 /**
@@ -1176,7 +1229,7 @@ const NO_PERMISSION: Record<keyof typeof revoked, string> = {
  */
 /** The add/edit form was refused: an edit refusal takes Edit/Block/Unblock off. */
 function handleFormRefused(kind: "create" | "update") {
-  if (kind === "update") revoked.update = true;
+  if (kind === "update") revoked[rightFor("update")] = true;
 }
 
 function refusedAlready(right: keyof typeof revoked, target: typeof actionError) {
@@ -1266,7 +1319,7 @@ const formatPlateNumbers = (value: any) => {
 };
 
 async function submitDelete() {
-  if (refusedAlready("delete", deleteError)) return;
+  if (refusedAlready(rightFor("delete"), deleteError)) return;
 
   const plateNumberId = selectedPlateNumberObject.value?._id;
   const type = selectedPlateNumberObject.value?.type as TVehicleType;
@@ -1292,7 +1345,7 @@ async function submitDelete() {
     // error - so a refused delete showed the operator nothing at all.
     deleteError.value = errorConverter(error);
     // Refused for want of the right: take Delete off both menus now.
-    revokeOnRefusal(error, "delete");
+    revokeOnRefusal(error, rightFor("delete"));
     // The dialog stays open and the row stays in the table - nothing is removed
     // optimistically, so what is on screen still matches the database.
   } finally {
@@ -1328,7 +1381,7 @@ const restorePrompt = computed(() => {
 });
 
 async function submitRestore() {
-  if (refusedAlready("approve", actionError)) return;
+  if (refusedAlready(restoreRight(), actionError)) return;
 
   const vehicleId = selectedPlateNumberObject.value?._id;
 
@@ -1349,7 +1402,7 @@ async function submitRestore() {
   } catch (error: any) {
     actionError.value = errorConverter(error);
     // Restore is the approve endpoint: a refusal is the Approve right gone.
-    revokeOnRefusal(error, "approve");
+    revokeOnRefusal(error, restoreRight());
   } finally {
     restoringVehicle.value = false;
   }
@@ -1357,7 +1410,7 @@ async function submitRestore() {
 
 
 async function submitBlock() {
-  if (refusedAlready("update", actionError)) return;
+  if (refusedAlready(rightFor("update", true), actionError)) return;
   const vehicleId = selectedPlateNumberObject.value?._id;
   if (!vehicleId) {
     showMessage("Invalid vehicle selected for blocking.", "error");
@@ -1373,7 +1426,7 @@ async function submitBlock() {
     await getVehiclesRefresh();
   } catch (error: any) {
     actionError.value = errorConverter(error);
-    revokeOnRefusal(error, "update");
+    revokeOnRefusal(error, rightFor("update", true));
   } finally {
     blockingVehicle.value = false;
   }
@@ -1381,7 +1434,7 @@ async function submitBlock() {
 
 
 async function submitUnblock() {
-  if (refusedAlready("update", actionError)) return;
+  if (refusedAlready(rightFor("update", true), actionError)) return;
   const vehicleId = selectedPlateNumberObject.value?._id;
   if (!vehicleId) {
     showMessage("Invalid vehicle selected for unblocking.", "error");
@@ -1397,7 +1450,7 @@ async function submitUnblock() {
     await getVehiclesRefresh();
   } catch (error: any) {
     actionError.value = errorConverter(error);
-    revokeOnRefusal(error, "update");
+    revokeOnRefusal(error, rightFor("update", true));
   } finally {
     unblockingVehicle.value = false;
   }

package/components/VisitorDataFromScannedQRCodeForm.vue

@@ -202,7 +202,7 @@
       <AppButton
         v-if="!visitorInfo.checkIn && !visitorInfo.checkOut"
         :disabled="processing"
-        @click="emit('check-in-out', 'checkIn', visitorInfo)"
+        @click="checkIn"
       >
         Check In
       </AppButton>
@@ -240,6 +240,11 @@ const { standardFormatDateTime } = useUtils();
 
 const visitorInfo = ref<Partial<TVisitor>>({});
 
+// The list adds the user's default ANPR gate when it checks the guest in.
+function checkIn() {
+  emit("check-in-out", "checkIn", visitorInfo.value);
+}
+
 watch(
   () => prop.visitorData,
   (visitorData) => {

package/components/VisitorForm.vue

@@ -845,6 +845,8 @@ import useHidAmico from "../composables/useHidAmico";
 import { hidQrUsageFromSettings, minutesUntilEndOfDay } from "../utils/hid-qr-validity";
 import useFile from "../composables/useFile";
 import usePassKey from "../composables/usePassKey";
+import { defaultGateForSite } from "../utils/visitor-camera";
+import { barrierCameraOf, barrierOf, type TBarrierOutcome } from "../utils/visitor-barrier";
 import VisitorPassKeyQRScanner from "./VisitorPassKeyQRScanner.vue";
 import {
   DELETE_PERSON_TITLE,
@@ -980,6 +982,18 @@ const hidQrVisitorId = ref("");
 const hidQrNow = ref(Date.now());
 let hidQrTimer: ReturnType<typeof setInterval> | null = null;
 const hidQrPendingCompletion = ref<"done" | "done:more" | null>(null);
+/**
+ * What this save was and whether it opened the ANPR barrier, sent with
+ * `done` / `done:more` for the list's message (owner, 2026-10-23).
+ */
+const saveResult = ref<{
+  action: "add" | "register" | "edit";
+  barrier?: TBarrierOutcome;
+  /** The camera the barrier is at, "Entry Gate 1". */
+  barrierCamera?: string;
+}>({
+  action: "add",
+});
 const hidQrPreview = reactive({
   imageUrl: "",
   issuedAt: "",
@@ -1100,6 +1114,16 @@ const formMode = computed<"add" | "edit" | "register">(() => {
   return selectedUnregisteredVisitor.value ? "register" : prop.mode;
 });
 
+/*
+ * The user's default ANPR gate at this site (owner, 2026-10-23), picked on the
+ * visitor list: sent with an add or a register (an edit opens nothing) so that
+ * camera is checked for a blocked plate and opens the barrier. None picked:
+ * not sent, and the server uses the site's first camera.
+ */
+const defaultCameraGate = computed(() =>
+  defaultGateForSite((currentUser.value as any)?.defaultCameraGate, prop.site)
+);
+
 // Fields this form actually has for the visitor type - drives both what is
 // shown and what is sent on submit, so nothing outside the form is saved.
 // typeFieldMap also feeds the details dialog, so it can list more than this:
@@ -2821,9 +2845,6 @@ const CLEARABLE_ON_UPDATE = [
   "attachments",
 ];
 const OBJECT_ID = /^[a-f0-9]{24}$/i;
-// Users who record a visit they are not witnessing: their visit opens with no
-// check-in / check-out (isecure365 `backOffice`).
-const BACK_OFFICE_USER_TYPES = /^(service-provider|service-provider-member|site)$/i;
 
 // The site's delivery company list (and the typed name snapped to the
 // listed spelling, "grabfood" -> "GrabFood").
@@ -3009,16 +3030,10 @@ function buildPayload(isUpdate: boolean): Record<string, unknown> {
 
   payload.org = prop.org;
   if (userId) payload.createdBy = userId;
-  // Registering a visitor at the guardhouse IS their arrival: checked in as it
-  // is created. A back-office user's visit opens with no times at all.
-  const userType = currentUser.value?.type ?? "";
-  if (BACK_OFFICE_USER_TYPES.test(userType)) {
-    payload.clientUserType = userType;
-    payload.checkIn = null;
-    payload.checkOut = null;
-  } else {
-    payload.checkIn = new Date().toISOString();
-  }
+  // Adding a visitor IS their check-in, whoever adds them - a guard or a
+  // property management user (owner, 2026-10-26). No user type is sent: core
+  // does not take one and refuses it ("clientUserType" is not allowed).
+  payload.checkIn = new Date().toISOString();
   return payload;
 }
 
@@ -3161,6 +3176,16 @@ async function submit(options: { skipNonCheckedOutCheck?: boolean } = {}) {
     }
   }
   const payload = buildPayload(isUpdate);
+  // The camera chosen at the bottom of the form (not stored on the visit).
+  if (
+    (formMode.value === "add" || formMode.value === "register") &&
+    defaultCameraGate.value &&
+    payload.plateNumber
+  ) {
+    payload.anprGate = defaultCameraGate.value;
+  }
+  // A new visit replies `{ _id, barrier }`: whether the barrier opened.
+  if (!isUpdate) payload.reportBarrier = true;
 
   try {
     const res = isUpdate
@@ -3181,6 +3206,11 @@ async function submit(options: { skipNonCheckedOutCheck?: boolean } = {}) {
     }
 
     const visitorId = isUpdate ? recordId : getVisitorIdFromResponse(res);
+    saveResult.value = {
+      action: !isUpdate ? "add" : formMode.value === "register" ? "register" : "edit",
+      barrier: barrierOf(res),
+      barrierCamera: barrierCameraOf(res),
+    };
 
     if (passType.value === "HID_QR") {
       const previewReady = await prepareHidQrCodePreview(visitorId);
@@ -3200,8 +3230,8 @@ async function submit(options: { skipNonCheckedOutCheck?: boolean } = {}) {
     }
 
     if (createMore.value) {
-      emit("done:more");
-    } else emit("done");
+      emit("done:more", saveResult.value);
+    } else emit("done", saveResult.value);
   } catch (error: any) {
     const err = error?.data?.message || error?.response?._data?.message;
     errorMessage.value =
@@ -3495,8 +3525,8 @@ function closeHidQrPreview() {
   hidQrPreviewDialog.value = false;
   const completion = hidQrPendingCompletion.value;
   hidQrPendingCompletion.value = null;
-  if (completion === "done:more") emit("done:more");
-  else if (completion === "done") emit("done");
+  if (completion === "done:more") emit("done:more", saveResult.value);
+  else if (completion === "done") emit("done", saveResult.value);
 }
 
 watch(

package/components/VisitorManagement.vue

@@ -57,6 +57,26 @@
       show-header
       @row-click="handleRowClick"
     >
+      <!-- The default ANPR camera (owner, 2026-10-23): only when the site has
+           more than one active Entry / Both / Visitors camera. Add, register
+           and guest check-in use it. -->
+      <template #pagination-prepend>
+        <v-btn
+          v-if="anprCameraCount > 1"
+          icon
+          density="comfortable"
+          variant="text"
+          :color="defaultCameraGate ? 'primary' : undefined"
+          :aria-label="'Default ANPR camera'"
+          data-test="visitor-default-camera"
+          @click="openDefaultCamera"
+        >
+          <v-icon>mdi-cctv</v-icon>
+          <v-tooltip activator="parent" location="top">
+            {{ defaultCameraGateLabel }}
+          </v-tooltip>
+        </v-btn>
+      </template>
       <template #extension>
         <v-row no-gutters class="w-100 d-flex flex-column">
           <v-tabs
@@ -1813,7 +1833,44 @@
       </v-card>
     </v-dialog>
 
-    <Snackbar v-model="messageSnackbar" :text="message" :color="messageColor" />
+    <v-dialog v-model="dialog.defaultCamera" width="450" persistent>
+      <v-card class="screen-modal" width="100%" :loading="savingDefaultCamera">
+        <v-card-title>{{ VISITOR_CAMERA_LABEL }}</v-card-title>
+        <v-card-text>
+          <p class="mb-4 text-body-2">
+            Add, register and guest check-in use this camera: it is checked for a
+            blocked vehicle and opens the barrier. None chosen: the site's first camera.
+          </p>
+          <v-select
+            v-if="anprGateChoices.length"
+            v-model="pickedDefaultGate"
+            :items="anprGateChoices"
+            item-title="title"
+            item-value="value"
+            density="comfortable"
+            clearable
+            placeholder="None (the site's first camera)"
+            data-test="visitor-default-camera-select"
+          />
+          <p v-else class="text-body-2 text-medium-emphasis">
+            No ANPR camera at this site has a gate yet. Set the gates in Settings first.
+          </p>
+          <p v-if="defaultCameraError" class="text-error text-body-2 mt-2">{{ defaultCameraError }}</p>
+        </v-card-text>
+        <v-card-actions>
+          <v-spacer />
+          <AppButton variant="ghost" :disabled="savingDefaultCamera" @click="dialog.defaultCamera = false">
+            Cancel
+          </AppButton>
+          <AppButton :disabled="savingDefaultCamera" data-test="visitor-default-camera-submit" @click="submitDefaultCamera">
+            Submit
+          </AppButton>
+        </v-card-actions>
+      </v-card>
+    </v-dialog>
+
+    <Snackbar v-model="messageSnackbar" :text="message" :color="messageColor"
+      :detail="messageDetail.text" :detail-tone="messageDetail.tone" />
   </v-row>
 </template>
 
@@ -1822,6 +1879,9 @@ import type { PropType } from "vue";
 import moment from "moment-timezone";
 import QRCode from "qrcode";
 import { isVisitorPassSmsOn } from "../composables/useVisitor";
+import { barrierCameraOf, barrierMessage, barrierOf, VISITOR_ACTION_SUCCESS } from "../utils/visitor-barrier";
+import useVisitorCameraChoices from "../composables/useVisitorCameraChoices";
+import { VISITOR_CAMERA_LABEL } from "../utils/visitor-camera";
 import usePassKey from "../composables/usePassKey";
 import {
   VISITOR_SEARCH_DEBOUNCE_MS,
@@ -2207,6 +2267,45 @@ const mode = ref<"add" | "edit" | "register">("add");
 const message = ref("");
 const messageColor = ref("");
 const messageSnackbar = ref(false);
+
+/* The default ANPR camera (gate) for add / register / guest check-in. */
+const {
+  count: anprCameraCount,
+  choices: anprGateChoices,
+  defaultGate: defaultCameraGate,
+  saveDefaultGate,
+} = useVisitorCameraChoices(() => siteId);
+const pickedDefaultGate = ref<number | null>(null);
+const savingDefaultCamera = ref(false);
+const defaultCameraError = ref("");
+const defaultCameraGateLabel = computed(() => {
+  const gate = defaultCameraGate.value;
+  if (!gate) return "Default ANPR camera: the site's first camera";
+  const choice = anprGateChoices.value.find((item) => item.value === gate);
+  return `Default ANPR camera: ${choice?.title ?? `Gate ${gate}`}`;
+});
+
+function openDefaultCamera() {
+  pickedDefaultGate.value = defaultCameraGate.value ?? null;
+  defaultCameraError.value = "";
+  dialog.defaultCamera = true;
+}
+
+async function submitDefaultCamera() {
+  savingDefaultCamera.value = true;
+  defaultCameraError.value = "";
+  try {
+    const res = await saveDefaultGate(pickedDefaultGate.value || null);
+    dialog.defaultCamera = false;
+    showMessage(res?.message || "Saved.", "success");
+  } catch (error) {
+    defaultCameraError.value = errorConverter(error);
+  } finally {
+    savingDefaultCamera.value = false;
+  }
+}
+// The toast's second line: whether the barrier opened.
+const messageDetail = ref<{ text: string; tone: "default" | "error" }>({ text: "", tone: "default" });
 /** Why the list could not be loaded (shown in the empty table). */
 const visitorListError = ref("");
 
@@ -2257,6 +2356,7 @@ const dialog = reactive({
   showSelection: false,
   showForm: false,
   viewVisitor: false,
+  defaultCamera: false,
   snapshotImage: false,
   remarks: false,
   returnPassesKeys: false,
@@ -3153,8 +3253,13 @@ async function handleVisitorDataFromScannedQRCodeCheckInOut(
         ? visitorData.visitorPass
         : [];
 
-      await visitorDataFromScannedQRCodeCheckIn({
+      const checkInReply: any = await visitorDataFromScannedQRCodeCheckIn({
         type,
+        // The user's default ANPR gate at this site: checked for a blocked
+        // plate, opens the barrier. None: the site's first camera.
+        ...(defaultCameraGate.value && String(visitorData.plateNumber ?? "").trim()
+          ? { anprGate: defaultCameraGate.value }
+          : {}),
         filter: {
           _id: visitorId,
           site: visitorData.site ?? siteId,
@@ -3171,7 +3276,13 @@ async function handleVisitorDataFromScannedQRCodeCheckInOut(
         },
         userType: "site",
       });
-      showMessage("Visitor successfully checked-in!", "info");
+      // "Check In Visitor Success." and whether the barrier opened.
+      showMessage(
+        VISITOR_ACTION_SUCCESS.checkIn,
+        "success",
+        barrierOf(checkInReply),
+        barrierCameraOf(checkInReply),
+      );
     } else {
       selectedVisitorId.value = visitorData._id;
       await proceedCheckout();
@@ -3390,23 +3501,49 @@ function handleClickBack() {
 /** iSecure's toast after an add, an update or a register. */
 const VISITOR_SAVED_MESSAGE = "Great! A new visitor has been successfully added.";
 
-function handleVisitorFormDone() {
-  showMessage(VISITOR_SAVED_MESSAGE, "success");
+/*
+ * After a save (owner, 2026-10-23): "Add Visitor Success." / "Register Visitor
+ * Success." and, when the barrier was asked to open, "Opening Barrier
+ * Success." or "Opening Barrier Failed." (red). An edit keeps its message.
+ */
+type TVisitorFormResult = {
+  action?: "add" | "register" | "edit";
+  barrier?: "opened" | "failed";
+  /** The camera the barrier is at, "Entry Gate 1". */
+  barrierCamera?: string;
+};
+
+function visitorSavedMessage(result?: TVisitorFormResult) {
+  if (result?.action === "add") return VISITOR_ACTION_SUCCESS.add;
+  if (result?.action === "register") return VISITOR_ACTION_SUCCESS.register;
+  return VISITOR_SAVED_MESSAGE;
+}
+
+function handleVisitorFormDone(result?: TVisitorFormResult) {
+  showMessage(visitorSavedMessage(result), "success", result?.barrier, result?.barrierCamera);
   getVisitorRefresh();
   dialog.showSelection = false;
   dialog.showForm = false;
 }
 
-function handleVisitorFormCreateMore() {
-  showMessage(VISITOR_SAVED_MESSAGE, "success");
+function handleVisitorFormCreateMore(result?: TVisitorFormResult) {
+  showMessage(visitorSavedMessage(result), "success", result?.barrier, result?.barrierCamera);
   getVisitorRefresh();
   dialog.showSelection = true;
   dialog.showForm = false;
 }
 
-function showMessage(msg: string, color: string) {
+function showMessage(
+  msg: string,
+  color: string,
+  barrier?: "opened" | "failed",
+  barrierCamera?: string,
+) {
   message.value = msg;
   messageColor.value = color;
+  messageDetail.value = barrier
+    ? { text: barrierMessage(barrier, barrierCamera), tone: barrier === "failed" ? "error" : "default" }
+    : { text: "", tone: "default" };
   messageSnackbar.value = true;
 }