User Guide

Sentry uses your phone number for authentication. No password needed.

1. Go to sentry.qikbite.asia/app.
2. Enter your phone number (Myanmar format: 09xxxxxxxxx).
3. You'll receive a 6-digit SMS code. Enter it on the next screen.
4. You're in — the session lasts 30 days.

The dashboard has two groups of pages: Monitor (daily operations) and Manage (configuration).

Site picker

Pages that show site-specific data (Digest, Cameras, Health) have a site selector at the top. Your selection is remembered across pages. The first site is selected by default.

Status strip

At the top of the Digest page, the status strip shows fleet-wide counts:

The Digest is your main screen. It shows POS exceptions flagged by the nightly analysis, along with foot-traffic data.

Date selector

Use the date picker to choose which day to view. The default is yesterday — the correlation analysis runs overnight on the trading day that just ended.

Stats line

Above the incident list, the stats line shows:

• Incidents — total POS exceptions found for the day
• Flagged — incidents the AI rules flagged as suspicious
• Visitors — unique people counted by the camera (when analytics is available)
• Median dwell — how long the typical visitor stayed at the counter

Incident list

Each incident row shows:

• Time — when the exception occurred (in the site's timezone)
• Severity — critical, warning, or none
• Status — new, reviewed, dismissed, or escalated
• Exception type — e.g. "No sale / no customer", "Void", "Discount"
• Terminal, operator, amount — which till, who was operating, transaction amount

Click any incident to open its detail page.

Click an incident to see the full details, video evidence, and AI observations.

What you'll see

• Thumbnail grid — camera frames from around the time of the exception
• Video clip — playback of the 30-second segment containing the exception
• AI observations — what the vision model detected (customer count, staff count, drawer state, etc.)
• Rule reason — why the rule flagged this as suspicious (e.g. "No customer visible during a ₨5,000 void")
• Transaction details — terminal, operator, amount, reference number

Actions

The Cameras page lets you see what your cameras are recording and review past footage.

Live view

The latest frame from each camera is displayed. This updates periodically — it's not a live stream, but a snapshot of the most recent uploaded frame.

Recordings

Browse recorded segments by date and time. Each segment is a 30-second clip. Use the timeline scrubber to jump to a specific time.

• Filter by camera if the site has multiple
• Click a segment to play it back
• Download individual segments using the download button

Monitor the health of your devices and cameras at a glance.

Device health cards

Each device shows:

• Status — online or offline
• Uptime bars — 24 bars representing the last 24 hours. Green = online, red = offline
• Uptime % — 24-hour and 30-day rolling percentages
• Disk free — remaining storage on the device
• Spool pending — segments waiting to be uploaded (high numbers during outages)
• Agent version — which version of the edge agent is installed

Camera health

Under each device, cameras show their own status:

• online — recording and uploading frames
• offline — no recent frames received
• Last segment time — when the most recent recording was made

A site is a physical store location. Each site has its own timezone, trading hours, and devices.

Create a site

1. Go to the Sites page.
2. Click Add Site.
3. Enter the store name, timezone (e.g. Asia/Yangon), and trading hours.
4. Click Create Site.

Trading hours

Trading hours define when the store is open. The nightly analysis only looks at footage within this window. Default is 09:00–21:00.

Each mini-PC running the Sentry agent is a "device". Devices must be enrolled to a site before they can upload data.

Enrolling a new device

1. Go to the Devices page.
2. Click + Enrol Device.
3. Select the site the device belongs to.
4. Click Generate Code — you'll get a 12-digit pairing code.
5. On the mini-PC, run: sentry enrol --code YOUR_CODE

Device list

The Devices page shows all enrolled devices with their site, agent version, health state, and last heartbeat time.

For detailed installation instructions, see the Setup Guide.

A Network Video Recorder (NVR) connects multiple cameras through a single device. Sentry can record from each NVR channel as if it were a standalone camera.

How it works

Each NVR channel exposes two RTSP streams — a high-resolution main stream and a lower-resolution sub stream. Sentry records both: the sub-stream is uploaded and analysed, the main stream stays on the local disk as an evidence buffer.

Hikvision RTSP URL pattern

Hikvision NVRs use a predictable URL format for each channel:

Adding NVR channels

Use sentry add-camera for each channel:

Auto-discovery with --nvr

For automatic NVR discovery, use the --nvr flag:

This will:

1. Probe the network for ONVIF devices
2. Detect NVRs by recognising multi-channel profile patterns (Hikvision, Dahua)
3. Display each NVR with its channel count and per-channel stream details
4. Auto-add all channels with labels like "HIKVISION NVR Ch1", "Ch2", etc.

Bandwidth and storage

Each NVR channel counts as one camera for storage and bandwidth:

• ~51.6 GB/day per channel on disk
• ~0.78 Mbps upload per channel
• Two channels on a 1 TB disk at 7-day retention is comfortable (~650 GB)
• Four channels needs a 2 TB disk or shorter retention

Generate a signed link to share an incident with someone who doesn't have a Sentry account (e.g. a manager or law enforcement).

1. Open the incident detail page.
2. Click Share.
3. Choose how long the link should be valid (default: 3 days).
4. Copy the generated link.

The share link gives access to:

• The incident details (time, terminal, operator, amount)
• Video clip playback
• AI observations

When does the nightly analysis run?

The correlation and analytics pipelines run between 02:00 and 04:00 local time on the trading day that just ended. By the time you check the dashboard in the morning, yesterday's digest is ready.

What happens when the internet goes down?

The edge agent uses store-and-forward. It keeps recording and queueing data locally. When connectivity returns, everything uploads automatically. No data is lost for outages up to 60 minutes (or longer if disk space allows).

How much disk space does the agent use?

The agent records the sub-stream (640×360 at ~1 fps) for upload, plus the main stream (2K) as a local buffer. Typical usage is 2–5 GB per day per camera. The janitor automatically cleans up files older than 7 days, and reclaims space when disk usage exceeds the configured threshold.

Who can access the dashboard?

Access is role-based:

• Owner — full access to all pages, can enrol devices and manage sites
• Reviewer — can view digests, incidents, and cameras but cannot manage sites or devices
• Support — Code2Lab support staff with scoped access for troubleshooting

By default, managers do not have dashboard access. This is intentional — the manager is frequently the subject of detection. Contact support to grant scoped manager access.

Is the dashboard available in Burmese?

English is the current language. Burmese localisation is planned — the dashboard has a translation scaffold ready for a Burmese string bundle.

Need help?

Contact Code2Lab support or check the Setup Guide for installation and troubleshooting steps.