Checkpoints
A checkpoint is a marked location in a property — typically equipped with an NFC tag or QR code. Employees scan it during a patrol, link incidents directly to a specific spot and create a complete record of what was checked, when and where.
You manage checkpoints in the portal under Property → tab "Patrols". Linking a checkpoint to a physical NFC chip happens afterwards in the mobile app.
Checkpoint table
The table lists every checkpoint of the current property. The following columns are visible:
| Column | Meaning |
|---|---|
| Name | Display name (max. 100 characters) |
| Internal note | Hint visible only to administrators in the portal |
| Note for employees | Task displayed during the patrol on the smartphone |
| NFC status | "Active" (chip linked), "not connected" (no chip) or "missing" (chip absent) |
Interaction:
- Click a row opens the edit drawer with all details and statistics.
- Search by name filters the table. The active query persists on reload.
- Multi-select via checkboxes activates a bulk bar with "Download PDF" and "Delete".
- Per-row actions (visible on hover): download single PDF, delete single point.
- Empty state: if no points exist yet, a placeholder appears with a "Create first checkpoint" button.
Create a checkpoint
The "Create checkpoint" button opens a two-pane drawer that supports creating multiple points at once.
Left pane: draft list
- Numbered list of unsaved points ("Point 1", "Point 2", …)
- Status per draft: "Ready" (name set) or "No name yet"
- The "Add another" button appends an empty draft
- Footer with keyboard tip and the primary submit button "Create X checkpoints" (counter shows valid drafts)
Right pane: input workbench
The header shows a "Point N of M" indicator and previous/next arrows for switching between drafts.
Form (left half):
- Checkpoint name — required, max. 100 characters
- Task — max. 300 characters, visible during the patrol (employees see this on their smartphone)
- Photo of the checkpoint — optional, JPG or PNG, automatically compressed to max. 1 MB
- Internal notes — collapsible section, not visible during the patrol (only for the team in the portal)
Map (right half):
- Mapbox map with the property polygons
- Click on the map to drop a pin as the optional location
- Remove the pin via a confirmation button
Keyboard shortcuts
| Key | Action |
|---|---|
Tab | Move to next field |
Enter in the name field | Append a new draft and focus it |
| Click submit | Save all valid drafts in one go |
Validation
- Submit is disabled while photo uploads are in progress or have failed.
- Duplicate names within the draft list are highlighted and block saving.
- At least one draft must have a name.
Edit a checkpoint
Clicking a row in the table opens the detail drawer. The same two-pane layout applies.
Left pane: checkpoint list
- Search field filters server-side (debounced)
- Complete list of every checkpoint of the property, lazy-loaded in blocks of 30
- Active selection visually highlighted
- Inactive points carry an "Inactive" badge
- Switching to a different entry instantly shows its details — the drawer stays open
:::warning Heads up Switching via the sidebar does not save automatically. Save your changes first using "Save". :::
Right pane: detail workbench
Header: title "Edit checkpoint" plus the point name. Actions on the right: Delete (when allowed), Cancel, Save.
Statistics cards show three key figures live from the backend:
| Card | Content |
|---|---|
| Scans 30D | Number of scans during the last 30 days |
| Last scan | Relative time (e.g. "12 min ago", "2 days ago") or "No scans yet" |
| Status | "Active" (green) or "Inactive" (red) |
Form & map: identical structure to the create flow — name, task, photo, internal notes, location map.
Photo behaviour: an existing photo is pre-filled. "Remove" triggers a confirmation dialog; uploading a replacement overwrites the old image upon save.
Read-only behaviour
- Fields are disabled depending on permissions. Points assigned to an active template, for example, may only allow editing the notes.
- The active toggle appears only when the "Archive checkpoints" permission is granted.
Photo and location
- Photos are compressed automatically before upload (target < 1 MB), JPG and PNG are supported.
- The upload runs in the background while you fill in the rest of the form — the status indicator shows progress, success or failure.
- The location is optional and only used for displaying the pin on the portal map — no geofencing. Attendance is confirmed in the app via NFC scan, not via GPS. See Manage checkpoints (app) for details.
Good to know
:::tip Note
- Bulk creation runs as a single save operation: if one point fails (e.g. duplicate name), none of them are created.
- NFC linking to a physical chip does not happen in the portal — see Manage checkpoints (app).
- Points assigned to an active patrol template cannot be deleted — only archived.
- The PDF export lists every point with its QR code, ready to print and stick on.
- Statistics in the detail cards cover all scans — whether part of a template or a free patrol. :::
Permissions
:::info Permission To view checkpoints you need the View checkpoints permission. Contact your administrator if you do not have access. :::
| Action | Permission |
|---|---|
| View checkpoints | View checkpoints |
| Create checkpoint | Create checkpoints |
| Edit checkpoint | Edit checkpoints |
| Delete checkpoint | Delete checkpoints |