Surveillance¶
The Surveillance page is available at:
https://app.pixaro.ai/admin/videos
Feature Overview¶
Surveillance is used to review and manage store video or image events. Users with the Surveillance role raise events by uploading event media, classifying the event, adding priority, employee, notification, and description details, and saving the event for store review.
Store owners and managers use Surveillance to review events raised by the Surveillance team, check event details, receive urgent notifications, review comments, and download filtered data.
Pixaro can also be used by a dedicated surveillance monitoring team. This team continuously reviews store activity and raises events when they identify something the store owner should know about.
Surveillance events are store-specific. Select the correct store from the top toolbar or the Surveillance filter before creating or editing events.
Monitoring Team Workflow¶
The surveillance monitoring team reviews store video and raises events for store-owner visibility. Event creation is handled by logged-in users with the Surveillance role.
Events may include:
- High-priority incidents that need immediate store-owner attention.
- Operational issues such as suspected cashier fraud, shoplifting, refunds, void entries, cash drawer events, or items not scanned.
- General low-priority observations, such as cashier change, routine activity, system checks, or other events that should be recorded but do not require urgent action.
When a high-priority event is raised, Pixaro immediately triggers a notification to the store owner's mobile app so the owner can review the incident quickly.
Low-priority events are still recorded in Surveillance for history, review, and reporting, but they are intended for awareness instead of immediate escalation.
Access and Navigation¶
Navigation path: Video Intelligence > Surveillance
Required permissions: Surveillance or Video Intelligence access for the selected user role.
Tabs¶
The Surveillance screen contains tabs:
| Tab | Purpose |
|---|---|
| Surveillance | Main event list with video/image events. |
| Comments | Review comment activity related to surveillance events and incidents. |
| Employees | Manage employee records for the selected store. Visible only after a specific store is selected. |
| Checklist | Manage store checklist records. Visible only after a specific store is selected. |
Employees and Checklist are disabled when All Locations is selected.
Surveillance List¶
The Surveillance tab shows events in a paginated table.
Columns include:
| Column | Meaning |
|---|---|
| Video | Event media preview and file name. Videos can be previewed from the thumbnail. Images open in an image viewer. |
| Category | Event category, such as Cashier Fraud, Shoplifting, or System Check. |
| Priority | Event priority: High, Medium, or Low. |
| Event Date | Date and time the event occurred, shown in the store timezone. |
| Duration | Media duration. |
| Upload Date | Date and time the media was uploaded. |
| Uploaded By | User who uploaded the event. |
| Size | File size in MB. |
Click a row to open the event detail page.
Filters¶
Click Search Filter to open the filter dialog.
Available filters:
| Filter | Notes |
|---|---|
| Locations | Select All Locations or a specific store. |
| Category | Filter by event category. Disabled on Comments, Employees, and Checklist tabs. |
| From Event Date / To Event Date | Filter by when the event occurred. |
| From Upload Date / To Upload Date | Filter by when the event was uploaded. |
| Uploaded By | Available only when a specific store is selected. |
| Employee | Available only when a specific store is selected. |
| From Size / To Size | Filter by media file size. |
| Priority | Filter by High, Medium, or Low. |
Use OK to apply filters.
Use Reset to clear filters and return to the default list.
Active filters appear as chips below the header and can be removed individually.
Creating a New Event¶
Users with the Surveillance role can click New Event to upload a new surveillance event.
New Event is disabled when All Locations is selected. Select a specific store first.
Supported upload files:
| File Type | Supported Formats |
|---|---|
| Video | .mp4, .mov, .mkv |
| Image | .jpeg, .png |
Upload rules:
- Each file must be 80 MB or less.
- Invalid file types are rejected.
- The event can contain multiple media files.
- Video duration is read from the uploaded file metadata.
To create an event:
- Log in with a user that has the Surveillance role.
- Open Video Intelligence > Surveillance.
- Select a specific store from the filter or top toolbar.
- Click New Event.
- Choose or drag files into the event page.
- Upload the selected media.
- Add event details such as event date, tags, priority, category, type, employee, notification, and description.
- Click Save.
Editing Event Details¶
On the event detail page, users can update:
| Field | Purpose |
|---|---|
| Event Date | Date/time when the event happened. |
| Tags | Labels used to organize and search events. Users can create new tags from the field. |
| Priority | High, Medium, or Low. High priority is used for incidents that require immediate attention. Low priority is used for general observations such as cashier change or routine activity. |
| Category | Event category. |
| Notification | Indicates whether notification should be enabled for the event. High-priority events trigger immediate mobile app notification to the store owner. |
| Type | Event type such as Void Entry, Refund, Cash Drawer Event, Item Not Scanned, or similar options. |
| Employee | Employee linked to the event. |
| Description | Notes explaining what happened. |
If an event is saved without event date, tags, priority, and category, Pixaro asks for confirmation before saving.
Adding More Media To An Event¶
An existing event can have additional media added from the event detail page.
The same file validation applies:
- Video:
.mp4,.mov,.mkv - Image:
.jpeg,.png - Maximum file size: 80 MB
Deleting Events Or Media¶
Users can delete:
- An entire surveillance event.
- An individual media file attached to an event.
When deleting media, Pixaro updates the event media list. If the main media file is removed, another attached media file may become the main event media.
Comments¶
The Comments tab is used to review surveillance and incident comments. Users can open comment threads and add replies where the workflow allows it.
Use this tab when reviewing communication around events or incident requests.
Employees¶
The Employees tab is available only for a selected store.
It is used to manage employee records that can be linked to surveillance events. Employee data helps users identify who was involved in an event.
Checklist¶
The Checklist tab is available only for a selected store.
It is used to create, update, and review checklist records and related checklist media. Checklist records support store operations and video review workflows.
Download / Export¶
Click Download to export surveillance data.
Export behavior:
- Export is disabled until a specific store is selected.
- Export uses the current filters.
- The backend generates an Excel file.
- If no matching data exists, no file is downloaded.
Backend Notes¶
Surveillance uses Pixaro API routes such as:
/surveillance/videos/surveillance/videos-multiple/surveillance/videos-multiple/:video_id/surveillance/videos/:store_id/:video_id/surveillance/comments/employee/list/checklist/:store_id/surveillance/export-excel
Troubleshooting¶
| Issue | What to Check |
|---|---|
| New Event is disabled | Select a specific store instead of All Locations. |
| Employees or Checklist tab is missing | Select a specific store. |
| Upload fails | Confirm file type and size. Files must be supported video/image formats and 80 MB or less. |
| Event list is empty | Clear filters, check selected store, and confirm surveillance permission. |
| Export does not download | Confirm a store is selected and matching data exists for the current filters. |
| Employee is not available in event details | Confirm the employee exists and is active for the selected store. |
| Event times look incorrect | Confirm the store timezone is configured correctly. |
| Store owner did not receive a high-priority notification | Confirm the event priority is High, notification is enabled, and the store owner has mobile app notification access. |
Best Practices¶
- Select the store before creating or exporting events.
- Add category, priority, tags, employee, and description before saving.
- Use High priority only for events that need immediate attention because it triggers store-owner mobile notification.
- Use Low priority for general monitoring observations such as cashier change, routine activity, or non-urgent notes.
- Keep file uploads short and relevant.
- Use filters before exporting to keep Excel files focused.
- Link employees whenever possible to improve search and reporting.