@7365admin1/layer-common 4.124.2 → 4.125.0

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # @iservice365/layer-common
 
+## 4.125.0
+
+### Minor Changes
+
+- 9accfa7: Robotics setup (Super Admin): Floor names panel (lift display names, which robot floor is which floor, preview before save, undo) and a HERO Fleet Core card per site (on/off, short name, robots, relay key shown once). Robot screens show the site's floor name when the server sends one; the Setup floor step uses the site floor.
+
+## 4.124.3
+
+### Patch Changes
+
+- 2279860: Robot screens fit a 390px phone (header, map pickers, schedule rows, saved-points hint, 3D map readout wrap instead of running off screen). Robot setup now reports "Setup x/N" to its host so the Super Admin drill-down can show it beside the site views.
+
 ## 4.124.2
 
 ### Patch Changes
@@ -3276,11 +3288,11 @@ Monthly report: a month that had patrols opens the list of that month's patrol r
   `utils/console-tier.ts` + `composables/useConsoleTier.ts` mirror the server's
   own rule from two endpoints the console already calls, unprojected:
 
-                                                                                                                                                                                                                                                                                                                                                                                                                                                  GET /api/members/user/:user/app/admin    the Seven365 staff membership
-                                                                                                                                                                                                                                                                                                                                                                                                                                                  GET /api/roles/id/:role                  that membership's role document
+                                                                                                                                                                                                                                                                                                                                                                                                                                                      GET /api/members/user/:user/app/admin    the Seven365 staff membership
+                                                                                                                                                                                                                                                                                                                                                                                                                                                      GET /api/roles/id/:role                  that membership's role document
 
-                                                                                                                                                                                                                                                                                                                                                                                                                                                  owner  = member.type === "admin" && role.type === "admin" && role.default === true
-                                                                                                                                                                                                                                                                                                                                                                                                                                                  staff  = member.type === "admin" && role.type === "admin"
+                                                                                                                                                                                                                                                                                                                                                                                                                                                      owner  = member.type === "admin" && role.type === "admin" && role.default === true
+                                                                                                                                                                                                                                                                                                                                                                                                                                                      staff  = member.type === "admin" && role.type === "admin"
 
   `role.default` is the marker because it is the only property of a platform
   staff role no API caller can set - `role.controller.ts` validates create and

package/assets/css/robot-hero.css

@@ -524,6 +524,7 @@
 /* Asides: Needs attention, Clients drill down. */
 .hero-aside__head {
   display: flex;
+  flex-wrap: wrap;
   align-items: baseline;
   gap: 8px;
   border-top: 2px solid var(--hero-divider);
@@ -531,7 +532,7 @@
   margin-bottom: 8px;
 }
 .hero-aside__title { font-size: 12px; letter-spacing: 0.12em; text-transform: uppercase; white-space: nowrap; font-weight: 600; }
