Zone Inspect

Login

Open the application URL. Enter your access key on the login page. The key is provided by the administrator and maps to your operator name. The session persists for 30 days.

Interface Overview

The system uses a 3-step wizard:

• Step 1 — Upload: upload a reference photo or load a saved template.
• Step 2 — Zones: draw inspection zones on the reference image.
• Step 3 — Check: take zone photos, run analysis, review results.

Click the Step 1 indicator at any time to reset and start over.

Sensitivity Controls

In the header, two inputs control detection strictness:

• Zone (0.00–2.00) — sensitivity for zone-level defect detection. Default: 0.50.
• Subzone (0.00–2.00) — sensitivity for subzone-level analysis. Default: 0.51.

Higher values = stricter detection (more defects flagged). Lower values = more lenient.

Single Image

Drag and drop (or click to browse) a single photo of the reference assembly into the upload area. Supported formats: PNG, JPG, JPEG, BMP, WebP.

Multi-Image Blending

Upload 2+ photos of the same object. The system shows a blending panel:

• Manual blend: adjust X/Y offset and Scale sliders for each image. Click "Blend (manual)" to merge.
• Auto-align (SIFT): automatically aligns images using feature matching, then averages. Best for slightly shifted shots.
• Readjust: go back to the slider interface after viewing the result.

Multi-image blending reduces noise and produces a cleaner reference.

Saved Templates

Templates store the reference image + zone layout for reuse. They appear as cards in Step 1 with name, barcode mask, version number, zone count, and creation date.

Load

Click "Load" on a template card to jump directly to Step 3 (inspection) with all zones pre-configured. A "Recipe" badge appears showing the template name.

Save as Template

In Step 2 after drawing zones, enter a name and optional barcode mask, then click "Save Template". The reference image is stored in cloud storage (R2).

Edit Template

Click "Edit" on a template card to open the full-screen template editor. You can:

• Add, rename, delete, and reorder zones (drag the handle).
• Draw anchor points and subzones (see below).
• Change template name and barcode mask.
• Zoom the canvas: Ctrl+scroll or +/- buttons (100%–800%).

Versioning

Click "Save changes" to create a new version. Previous versions are archived and visible in the sidebar. Click any older version to restore it (creates a new version).

Delete Template

Click "Delete" on the template card. Confirmation required.

Barcode Mask

A prefix string (e.g. "7334") that validates scanned serial numbers. If the scanned code does not start with this mask, a "Mask mismatch" warning appears during inspection.

Draw Zones

In Step 2, click and drag on the reference image to draw rectangular zones. Each zone is auto-labeled ("Zone 1", "Zone 2", etc.) and color-coded.

Zone Controls

• Rename: edit the text field on a zone chip.
• Select: click the color dot to highlight the zone on the canvas.
• Delete: click X on the zone chip.
• Undo last / Clear all: buttons below the canvas.

Anchor Points

Click the crosshair icon on a zone chip to enter anchor mode. Place up to 2 anchor points on or near the zone. Anchors provide alignment guidance on the mobile camera — the phone shows where to position the board relative to detected features.

Subzones

Click the square icon on a zone chip to enter subzone mode. Draw up to 10 smaller rectangles inside the zone. Subzones trigger a separate, stricter analysis pass. Each subzone has its own status, defect %, and images. The zone's overall status = the worst status among all its subzones.

Canvas Zoom

Ctrl+scroll or use +/- buttons. Range: 100%–800%.

Save & Start

Click "Save zones & start check" to lock zones and proceed to Step 3.

Serial Number Scanning

Before checking zones, scan a barcode / QR code / DataMatrix for the serial number. Upload a photo from desktop or use the mobile camera. The zone check area is locked until a serial is scanned. The decoded value appears with its type (e.g. QR_CODE, CODE_128).

Taking Zone Photos (Desktop)

Drag and drop one or more zone photos into the upload area, then click "Run Check". Multiple files are processed sequentially with a progress counter ("[1/5]", "[2/5]", etc.).

Zone Matching

Each uploaded photo is automatically matched to the best-fitting zone using a multi-stage pipeline:

• Global alignment (SIFT or neural network) to warp the input to the reference.
• Zone crop extraction and SSIM pre-ranking of all zones.
• Top-3 neural scoring (EfficientNet-B4) for final match.
• Match score must exceed 0.55 threshold. Otherwise "NO MATCH".
• Already-OK zones are deprioritized.

Defect Analysis

The matched zone is compared against the reference to detect defects:

• Neural mode: EfficientNet-B4 patch-based CNN comparison + global similarity + SSIM.
• OpenCV fallback: CLAHE normalization, SSIM, absolute difference, edge analysis, adaptive thresholding, contour-based measurement.

