Documentation
How PCBMind works
The inspection pipeline
Every uploaded photo moves through the same stages before you see a result:
- 1Upload — your photo is stored and queued for analysis.
- 2Image quality check — basic validation that the image decoded correctly.
- 3Preprocessing — resized and contrast-corrected (CLAHE) so uneven lighting doesn't hide defects.
- 4AI detection — the trained model scans the board for defects. This is the slow step — a cold server can take up to a minute.
- 5Component matching — detections are compared against your golden PCB reference, if one's attached.
- 6Defect analysis — each detection is classified by type and severity.
- 7Report — a PDF report is generated on demand from the results.
Roles & permissions
Every user belongs to an organization with one of three roles:
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:
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.
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.