-.hero-aside__hint { opacity: 0.6; font-size: 12px; }
+.hero-aside__hint { opacity: 0.6; font-size: 12px; overflow-wrap: anywhere; min-width: 0; }
 .hero-aside__count { margin-left: auto; font-size: 12px; padding: 1px 7px; background: var(--hero-accent); color: #fff; font-weight: 600; }
 .hero-aside__empty { opacity: 0.6; padding: 10px 0; }
 .hero-attn { display: flex; flex-direction: column; gap: 1px; background: var(--hero-divider); }
@@ -610,7 +611,7 @@
 .hero-brand__name { font-family: var(--hero-font); font-weight: 800; font-size: 17px; letter-spacing: 0.06em; line-height: 1; }
 .hero-brand__org { font-size: 12px; letter-spacing: 0.1em; text-transform: uppercase; opacity: 0.6; margin-top: 3px; white-space: nowrap; }
 .hero-header__site { display: flex; align-items: center; gap: 8px; }
-.hero-header__right { display: flex; align-items: center; gap: 12px; margin-left: auto; }
+.hero-header__right { display: flex; flex-wrap: wrap; align-items: center; gap: 8px 12px; margin-left: auto; min-width: 0; max-width: 100%; }
 
 /* Cleaning | Security: selected = accent fill, white text. */
 .hero-switch { display: flex; border: 1px solid var(--hero-divider); }
@@ -763,7 +764,8 @@
 
 .hero-mini { display: flex; flex-direction: column; gap: 10px; min-width: 0; }
 .hero-seen { opacity: 0.65; }
-.hero-mini__head { display: flex; align-items: center; gap: 8px; border-top: 2px solid var(--hero-divider); padding-top: 8px; }
+.hero-mini__head { display: flex; flex-wrap: wrap; align-items: center; gap: 8px; border-top: 2px solid var(--hero-divider); padding-top: 8px; }
+.hero-mini__head select { min-width: 0; max-width: 100%; }
 .hero-mini__foot { font-size: 12px; opacity: 0.6; display: flex; gap: 12px; white-space: nowrap; }
 .hero-mini__foot > span:first-child { overflow: hidden; text-overflow: ellipsis; }
 .hero-mini__legend { display: inline-block; width: 12px; height: 0; border-top: 2px dashed var(--hero-accent); vertical-align: middle; margin-right: 5px; }
@@ -858,6 +860,7 @@
 .hero-sched__row { display: grid; grid-template-columns: 90px 100px 1fr; gap: 10px; padding: 8px 0; border-bottom: 1px solid var(--hero-divider); font-size: 14px; }
 .hero-sched__row > span:nth-child(2) { font-variant-numeric: tabular-nums; }
 .hero-sched__row > span:nth-child(3) { opacity: 0.8; }
+.hero-sched__row > span { min-width: 0; overflow-wrap: anywhere; }
 
 /* Detail plan: trail, crosshair, readout, radar, robot, spot points. */
 .hero-trail { position: absolute; width: 6px; height: 6px; margin: -3px; background: var(--hero-accent); }
@@ -1280,6 +1283,7 @@ div.hero-editor__wp.hero-editor__sel, div.hero-editor__fid.hero-editor__sel { ou
   .hero-lift { grid-template-columns: 1fr; }
   .hero-bmap__bar { right: 14px; }
   .hero-bmap__live { display: none; }
+  .hero-bmap__readout { white-space: normal; }
 }
 
 @keyframes heroScan { from { background-position: 0 -60px; } to { background-position: 0 120%; } }

package/components/Robot/AlertsTable.vue

@@ -59,7 +59,7 @@ const emit = defineEmits<{ "update:page": [page: number]; open: [item: any] }>()
 
 function floorOf(item: any) {
   const s = props.states[String(item?.robot?._id ?? "")];
-  return s?.ok ? { floorNo: s.floorNo, floorKnown: s.floorKnown === true } : { floorNo: null, floorKnown: false };
+  return s?.ok ? { floorNo: s.floorNo, floorKnown: s.floorKnown === true, floorName: s.floorName ?? null } : { floorNo: null, floorKnown: false };
 }
 /** The robot's photos for this alert, when its live fault is this one and carries them. */
 function photosOf(item: any) {

package/components/Robot/Card.vue

@@ -12,7 +12,7 @@
       <div class="hero-card__name">{{ name }}</div>
       <div class="hero-card__sub">
         <template v-if="brandName">{{ brandName }} · </template>
-        <RobotFloorLabel :floor-no="state?.floorNo" :floor-known="state?.floorKnown" />
+        <RobotFloorLabel :floor-no="state?.floorNo" :floor-known="state?.floorKnown" :floor-name="state?.floorName" />
       </div>
     </div>
     <RobotStatusChip :mode="state?.mode" :type="type" />

package/components/Robot/FloorLabel.vue

@@ -6,7 +6,8 @@
 import { computed } from "vue";
 import { floorLabel } from "../../utils/robot-display";
 
-const props = defineProps<{ floorNo?: unknown; floorKnown?: boolean }>();
-const label = computed(() => floorLabel({ floorNo: props.floorNo, floorKnown: props.floorKnown }));
+// floorName: the site's name for the floor (lift display), from the server - shown instead of "L3" when present.
+const props = defineProps<{ floorNo?: unknown; floorKnown?: boolean; floorName?: string | null }>();
+const label = computed(() => floorLabel({ floorNo: props.floorNo, floorKnown: props.floorKnown, floorName: props.floorName }));
 const unknown = computed(() => label.value === "Floor unknown");
 </script>

package/components/Robot/Setup.vue

@@ -49,11 +49,19 @@
       </span>
     </li>
   </ol>
+
+  <!-- Super Admin set-up that lives on this page: floor names (lift display) and the site's HERO Fleet Core record. -->
+  <div ref="floorsEl">
+    <RobotSiteFloors :site="site" :robots="all" :states="states as Record<string, Record<string, any>>" :map-floors="mapFloors" @saved="floorsSaved" />
+  </div>
+  <RobotSiteFleetCore :site="site" />
 </template>
 
 <script setup lang="ts">
 import { computed, ref, toRef, watch } from "vue";
 import RobotFleetCoreButton from "./FleetCoreButton.vue";
+import RobotSiteFloors from "./SiteFloors.vue";
+import RobotSiteFleetCore from "./SiteFleetCore.vue";
 import useRobotBuilding from "../../composables/useRobotBuilding";
 import useRobotLive, { siteStatesFeed } from "../../composables/useRobotLive";
 import { robotSetupSteps, setupProgress, STATUS_TEXT, type TSetupStatus, type TSetupTarget } from "../../utils/robot-setup";
@@ -72,6 +80,8 @@ const emit = defineEmits<{
   /** A step's button: a site view (fleet / map / lifts), the client's details, or Add robot. */
   go: [target: TSetupTarget];
   network: [];
+  /** "Setup 5/8" once worked out, so the host can show it beside its site views. */
+  progress: [progress: { done: number; total: number }];
 }>();
 
 const TONE: Record<TSetupStatus, string> = { done: "success", action: "warning", waiting: "info", check: "neutral" };
@@ -143,14 +153,28 @@ const steps = computed(() =>
     lifts: lifts.value,
     fleetCore: fleetCore.value,
     roles: roles.value,
+    siteFloors: siteFloors.value,
   }),
 );
 const progress = computed(() => setupProgress(steps.value));
+watch([loaded, progress], () => loaded.value && emit("progress", progress.value), { immediate: true });
 const next = computed(() => (loaded.value ? steps.value.find((s) => !s.optional && s.key !== "ready" && s.status !== "done") ?? null : null));
 
 function go(target: TSetupTarget) {
+  if (target === "floors") return void floorsEl.value?.scrollIntoView({ behavior: "smooth", block: "start" });
   if (target) emit("go", target);
 }
