Open general

Adom parts: show the Adom part number and Adom's own stock from page data (component.adom)

Ray ·

What's wrong

On an Adom part's page, for example adom/machinepinlargeshort:

  • Adom # shows the page's public id (pg_pka18p6q12), not the part number.
  • Stock shows the "Check stock and price" button, which only asks DigiKey and Mouser. For our own parts, Adom's stock is the number that matters, and it shouldn't take a click.

What we want, for Adom-made parts (machine pins, machine contacts, molecules) and Adom basic parts (what we stock on the PnP line):

  1. The Adom part number shows in the sidebar and anywhere else the page names the part.
  2. Adom's stock shows already filled in from the page data, with its date. Distributor rows can keep the Check button.

Field contract (the data side is ours)

The factory and Component Ocean will write this block into page.json and package.json (component.adom) and keep it current without a click:

"component": {
  "adom": {
    "part_number": "MachinePinLargeShort",
    "kind": "adom-made",
    "stock": 1200,
    "stock_as_of": "2026-11-02T20:00:00Z",
    "source": "pnp-inventory",
    "location": "Bin-C7"
  }
}
field meaning
part_number the number Adom uses for the part. For an Adom-made part that's its MPN (MachinePinLargeShort); for a basic part, the MPN the inventory stocks it under. Never the page id.
kind adom-made or adom-basic
stock units on hand, an integer; null when no count is recorded (show "not tracked", not 0)
stock_as_of when that count was read, ISO 8601 UTC
source where the count comes from; today always pnp-inventory (inventory-2w8z8d9ojzzl.adom.cloud)
location shelf or bin when the inventory has one, optional

The block is absent on every other part, so the current behaviour stays as it is there.

Asks for the wiki

  • When component.adom is present: show part_number as Adom #, in the sidebar and in the page's part-number spots, instead of the public id.
  • Show stock and stock_as_of in the stock area as Adom's own row, already filled in ("Adom: 1,200 in stock, as of Nov 2"). Show null as "not tracked".
  • Keep the Check button for the DigiKey and Mouser rows.

Where Adom's stock lives today

  • Basic parts: pnp-inventory (Drew's service) has a live count for 173 parts (stock, location, updated_at). That's the source of truth.
  • Machine pins and contacts: no service has a count yet. They aren't in pnp-inventory as parts or molecules, Component Ocean has no record of them, and their pages carry only the MPN and specs. Until Drew's inventory records them, their pages will carry stock: null.

2 Replies

Colby Knox ·

Live on the wiki now:

  • Adom # shows the real part number. With no component.adom block, it's the MPN on catalog basic parts and on Adom-made parts. The pg_ id doesn't change, and Adom # still links to it.
  • Catalog basic parts say "Stocked by Adom" until a count is recorded, and they keep Check for the distributor rows.
  • Adom-made parts with no distributor number no longer show Check.

@ray the block is ready whenever your side writes it. stock takes an integer, a short label like "10k+" or "many", or null. Pins and contacts show no stock until then. source and location aren't shown. A block on a page that isn't Adom's or in the basic parts catalog is ignored, and the publish warns COMPONENT_ADOM_IGNORED.

Colby Knox ·

@ray heads-up on one change to this today: Adom # now shows the page id (pg_...) on every part, Adom's own parts included. It was showing the part number on Adom-made and basic parts and the page id everywhere else, and on molecules it just repeated the MPN row. The part number still shows in the MPN row, and Adom # still links to the permanent address.

Nothing changes on your side. Keep writing component.adom as before: part_number is still accepted and checked, and Adom's stock still shows under Adom # with no click.

No page has a count to show yet. Pins and contacts carry stock: null and read "not tracked", and the basic parts don't carry the block yet. Counts will appear as soon as the inventory writes them into the pages.

Log in to reply.