Products #
URLs: /products (list), /products/new, /products/{id}, /products/{id}/edit, /products/{id}/stations (the Stations tab as its own URL — bookmarkable)
A product is a DUT under test — its part number, revision,
characteristics (named measurements with limits and units), and pin
map. The Products entity pages are the browser surface for the
project's products/ directory.
List — /products #
A table with one row per product. Columns:
| Column | What it shows |
|---|---|
| ID | Product identifier |
| Name | Human-readable name |
| Rev | Revision string (when set) |
| Chars | Count of characteristics defined on the product |
| Runs | Total runs that have tested this product |
| Passed | Run count with outcome passed |
| Failed | Run count with outcome failed |
| Last Run | Most recent run start timestamp, browser-local time |
Click a row to open /products/{id} (detail). When no products
exist, the table is replaced with a card hinting at the products/
directory and the New Product button.
Detail — /products/{id} #
A header bar (Back + Edit buttons), one Product Information card (ID, name, revision, description), then a tab strip with three tabs:
| Tab | Content |
|---|---|
| Pins | The DUT pin map (one row per pin: pin, signal, description) |
| Characteristics | One row per characteristic: name, function, direction, units, limit shape |
| Stations | Compatible stations + the required capabilities the matcher resolved against. Each entry is a card with a View button that opens the matching station detail page. |
When the URL points at a missing product, the page shows a "Product not found." card.
Edit — /products/{id}/edit #
A header bar with the product name + a "Changes auto-saved" hint (no Save button), then a tab strip with three tabs:
| Tab | Content |
|---|---|
| Info | Name / Description / Revision (Product ID is read-only) |
| Pins | Per-pin rows — add, remove, or edit pin / signal / description |
| Characteristics | Existing characteristics show Function / Direction / Units as a read-only summary; the Add Characteristic dialog is where you set those fields on new entries. |
New — /products/new #
Different shape from Edit — a single non-tabbed form with just
Product ID, Name, and Description fields. After creation, the page
redirects to /products/{id}/edit so you can add pins and
characteristics in their dedicated tabs.
Underlying data #
Products are stored as YAML — either flat (products/<id>.yaml) or
in a per-product subdirectory (products/<id>/<id>.yaml); both
layouts are supported.
For the YAML schema, see Configuration reference → Products. For the concept, see Concepts → Products.
Common tasks #
- Add a characteristic — open
/products/{id}/edit, switch to the Characteristics tab, click Add. The dialog captures name, function, direction, and units. Limits and tolerance bands are set in the product YAML, not in this UI — edit the YAML inproducts/<id>/<id>.yaml(or the flat-layout equivalent) and the Detail page picks them up on next load. - Check which stations can run this product — pre-fill the
Launch Test page with
?product=<id>and read the Station hint.
See also #
- Configuration reference → Products
- Concepts → Products
- Launch Test — start a run for a product