+
+// Floor names: the list the panel loaded or saved; a save re-reads the robots so the checklist shows the new floors.
+const floorsEl = ref<HTMLElement | null>(null);
+const siteFloors = ref<Array<{ key: number; name: string }>>([]);
+const mapFloors = computed(() => [...new Set<number>(((saved.value?.levels ?? []) as any[]).map((l) => Number(l?.floorNo)).filter(Number.isInteger))]);
+let firstFloors = true;
+function floorsSaved(list: Array<{ key: number; name: string }>) {
+  siteFloors.value = list;
+  if (firstFloors) return void (firstFloors = false);
+  void refresh();
+}
 </script>
 
 <style scoped>

package/components/Robot/SiteFleet.vue

@@ -55,6 +55,7 @@
             v-if="live(item)?.ok || live(item)?.monitorable === false"
             :floor-no="live(item)?.floorNo"
             :floor-known="live(item)?.floorKnown === true"
+            :floor-name="live(item)?.floorName"
           />
         </template>
         <template #item.fault="{ item }">

package/components/Robot/SiteFleetCore.vue

@@ -0,0 +1,156 @@
+<template>
+  <!--
+    HERO FLEET CORE FOR THIS SITE (Seven365 Super Admin, owner 2026-10-15):
+    on/off, the site's short name on the one shared Fleet Core server, which
+    robots Fleet Core may use (the per-robot switch), and the site's own relay
+    key - shown once, like a lift gateway code. Server:
+    /api/robots/sites/:site/fleet-core.
+  -->
+  <section class="fcs" aria-labelledby="fcs-title">
+    <h3 id="fcs-title" class="hero-title fcs__title">HERO Fleet Core for this site</h3>
+    <div v-if="loadError" class="hero-notice hero-notice--error" role="alert">{{ loadError }}</div>
+    <template v-else-if="loaded">
+      <v-switch v-model="enabled" color="primary" density="compact" hide-details inset label="Use HERO Fleet Core at this site" />
+      <v-text-field
+        v-model="slug"
+        density="compact"
+        variant="outlined"
+        label="Short name on the shared server"
+        hint="2-10 lowercase letters or numbers, starting with a letter (e.g. oth)"
+        persistent-hint
+        maxlength="10"
+      />
+      <div class="hero-kicker">Robots HERO Fleet Core may use</div>
+      <v-checkbox
+        v-for="r in robots"
+        :key="r.id"
+        v-model="robotIds"
+        :value="r.id"
+        :label="r.name"
+        density="compact"
+        hide-details
+      />
+      <div v-if="!robots.length" class="hero-muted">No robots at this site yet.</div>
+      <div v-if="problem" class="hero-notice hero-notice--error" role="alert">{{ problem }}</div>
+      <div class="fcs__act">
+        <v-btn size="small" color="primary" variant="flat" :loading="busy === 'save'" :disabled="!!problem || !!busy" @click="save">Save</v-btn>
+        <v-btn
+          v-if="keyVersion !== null"
+          size="small"
+          variant="outlined"
+          :loading="busy === 'key'"
+          :disabled="!!busy || !relayKeysAvailable"
+          @click="createKey"
+        >
+          Create relay key
+        </v-btn>
+      </div>
+      <div v-if="keyVersion !== null && !relayKeysAvailable" class="hero-muted fcs__note">
+        Per-site relay keys are not switched on on the server yet. Fleet Core keeps using its current connection.
+      </div>
+      <div v-if="newKey" class="hero-notice hero-notice--panel" role="status">
+        <div class="hero-notice__title">Copy this key now - it is shown only once</div>
+        <code class="fcs__key">{{ newKey }}</code>
+        <div class="fcs__act">
+          <v-btn size="small" variant="outlined" @click="copy">{{ copied ? "Copied" : "Copy" }}</v-btn>
+        </div>
+        <div class="hero-notice__body hero-muted">Every older key for this site has stopped working.</div>
+      </div>
+      <div v-if="message" class="hero-muted" role="status">{{ message }}</div>
+      <div v-if="error" class="hero-notice hero-notice--error" role="alert">{{ error }}</div>
+    </template>
+    <div v-else class="hero-muted">Checking…</div>
+  </section>
+</template>
+
+<script setup lang="ts">
+import { computed, ref, watch } from "vue";
+import { robotErrorMessage } from "../../utils/robot-display";
+
+const props = defineProps<{ site: string }>();
+const { getSiteFleetCore, saveSiteFleetCore, createSiteRelayKey } = useRobots();
+
+const loaded = ref(false);
+const loadError = ref("");
+const error = ref("");
+const message = ref("");
+const busy = ref<"" | "save" | "key">("");
+const version = ref(0);
+const enabled = ref(false);
+const slug = ref("");
+const robotIds = ref<string[]>([]);
+const robots = ref<Array<{ id: string; name: string }>>([]);
+const keyVersion = ref<number | null>(null);
+const relayKeysAvailable = ref(false);
+const newKey = ref("");
+const copied = ref(false);
+
+async function load() {
+  loaded.value = false;
+  loadError.value = "";
+  try {
+    const res = await getSiteFleetCore(props.site);
+    version.value = res.version ?? 0;
+    robots.value = res.robots ?? [];
+    enabled.value = res.fleetCore?.enabled === true;
+    slug.value = res.fleetCore?.slug ?? "";
+    robotIds.value = [...(res.fleetCore?.robotIds ?? [])];
+    keyVersion.value = res.fleetCore ? res.fleetCore.keyVersion ?? 0 : null;
+    relayKeysAvailable.value = res.relayKeysAvailable === true;
+    loaded.value = true;
+  } catch (e) {
+    loadError.value = robotErrorMessage(e, "Could not read the HERO Fleet Core settings.");
+  }
+}
+watch(() => props.site, load, { immediate: true });
+
+const problem = computed(() => (/^[a-z][a-z0-9]{1,9}$/.test(slug.value.trim()) ? null : "Short name: 2-10 lowercase letters or numbers, starting with a letter."));
+
+async function save() {
+  error.value = message.value = "";
+  busy.value = "save";
+  try {
+    const res = await saveSiteFleetCore(props.site, { enabled: enabled.value, slug: slug.value.trim(), robotIds: robotIds.value, version: version.value });
+    version.value = res.version;
+    if (keyVersion.value === null) keyVersion.value = 0;
+    message.value = "Saved.";
+  } catch (e) {
+    error.value = robotErrorMessage(e, "Could not save the HERO Fleet Core settings.");
+  } finally {
+    busy.value = "";
+  }
+}
+
+async function createKey() {
+  error.value = message.value = "";
+  busy.value = "key";
+  copied.value = false;
+  try {
+    const res = await createSiteRelayKey(props.site);
+    newKey.value = res.key;
+    keyVersion.value = res.keyVersion;
+    version.value += 1;
+  } catch (e) {
+    error.value = robotErrorMessage(e, "Could not create a relay key.");
+  } finally {
+    busy.value = "";
+  }
+}
+
+async function copy() {
+  try {
+    await navigator.clipboard.writeText(newKey.value);
+    copied.value = true;
+  } catch {
+    copied.value = false;
+  }
+}
+</script>
+
+<style scoped>
+.fcs { margin-top: 16px; padding: 12px; background: var(--hero-surface); box-shadow: var(--hero-shadow-sm); display: grid; gap: 8px; }
+.fcs__title { font-size: 16px; }
+.fcs__act { display: flex; flex-wrap: wrap; gap: 6px; }
+.fcs__note { font-size: 12px; }
+.fcs__key { display: block; overflow-wrap: anywhere; font-size: 12px; padding: 6px; background: var(--hero-divider); }
+</style>