Output: SSIM score, defect percentage, defect region count, status (OK / WARN / DEFECT), and visualization images (defect map, heatmap, extracted zone, reference crop).

Subzone Analysis

If the zone has subzones defined, each subzone is analyzed separately with stricter thresholds. The zone status = worst of (zone result, all subzone results).

Result Display

After each check: 5 images (input, reference, extracted, defect map, heatmap), statistics (score, SSIM, defect %), a bar chart of all zone scores, and subzone details if applicable. Click any image for a full-size lightbox.

Calculated vs Accepted Result

Each zone and subzone has two results:

• Calculated (auto): determined by the defect analysis algorithm.
• Accepted (user decision): manually set by the operator via a dropdown.

If the operator overrides the calculated result, the original is shown crossed out with an arrow to the accepted status plus a pencil icon.

Overall Result

The overall inspection status is the worst effective status across all zones. Effective = user zone override > worst subzone override > calculated status. Any DEFECT makes the whole inspection a defect. Any WARN (with no defect) makes it a warning.

User Decision Override

• Zone-level: dropdown on each zone chip or in the lightbox.
• Subzone-level: dropdown next to each subzone. Changing subzone decisions recalculates the zone's effective status.

Auto-Accept

Toggle the "auto" switch next to the progress bar. When all zones are OK and auto-accept is ON, the result is auto-saved and a new board starts after 3 seconds.

Close & Save

Click "Close & Save" to save the inspection (complete or partial) and reset for the next board. If a result was auto-saved, it updates with the latest user decisions.

Skip Board

Abandon the current board without saving. Resets the session.

Retry Failed Zones

Clear only non-OK zones for re-photographing without resetting the entire board.

Connecting

In Step 3, a QR code and URL are shown. Scan with your phone to open the mobile companion page. No separate login required.

Serial Scanning

The "Serial" tab provides live camera barcode scanning. The camera feed shows a scan reticle with an animated scan line. A beep sound plays on successful detection. You can also choose an image from the gallery.

Zone Photos

The "Zone" tab shows which zone to photograph next. Navigate between zones with left/right arrows.

Anchor Alignment

If anchor points are defined for the zone, the camera feed shows dashed guide circles at target positions. Real-time template matching detects anchors in the live video. When aligned (solid green circles + checkmark), press "Capture Zone".

Capture & Upload

Press "Capture Zone" to take a photo. A shutter sound plays. The photo is queued for the desktop, which processes it automatically (polls every 5 seconds). Multiple photos can also be uploaded from the gallery.

Mobile Actions

• Skip -> New SN: save current result and start a new board from mobile.
• Retry Failed: re-scan only failed zones.

The mobile page continuously polls the server (every 5 seconds) to sync state with the desktop.

Viewing History

Scroll to the bottom of the page and click "Inspection History" to expand the panel. Each row shows: date, time, serial, template name, operator, zone count, overall status, and inline stats (OK/defect/warn counts, avg score, max defect %). Overridden results have a pencil icon.

Search & Filter

Type in the search box. Format: serial / template / operator. Supports * wildcards. Each part filters the corresponding field. Example: 7334* / Module XY / John.

Detail View

Click a row to expand it. Shows: stats row, doughnut pie chart (OK/Defect/Warn distribution), per-zone score bars, zone image cards with status badges and defect %. Subzone cards shown with a red left border.

Zone Comparison

Click any zone image card to open a full-size side-by-side comparison of the captured photo vs the reference.

Overridden Results in History

When the accepted status differs from the calculated one, the zone card shows: calculated -> accepted. Same for subzones.

Print Passport

Click "Print" on any history row to generate a formal inspection passport document with all metadata, zone table (with overrides shown), score charts, and zone images. Opens the browser print dialog.

Pagination

History loads in pages of 20. Click "Load more" to see older results.

Appears in Step 3 after the first zone is checked. Displays:

• Summary counters: total checked, OK, Warn, Defect, average SSIM, average defect %.
• Match scores chart: bar chart of match scores per zone, color-coded by status.
• Defect % chart: defect percentage per zone.
• SSIM chart: SSIM per zone (green >= 45%, yellow >= 30%, red < 30%).
• Data table: zone status, score, SSIM, defect %, defect count.

All charts and counters update in real-time as zones are checked.

Zone Status Chips

Color-coded chips below the check panel: green = OK, yellow = WARN, red = DEFECT, blue = unchecked. Shows effective status (with overrides). Click to view that zone's result.

Progress Bar

Shows "N/M zones checked" with a percentage fill bar.

Reference Mini-Map

Small canvas showing the full reference image with zone overlays. Unchecked zones pulsate; checked zones show their status color and a check/warn/defect marker.

Completion Banner

