Documentation

How PCBMind works

The inspection pipeline

Every uploaded photo moves through the same stages before you see a result:

  1. 1Upload — your photo is stored and queued for analysis.
  2. 2Image quality check — basic validation that the image decoded correctly.
  3. 3Preprocessing — resized and contrast-corrected (CLAHE) so uneven lighting doesn't hide defects.
  4. 4AI detection — the trained model scans the board for defects. This is the slow step — a cold server can take up to a minute.
  5. 5Component matching — detections are compared against your golden PCB reference, if one's attached.
  6. 6Defect analysis — each detection is classified by type and severity.
  7. 7Report — a PDF report is generated on demand from the results.

Roles & permissions

Every user belongs to an organization with one of three roles:

ActionAdmin / QA engineerOperator
Run inspections✓✓
View dashboard & reports✓✓
Create / manage PCB templates✓—
Upload golden PCB references✓—
Export CSV / Excel✓—

The first person to sign up for an organization becomes its admin.

Defect taxonomy & severity

Every detection falls into one of six defect types, each mapped to a severity level:

ShortcriticalTwo traces or pads that should be isolated are bridged.
Open circuitcriticalA trace that should connect two points is broken.
Missing holemajorA drilled hole expected by the design is absent.
Spurious coppermajorCopper present where the design calls for bare substrate.
Mouse biteminorSmall notches eaten into a copper pad or trace edge.
SpurminorAn unwanted stub of copper branching off a trace.

API basics

The frontend talks to a REST API secured with a Supabase-issued bearer token — every request carries Authorization: Bearer <token>. Full interactive API docs (OpenAPI) are available at /docs on the API host.

POST/api/inspectionsrun a new inspection
GET/api/inspections/{id}fetch a result
GET/api/inspections/exportbulk CSV/Excel export
GET/api/pcb-templateslist templates
GET/api/dashboardorg-wide stats

FAQ

Why did my inspection take so long?

Free-tier hosting spins down after inactivity — the first request after idle time can take up to a minute while the server wakes up.

Can I re-run an inspection?

Yes — uploading the same or a new photo against the same template creates a new, independent inspection record.

Are shared report links secure?

Report and image links are unauthenticated but unguessable (random IDs) — treat a copied link like you would any file you forward directly.