package/components/Robot/SiteFloors.vue

@@ -0,0 +1,220 @@
+<template>
+  <!--
+    FLOOR NAMES (Seven365 Super Admin, owner 2026-10-15): each floor is named
+    as the lift car display shows it, and each robot's own floor number is
+    linked to the floor it really is (the PadBot at OTH says "3" on the 34th
+    floor). Preview shows what every robot will read before anything is saved;
+    Undo puts the last list back. Server: /api/robots/sites/:site/floors.
+  -->
+  <section class="floors" aria-labelledby="floors-title">
+    <div class="floors__head">
+      <h3 id="floors-title" class="hero-title floors__title">Floor names</h3>
+      <span class="hero-muted">As the lift car display shows them</span>
+    </div>
+
+    <div v-if="loadError" class="hero-notice hero-notice--error" role="alert">{{ loadError }}</div>
+    <template v-else>
+      <div class="floors__rows" role="table" aria-label="Floors">
+        <div class="floors__row floors__row--head" role="row">
+          <span role="columnheader">Lift display</span>
+          <span role="columnheader">Map floor no.</span>
+          <span />
+        </div>
+        <div v-for="(f, i) in floors" :key="i" class="floors__row" role="row">
+          <v-text-field v-model="f.name" density="compact" hide-details variant="outlined" :aria-label="`Floor ${i + 1} lift display name`" maxlength="12" @update:model-value="changed" />
+          <v-text-field v-model.number="f.key" type="number" density="compact" hide-details variant="outlined" :aria-label="`Floor ${i + 1} map floor number`" @update:model-value="changed" />
+          <v-btn icon="mdi-close" size="small" variant="text" :aria-label="`Remove floor ${f.name}`" @click="remove(i)" />
+        </div>
+      </div>
+      <v-btn size="small" variant="text" prepend-icon="mdi-plus" @click="add">Add floor</v-btn>
+
+      <div v-if="robotRows.length" class="floors__robots">
+        <div class="hero-kicker">Which floor is each robot on?</div>
+        <div v-for="r in robotRows" :key="r.id" class="floors__robot">
+          <span class="floors__robot-name">{{ r.name }}</span>
+          <span class="hero-muted">{{ r.floorNo === null ? "not reporting a floor now" : `reports floor ${r.floorNo}` }}</span>
+          <v-select
+            v-if="r.floorNo !== null"
+            :model-value="r.key"
+            :items="pickItems"
+            density="compact"
+            hide-details
+            variant="outlined"
+            :aria-label="`${r.name} is on floor`"
+            class="floors__pick"
+            @update:model-value="(k) => pick(r.id, r.floorNo as number, k)"
+          />
+        </div>
+      </div>
+
+      <div v-if="problem" class="hero-notice hero-notice--error" role="alert">{{ problem }}</div>
+      <div class="floors__act">
+        <v-btn size="small" variant="outlined" :loading="busy === 'preview'" :disabled="!!problem || !!busy" @click="preview">Preview</v-btn>
+        <v-btn size="small" color="primary" variant="flat" :loading="busy === 'save'" :disabled="!!problem || !!busy || !previewed" @click="save">Save floor names</v-btn>
+        <v-btn v-if="canUndo" size="small" variant="text" :loading="busy === 'undo'" :disabled="!!busy" @click="undo">Undo last save</v-btn>
+      </div>
+      <div v-if="!previewed && !problem" class="hero-muted floors__hint">Preview first - nothing changes until you save.</div>
+
+      <div v-if="result" class="floors__result" role="status">
+        <div class="hero-notice__title">{{ result.title }}</div>
+        <table v-if="result.robots?.length" class="floors__table">
+          <thead><tr><th scope="col">Robot</th><th scope="col">Robot says</th><th scope="col">Shown now</th><th scope="col">After</th></tr></thead>
+          <tbody>
+            <tr v-for="r in result.robots" :key="r.id">
+              <td>{{ r.name }}</td>
+              <td>{{ r.robotFloor ?? "-" }}</td>
+              <td>{{ r.now ?? "-" }}</td>
+              <td :class="{ 'floors__diff': r.now !== r.after }">{{ r.after ?? "-" }}</td>
+            </tr>
+          </tbody>
+        </table>
+      </div>
+      <div v-if="error" class="hero-notice hero-notice--error" role="alert">{{ error }}</div>
+    </template>
+  </section>
+</template>
+
+<script setup lang="ts">
+import { computed, ref, watch } from "vue";
+import { floorKeyFor, floorsBody, floorsProblem, linkRobotFloor, startingFloors, type TSiteFloor } from "../../utils/robot-floors";
+import { robotErrorMessage } from "../../utils/robot-display";
+
+const props = withDefaults(
+  defineProps<{
+    site: string;
+    /** Every robot at the site. */
+    robots?: Array<Record<string, any>>;
+    /** Live states by robot id: the floor each robot reports now. */
+    states?: Record<string, Record<string, any>>;
+    /** The floors the saved building map has (the starting list when none is saved). */
+    mapFloors?: number[];
+  }>(),
+  { robots: () => [], states: () => ({}), mapFloors: () => [] },
+);
+const emit = defineEmits<{ saved: [floors: TSiteFloor[]] }>();
+
+const { getSiteFloors, saveSiteFloors, undoSiteFloors } = useRobots();
+const floors = ref<TSiteFloor[]>([]);
+const version = ref(0);
+const canUndo = ref(false);
+const loadError = ref("");
+const error = ref("");
+const busy = ref<"" | "preview" | "save" | "undo">("");
+const previewed = ref(false);
+const result = ref<{ title: string; robots?: Array<Record<string, any>> } | null>(null);
+
+async function load() {
+  loadError.value = "";
+  try {
+    const res = await getSiteFloors(props.site);
+    version.value = res.version ?? 0;
+    canUndo.value = res.canUndo === true;
+    floors.value = startingFloors(res.floors, props.mapFloors);
+    emit("saved", res.floors ?? []);
+  } catch (e) {
+    loadError.value = robotErrorMessage(e, "Could not read the floor names.");
+  }
+}
+watch(() => props.site, load, { immediate: true });
+// A map that loads after the (empty) list still seeds it.
+watch(() => props.mapFloors.join(","), () => {
+  if (!version.value && !floors.value.length) floors.value = startingFloors(null, props.mapFloors);
+});
+
+function changed() {
+  previewed.value = false;
+  result.value = null;
+}
+function add() {
+  const used = new Set(floors.value.map((f) => f.key));
+  let key = 1;
+  while (used.has(key)) key++;
+  floors.value = [...floors.value, { key, name: String(key), vendor: [] }];
+  changed();
+}
+function remove(i: number) {
+  floors.value = floors.value.filter((_, j) => j !== i);
+  changed();
+}
+
+const robotRows = computed(() =>
+  props.robots.map((r) => {
+    const id = String(r._id);
+    const s = props.states[id];
+    const floorNo = s?.ok && s.floorKnown === true && Number.isInteger(s.floorNo) ? (s.floorNo as number) : null;
+    return { id, name: String(r.name || "Robot"), floorNo, key: floorKeyFor(floors.value, id, floorNo) };
+  }),
+);
+const pickItems = computed(() => [
+  { title: "Not linked", value: null },
+  ...floors.value.map((f) => ({ title: f.name || "(blank)", value: f.key })),
+]);
+function pick(robotId: string, floorNo: number, key: number | null) {
+  floors.value = linkRobotFloor(floors.value, robotId, floorNo, key);
+  changed();
+}
+
+const problem = computed(() => floorsProblem(floors.value));
+
+async function send(dryRun: boolean) {
+  error.value = "";
+  busy.value = dryRun ? "preview" : "save";
+  try {
+    const res = await saveSiteFloors(props.site, { floors: floorsBody(floors.value), version: version.value, dryRun });
+    if (dryRun) {
+      previewed.value = true;
+      result.value = { title: `Preview: ${res.robotsChanged ?? 0} robot(s) would show a different floor. Nothing is saved yet.`, robots: res.robots };
+    } else {
+      version.value = res.version;
+      canUndo.value = true;
+      previewed.value = false;
+      result.value = { title: "Floor names saved.", robots: res.robots };
+      emit("saved", floorsBody(floors.value));
+    }
+  } catch (e) {
+    error.value = robotErrorMessage(e, dryRun ? "Could not preview the floor names." : "Could not save the floor names.");
+  } finally {
+    busy.value = "";
+  }
+}
+const preview = () => send(true);
+const save = () => send(false);
+
+async function undo() {
+  error.value = "";
+  busy.value = "undo";
+  try {
+    const res = await undoSiteFloors(props.site, version.value);
+    version.value = res.version;
+    canUndo.value = false;
+    floors.value = startingFloors(res.floors, props.mapFloors);
+    result.value = { title: "The previous floor names are back." };
+    emit("saved", res.floors ?? []);
+  } catch (e) {
+    error.value = robotErrorMessage(e, "Could not undo.");
+  } finally {
+    busy.value = "";
+  }
+}
+</script>
+
+<style scoped>
+.floors { margin-top: 16px; padding: 12px; background: var(--hero-surface); box-shadow: var(--hero-shadow-sm); display: grid; gap: 10px; }
+.floors__title { font-size: 16px; }
+.floors__head { display: flex; flex-wrap: wrap; gap: 8px; align-items: baseline; }
+.floors__rows { display: grid; gap: 6px; }
+.floors__row { display: grid; grid-template-columns: minmax(0, 1fr) minmax(0, 1fr) 36px; gap: 8px; align-items: center; }
+.floors__row--head { font-size: 12px; font-weight: 700; opacity: 0.7; }
+.floors__robots { display: grid; gap: 8px; }
+.floors__robot { display: grid; grid-template-columns: minmax(0, 1fr) auto minmax(120px, 180px); gap: 8px; align-items: center; }
+.floors__robot-name { font-weight: 600; overflow-wrap: anywhere; }
+.floors__act { display: flex; flex-wrap: wrap; gap: 6px; }
+.floors__hint { font-size: 12px; }
+.floors__table { width: 100%; border-collapse: collapse; font-size: 13px; margin-top: 6px; }
+.floors__table th, .floors__table td { text-align: left; padding: 4px 6px; border-bottom: 1px solid var(--hero-divider); }
+.floors__diff { font-weight: 700; }
+@media (max-width: 480px) {
+  .floors__robot { grid-template-columns: 1fr; }
+  .floors__table { display: block; overflow-x: auto; }
+}
+</style>