When all zones are checked: "ALL ZONES OK" (green) or "ISSUES FOUND" (yellow). Shows serial number if scanned. Action buttons appear for saving, skipping, or retrying.

Authentication

All requests require the header X-Auth-Key with a valid API key. API keys are read-only — they can only retrieve inspection results and images.

X-Auth-Key: apk_your_key_here

List Results

GET /api/v1/results

Query parameters:

• from — start date (ISO, e.g. 2026-03-01)
• to — end date (ISO, e.g. 2026-03-19)
• serial — serial number filter, supports * wildcard
• template — template name filter
• operator — operator name filter
• status — ok, warn, or defect
• limit — max results per page (default 50, max 500)
• offset — skip N results for pagination

Example:

curl -H "X-Auth-Key: apk_..." \
  "https://your-host/api/v1/results?from=2026-03-01&serial=SN-12*&limit=10"

Response:

{
  "total": 42,
  "limit": 10,
  "offset": 0,
  "results": [
    {
      "result_id": "a1b2c3d4_143000",
      "timestamp": "2026-03-19T14:30:00",
      "serial": "SN-1234-2026",
      "template_name": "Module X",
      "operator": "operator1",
      "overall_status": "ok",
      "zones": [
        {
          "label": "U1",
          "status": "ok",
          "score": 0.87,
          "defect_pct": 3.2,
          "image_url": "/api/v1/results/.../images/zone_0.jpg"
        }
      ]
    }
  ]
}

Single Result

GET /api/v1/results/{result_id}

Returns the full inspection record. Add ?images=base64 to embed images as Base64 data URIs directly in the JSON (convenient for single records, but large payloads).

curl -H "X-Auth-Key: apk_..." \
  "https://your-host/api/v1/results/a1b2c3d4_143000?images=base64"

Result Image

GET /api/v1/results/{result_id}/images/{filename}

Returns a JPEG image. The image_url fields in the JSON response point to this endpoint. Use the same API key header.

curl -H "X-Auth-Key: apk_..." -o zone.jpg \
  "https://your-host/api/v1/results/a1b2c3d4_143000/images/zone_0.jpg"

Error Codes

• 401 — missing or invalid API key
• 403 — key scope insufficient (e.g. operator key used on /api/v1/)
• 404 — result or image not found
• 503 — database unavailable

Full Example (curl)

# 1. Get recent inspections for serial starting with "SN-12"
KEY="apk_Xk9mP2qR7vN4wL5bT8cF"
HOST="https://inspect.metaprodtrace.com"

curl -s -H "X-Auth-Key: $KEY" \
  "$HOST/api/v1/results?from=2026-03-01&serial=SN-12*&limit=5" \
  | python3 -m json.tool

# 2. Get a single result with full details
RID="a1b2c3d4_143000"

curl -s -H "X-Auth-Key: $KEY" \
  "$HOST/api/v1/results/$RID" \
  | python3 -m json.tool

# 3. Download a zone image from that result
curl -H "X-Auth-Key: $KEY" \
  -o zone_photo.jpg \
  "$HOST/api/v1/results/$RID/images/zone_0.jpg"

# 4. Get the same result with images embedded as Base64
curl -s -H "X-Auth-Key: $KEY" \
  "$HOST/api/v1/results/$RID?images=base64" \
  | python3 -m json.tool

# 5. Without a key — expect 401
curl -s "$HOST/api/v1/results"
# {"error": "Unauthorized"}

The system uses group-based access control with three user roles and API key scoping.

Roles

admin	Full access to everything. No group restriction. Can manage all templates, view all results, clear history.
lead	Belongs to a group. Can create, edit, delete, and restore templates (own group + shared). Views results of own group only.
operator	Belongs to a group. Can use templates (own group + shared) and run inspections. Cannot create/edit/delete templates. Views results of own group only.

Groups

Each non-admin user belongs to a group (e.g. "line1", "line2"). Groups isolate data:

-- Templates with a group are visible only to that group's members.
-- Templates with no group (empty) are shared -- visible to everyone.
-- Inspection results are strictly filtered by group.
-- Admin sees everything regardless of group.

API Keys

External API keys (apk_ prefix) also support group scoping:

-- Key with "group": "line1" can only read results from that group.
-- Key without group can read all results.
-- Scope "read" limits to GET requests on /api/v1/* endpoints.

Header Badge

The top-right corner of the interface shows the current user's name, role, and group.

Configuration

{
  "users": {
    "SECRET_KEY": {
      "name": "display_name",
      "role": "admin | lead | operator",
      "group": "group_name"
    }
  },
  "api_keys": {
    "apk_SECRET_KEY": {
      "name": "Integration Name",
      "scope": "read",
      "group": "group_name"
    }
  }
}