package/components/Robot/SiteScreen.vue

@@ -46,6 +46,7 @@
         :back-to-network="backToNetwork"
         @go="onSetupGo"
         @network="emit('network')"
+        @progress="(p) => emit('setupProgress', p)"
       />
       <RobotBuildingMap
         v-else-if="view === 'map'"
@@ -200,6 +201,8 @@ const emit = defineEmits<{
    * (fleet / map / lifts / setup) or the client's details page ("client").
    */
   navigate: [target: string];
+  /** Super Admin setup: required steps done of total, once the setup view has worked it out. */
+  setupProgress: [progress: { done: number; total: number }];
   /** Live feed health + open faults, for a host drawing its own header. */
   status: [status: { connected: boolean; faults: number }];
 }>();

package/composables/useRobots.ts

@@ -621,7 +621,40 @@ export default function useRobots() {
     });
   }
 
+  /*
+   * One site's robot settings (`robot-sites`): floor names as the lift car
+   * display shows them (read by anyone at the site; saved by Seven365 Super
+   * Admin, with a dry run and one-step undo), and the site's HERO Fleet Core
+   * record (Super Admin). The server refuses anyone else.
+   */
+  type TFloor = { key: number; name: string; vendor?: Array<{ robotId: string; floorNo: number }>; fleetCoreLevel?: string };
+  const sitePath = (site: string) => `/api/robots/sites/${site}`;
+  function getSiteFloors(site: string) {
+    return useNuxtApp().$api<{ floors: TFloor[]; version: number; canUndo: boolean }>(`${sitePath(site)}/floors`, { query: { appSlug } });
+  }
+  function saveSiteFloors(site: string, body: { floors: TFloor[]; version: number; dryRun?: boolean }) {
+    return useNuxtApp().$api<Record<string, any>>(`${sitePath(site)}/floors`, { method: "PUT", query: { appSlug }, body });
+  }
+  function undoSiteFloors(site: string, version: number) {
+    return useNuxtApp().$api<Record<string, any>>(`${sitePath(site)}/floors/undo`, { method: "POST", query: { appSlug }, body: { version } });
+  }
+  function getSiteFleetCore(site: string) {
+    return useNuxtApp().$api<Record<string, any>>(`${sitePath(site)}/fleet-core`, { query: { appSlug } });
+  }
+  function saveSiteFleetCore(site: string, body: { enabled: boolean; slug: string; robotIds: string[]; version: number }) {
+    return useNuxtApp().$api<Record<string, any>>(`${sitePath(site)}/fleet-core`, { method: "PUT", query: { appSlug }, body });
+  }
+  function createSiteRelayKey(site: string) {
+    return useNuxtApp().$api<{ key: string; keyVersion: number }>(`${sitePath(site)}/fleet-core/relay-key`, { method: "POST", query: { appSlug } });
+  }
+
   return {
+    getSiteFloors,
+    saveSiteFloors,
+    undoSiteFloors,
+    getSiteFleetCore,
+    saveSiteFleetCore,
+    createSiteRelayKey,
     emergencyStopRobot,
     getRobotSetup,
     applyRobotSetup,

package/package.json

@@ -2,7 +2,7 @@
   "name": "@7365admin1/layer-common",
   "license": "MIT",
   "type": "module",
-  "version": "4.124.2",
+  "version": "4.125.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/robot-display.ts

@@ -101,8 +101,11 @@ export function canRecall(state: { online?: unknown } | null | undefined): boole
 export function floorLabel(state: {
   floorNo?: unknown;
   floorKnown?: unknown;
+  /** The site's name for the floor (what the lift car display shows), from the server. Wins when present. */
+  floorName?: unknown;
 } | null | undefined): string {
   if (!state || state.floorKnown !== true) return "Floor unknown";
+  if (typeof state.floorName === "string" && state.floorName.trim()) return state.floorName.trim();
   return typeof state.floorNo === "number" && Number.isInteger(state.floorNo) ? floorName(state.floorNo) : "Floor unknown";
 }
 
@@ -1473,7 +1476,7 @@ export function robotFacts(input: {
   const battery = !reports("battery") ? nr("Battery") : fact("Battery", batteryReading(live?.batteryPercent)?.text);
   const floor = !reports("floorReporting")
     ? nr("Floor")
-    : fact("Floor", live?.ok ? floorLabel({ floorNo: live.floorNo, floorKnown: live.floorKnown }) : "");
+    : fact("Floor", live?.ok ? floorLabel({ floorNo: live.floorNo, floorKnown: live.floorKnown, floorName: (live as any).floorName }) : "");
   const position = !reports("readLocation")
     ? nr("Live position")
     : fact("Live position", live ? positionText(live, caps ?? { readLocation: true }) : "");

package/utils/robot-floors.ts

@@ -0,0 +1,95 @@
+/**
+ * Floor names (owner, 2026-10-15): a floor is called what the lift car display
+ * shows ("34", "B1", "G"). Robots report their own floor number (the PadBot at
+ * OTH says 3 on the 34th floor), so each site keeps one list (`robot-sites`):
+ * each floor's lift display name, the number the building map uses for it
+ * (`key`), and which robot floor numbers mean that floor. The server applies it
+ * (`siteFloorNo` / `floorName` on every robot state); this file is the editor's
+ * arithmetic only.
+ */
+
+export type TFloorLink = { robotId: string; floorNo: number };
+export type TSiteFloor = { key: number; name: string; vendor?: TFloorLink[]; fleetCoreLevel?: string };
+
+export const FLOOR_NAME_RE = /^[A-Za-z0-9-]{1,12}$/;
+
+/** The old label (before floor names): 1 = L1, -1 = B1, 0 = G. */
+export function defaultFloorName(key: number): string {
+  return key > 0 ? `L${key}` : key < 0 ? `B${-key}` : "G";
+}
+
+/** What a map floor number most likely shows on the lift display: 34 -> "34", -1 -> "B1", 0 -> "G". */
+export function suggestFloorName(key: number): string {
+  return key > 0 ? String(key) : key < 0 ? `B${-key}` : "G";
+}
+
+/** The map floor number for a lift display name: "34" -> 34, "B1" -> -1, "G" -> 0; null when it cannot tell. */
+export function suggestFloorKey(name: string): number | null {
+  const s = String(name ?? "").trim().toUpperCase();
+  if (/^\d{1,3}$/.test(s)) return Number(s);
+  if (/^L\d{1,3}$/.test(s)) return Number(s.slice(1));
+  if (/^B\d{1,2}$/.test(s)) return -Number(s.slice(1));
+  if (s === "G" || s === "GF") return 0;
+  return null;
+}
+
+/**
+ * The rows to start editing from: the saved list, else one row per floor the
+ * saved building map has, named as the lift most likely shows it.
+ */
+export function startingFloors(saved: TSiteFloor[] | null | undefined, mapFloors: number[]): TSiteFloor[] {
+  if (saved?.length) return saved.map((f) => ({ ...f, vendor: [...(f.vendor ?? [])] }));
+  return [...new Set(mapFloors)].sort((a, b) => b - a).map((key) => ({ key, name: suggestFloorName(key), vendor: [] }));
+}
+
+/** Which floor (key) a robot reporting `floorNo` is on, by this list: its link, else the same number, else null. */
+export function floorKeyFor(floors: TSiteFloor[], robotId: string, floorNo: number | null | undefined): number | null {
+  if (typeof floorNo !== "number") return null;
+  const link = floors.find((f) => (f.vendor ?? []).some((v) => v.robotId === robotId && v.floorNo === floorNo));
+  if (link) return link.key;
+  return floors.some((f) => f.key === floorNo) ? floorNo : null;
+}
+
+/**
+ * Put robot `robotId`'s floor `floorNo` on floor `key` (null = no link). A
+ * robot that already reports the floor's own number needs no link, so none is
+ * stored. Returns a new list.
+ */
+export function linkRobotFloor(floors: TSiteFloor[], robotId: string, floorNo: number, key: number | null): TSiteFloor[] {
+  return floors.map((f) => {
+    const vendor = (f.vendor ?? []).filter((v) => !(v.robotId === robotId && v.floorNo === floorNo));
+    if (key !== null && f.key === key && key !== floorNo) vendor.push({ robotId, floorNo });
+    return { ...f, vendor };
+  });
+}
+
+/** Why this list cannot be saved, in plain words; null when it can. */
+export function floorsProblem(floors: TSiteFloor[]): string | null {
+  const names = new Set<string>();
+  const keys = new Set<number>();
+  for (const f of floors) {
+    const name = String(f.name ?? "").trim();
+    if (!FLOOR_NAME_RE.test(name)) return `"${name || "(blank)"}" - a floor name is 1-12 letters, numbers or "-", as the lift display shows it.`;
+    if (!Number.isInteger(f.key) || f.key < -20 || f.key > 200) return `${name}: the map floor number must be a whole number from -20 to 200.`;
+    if (names.has(name.toUpperCase())) return `Floor ${name} is listed twice.`;
+    if (keys.has(f.key)) return `Two floors use map floor number ${f.key}.`;
+    names.add(name.toUpperCase());
+    keys.add(f.key);
+  }
+  return null;
+}
+
+/** The body the server takes: names trimmed, nothing else. */
+export function floorsBody(floors: TSiteFloor[]): TSiteFloor[] {
+  return floors.map((f) => ({
+    key: f.key,
+    name: String(f.name).trim(),
+    vendor: (f.vendor ?? []).map((v) => ({ robotId: v.robotId, floorNo: v.floorNo })),
+    ...(f.fleetCoreLevel ? { fleetCoreLevel: f.fleetCoreLevel } : {}),
+  }));
+}
+
+/** A floor's name by map number: the site's name, else the old label. */
+export function floorNameByKey(floors: TSiteFloor[] | null | undefined, key: number): string {
+  return floors?.find((f) => f.key === key)?.name ?? defaultFloorName(key);
+}

package/utils/robot-setup.ts

@@ -7,11 +7,11 @@
  * Every input may be `undefined` = "could not read it": that step then says
  * "Check manually" with its link, never a guess.
  */
-import { floorName } from "./robot-display.ts";
+import { floorName as defaultFloorLabel } from "./robot-display.ts";
 
 export type TSetupStatus = "done" | "action" | "waiting" | "check";
 /** Where a step's button goes: a site view, the Add robot dialog, or the client's details page. */
-export type TSetupTarget = "client" | "add" | "fleet" | "map" | "lifts" | "fleetcore" | "";
+export type TSetupTarget = "client" | "add" | "fleet" | "map" | "lifts" | "fleetcore" | "floors" | "";
 
 export type TSetupStep = {
   key: string;
@@ -43,6 +43,8 @@ export type TSetupInput = {
   fleetCore?: true | number;
   /** The client's roles that apply at this site. */
   roles?: Array<Record<string, any>>;
+  /** The site's floor names (`GET /robots/sites/:site/floors`): what the lift display calls each map floor. */
+  siteFloors?: Array<{ key: number; name: string }>;
 };
 
 export const STATUS_TEXT: Record<TSetupStatus, string> = {
@@ -184,14 +186,18 @@ export function robotSetupSteps(input: TSetupInput): TSetupStep[] {
     });
   }
 
-  // 5. Floors present: one per floor the robots report.
+  // 5. Floors present: one per floor the robots report - the SITE floor (the
+  // server applies the site's floor names: the PadBot's "3" is the 34th floor).
   const floors = floorsOf(map);
+  const siteFloor = (s: Record<string, any>) => Number(Number.isInteger(s.siteFloorNo) ? s.siteFloorNo : s.floorNo);
   const onFloor = (robots ?? [])
     .map((r) => ({ name: String(r?.name || "A robot"), s: input.states?.[String(r?._id)] }))
     .filter((x) => x.s?.ok && x.s.floorKnown === true && Number.isInteger(x.s.floorNo));
-  const reported = [...new Set<number>(onFloor.map((x) => Number(x.s!.floorNo)))];
+  const reported = [...new Set<number>(onFloor.map((x) => siteFloor(x.s!)))];
   const missing = reported.filter((f) => !floors.includes(f));
-  const who = (f: number) => onFloor.filter((x) => Number(x.s!.floorNo) === f).map((x) => x.name).join(", ");
+  const who = (f: number) => onFloor.filter((x) => siteFloor(x.s!) === f).map((x) => x.name).join(", ");
+  const named = input.siteFloors ?? [];
+  const floorName = (f: number) => named.find((x) => x.key === f)?.name ?? defaultFloorLabel(f);
   if (map === undefined) {
     steps.push({ key: "floors", title: "Floors on the map", status: "check", reason: "Could not read the saved building map.", button: { label: "Open building map", target: "map" } });
   } else if (!map) {
@@ -204,9 +210,9 @@ export function robotSetupSteps(input: TSetupInput): TSetupStep[] {
       reason: !floors.length
         ? "The saved map has no floors. Use Edit map → Add floor."
         : missing.length
-          ? `${missing.map((f) => `${who(f)} report${who(f).includes(",") ? "" : "s"} ${floorName(f)}`).join("; ")} - the map has no such floor (it has ${floors.map(floorName).join(", ")}). Add it in Edit map → Add floor, or check the floor set in the robot's own app.`
-          : `${floors.map(floorName).join(", ")}${reported.length ? " - every floor the robots report." : "."}`,
-      button: { label: "Edit floors", target: "map" },
+          ? `${missing.map((f) => `${who(f)} report${who(f).includes(",") ? "" : "s"} ${floorName(f)}`).join("; ")} - the map has no such floor (it has ${floors.map(floorName).join(", ")}). If it is really one of those, say which in Floor names below; otherwise add it in Edit map → Add floor.`
+          : `${floors.map(floorName).join(", ")}${reported.length ? " - every floor the robots report." : "."}${named.length ? " Names as the lift display shows them." : ""}`,
+      button: missing.length ? { label: "Floor names", target: "floors" } : { label: "Edit floors", target: "map" },
     });
   }