Open In progress bug report

Part search says real part LM2903L-Q1 is 'not recognized': manufacturer Preview parts fail the check because no distributor stocks them yet

adonis · ·edited ·marked in progress by ray

Seen on wiki.adom.inc search, 2026-11-02, signed in. Related: adom/wiki#247 (the variant checklist).

What happened

Searching LM2903L-Q1 shows (screenshot):

We do not recognize LM2903L-Q1 as a catalog part number. Check the spelling, or search for the base part number.

It also shows "Did you mean Lm2903a-Q1?", which is a different part number (and oddly cased).

The part is real:

The "Request this part" button is still there, but the message says the number is wrong. That reads as "you made a typo", so most people will stop there.

Likely cause

TI marks LM2903L-Q1 as Preview: it has no orderable part numbers yet, and Mouser, DigiKey and JLCPCB all return 0 hits for it (checked with adom-parts-search today). So "recognized" seems to mean "a distributor sells it". New and Preview parts fail that check even when the manufacturer has published the datasheet the build needs. These are also the parts nobody else has CAD for yet.

What I'd expect

  • Before saying a part is not recognized, check the manufacturer's site or a datasheet lookup as well as the distributors. If the maker lists the part, treat it as real.
  • If the part is Preview or not yet orderable, say so and keep the request open, for example: "TI lists LM2903L-Q1 as Preview (not orderable yet). We can still build it from the datasheet."
  • In the #247 checklist, show a Preview part with a "Preview" tag instead of leaving it out.
  • Only show "Did you mean" when the number really can't be found. Here it pointed away from a part that exists exactly as typed.
  • Let me add the datasheet myself when the wiki can't confirm a part. In the "No page for yet" box, offer a PDF upload or a pasted link (for example the TI link above), and build from that datasheet without needing a distributor or catalog match. This also covers parts the wiki will never find on its own: new or Preview parts, parts from small makers, and datasheets I got directly from a vendor. If a datasheet I supply needs checking before it's trusted (wrong part, wrong revision), sending it to the existing pinout-review step would be fine.

6

6 Replies

This comment was deleted by its author ·
Colby Knox ·
Ray marked this in progress ·
Colby Knox ·

@ray most of this one is on the Component Ocean side. Here's where it stands.

Changed on the wiki (live now):

  • The not-found message no longer reads like a typo. It now says: "We couldn't find LM2903L-Q1 at Mouser, DigiKey or JLCPCB, so we can't build it yet. It may be new or not sold yet, or the number may have a typo."
  • "Did you mean" keeps a part number in capitals, so Lm2903a-Q1 won't appear again.

Needs Component Ocean:

  1. Treating a part the manufacturer lists as real when no distributor stocks it yet. Today the lookup answers 404 when the catalog, DigiKey and Mouser all miss.
  2. A way to tell the wiki a part is Preview, so the checklist can tag it instead of leaving it out.
  3. Building from a datasheet the requester supplies, as a PDF or a link. The box on the wiki can collect it once there's somewhere to send it.
  4. The batch path's "we don't recognize that part number" message, which has the same typo problem. The wiki shows it as sent.

Still open on the wiki: "Did you mean" can point away from a real part, because the search page doesn't know the part is real. If item 1 gives us an answer, we can hide the suggestion for those parts.

Ray ·

Thanks for the clear report. The Component Ocean side is done (component-ocean ffba232, factory 9ff5511, 6237e4c, d45fe5b).

What changed

  1. Recognition. When no catalog and no distributor knows a part, CO now asks the manufacturer before saying "not recognized". Today that's TI: the product page (with its status) and /lit/ds/symlink/<part>.pdf. Most other makers block plain requests, so a miss names the makers that were asked (makers_asked).
  2. Status. Responses carry the maker's lifecycle:
    • GET /api/part/<mpn> returns found_at_maker: true and maker: {manufacturer, lifecycle, orderable, product_url, datasheet_url, package, maker_parts, message}.
    • POST /api/part-request returns recognized_by (catalog, distributor, manufacturer or datasheet), plus lifecycle, orderable, maker, datasheet_source and message.
    • For LM2903L-Q1 the message is "TI lists LM2903L-Q1 as Preview (not orderable at distributors yet). We can still build it from the datasheet."
    • The request stays open and goes to the factory, which builds a part like this without a distributor number. It does that only when DigiKey and Mouser both answered "no match".
  3. #247 checklist. GET /api/part-candidates?q=LM2903L-Q1 now returns the part as a row with tags: ["preview"], lifecycle, orderable: false and maker_url.
  4. "Did you mean Lm2903a-Q1". That comes from the wiki's own search speller (DID_YOU_MEAN in /api/search), so it's on the wiki side (Colby).
  5. Your own datasheet. POST /api/part-request accepts datasheet_url. The batch call accepts it per part: mpns: [{mpn, manufacturer?, datasheet_url?}].
    • The value is an http(s) link, or a wiki attachment path starting /attachments/, so an upload works once it's attached.
    • A part no catalog knows is built from that datasheet.
    • The factory checks that the datasheet names the part. If it doesn't, the request goes to the pinout review instead of a page.
    • A requester's link never replaces the maker's own datasheet.
    • The upload and link UI in the "No page for yet" box is yours, Colby; those are the field names.

LM2903L-Q1 itself

It's request 1210: recognized from TI, queued, and past the distributor check. It stops at the footprint.

  • The datasheet (SLVSL49, Advance Information) has the pinout, but for the RUG package only TI's "generic package view" (4231768/A), with no dimensions.
  • TI's separate package document for it (MPQF216D) is the same generic view.
  • KiCad has no RUG footprint. The nearest, TI's RSE0010A UQFN, has the same 1.5 x 2 mm outline but is a different package, and we don't guess land patterns.

So the request is held with that reason, and it can be asked for again once TI publishes the RUG drawing. If you have TI's RUG0010 drawing from another source, send it as datasheet_url and it goes through the review step.

One open point for Colby: a new component page with no DigiKey, Mouser or LCSC number is refused today (DISTRIBUTOR_NUMBERS_REQUIRED). For a part like this the factory writes digikey, mouser and lcsc as false, backed by a recorded distributor_check (both answered "no match") and distributor_check.manufacturer.lifecycle: "preview". Can the wiki accept that for a part the maker lists as Preview?

Your 19:54 list, item by item:

  1. Covered by item 1 above. When the maker lists the part, GET /api/part/<mpn> answers with found_at_maker: true, and POST /api/part-request succeeds with recognized_by: "manufacturer". Either one tells search the part is real, so you can hide "Did you mean" whenever found_at_maker is true (or recognized_by is anything but absent). makers_asked lists which makers were checked when it is false.
  2. lifecycle (and tags: ["preview"] on the part-candidates row), above.
  3. datasheet_url, above. A PDF upload works as the wiki attachment path.
  4. Fixed in component-ocean 2144b9c: single and batch requests now share one message, "no catalog, distributor or manufacturer listing we can read has this part number yet. If you have its datasheet, send it as datasheet_url and it can still be built."
Colby Knox ·

Live on the wiki now:

  • The box says when the maker lists a part as Preview, with a link to the product page, and the checklist tags those rows.
  • "Did you mean" stays hidden when the part is real. The CLI and API still send that suggestion.
  • When a part can't be found, a signed-in requester gets a field for a link to its datasheet. It's links only, and it refuses email addresses, other schemes, logins in the link, IP addresses and internal hosts. File uploads are out for now.

@ray two notes, neither one a requirement:

  1. The link is only an aid for the factory, so use it however works for you. For context, this differs from the rule at the top of partRequests.ts, that a requester never supplies what a page is built from. A doctored datasheet that names the part could put a wrong pinout on a page, so sending these through pinout review is an option if you want it.
  2. DISTRIBUTOR_NUMBERS_REQUIRED already accepts false for all three distributors, so a Preview part doesn't need an exception. If you're seeing it refused, send me the exact error.
Ray ·

Agreed, and done (component-ocean fecd69b, factory fd29ee1).

Every build from a requester-supplied datasheet goes to review before it publishes, even when the datasheet names the part. Builds from the manufacturer's or a distributor's datasheet stay automatic.

  • The factory builds the page and stops before publishing. The request goes to review with the public reason "The page is built from the datasheet sent with the request. A person checks a requester's datasheet before the page is published."
  • The reviewer sees the datasheet link and an image with the datasheet's pinout page on the left and the pins the factory read on the right. Approving it publishes the page; asking for changes leaves it unpublished.
  • A test fails if a requester-datasheet build can reach the publish step without review.

The link is checked again on our side, even though the wiki already checks it:

  • CO refuses a datasheet_url with credentials, an internal name (localhost, .internal, .local and similar), or a private, loopback, link-local or reserved IP. It also resolves the name and refuses one that lands on such an address. The same check runs per part on the batch call.
  • The factory fetches a requester's link without curl, following redirects by hand and repeating the check at every hop.

false distributor links work for Preview parts. I checked LM2903L-Q1's shape against the linter: with all three links false (plus the recorded distributor_check) it raises no DISTRIBUTOR_NUMBERS_REQUIRED; with the links empty it does. LM2903L-Q1 itself is still waiting on TI's RUG package drawing, so it hasn't reached a publish yet.

Colby Knox ·

@adonis the fixes are live. Can you check these on the wiki?

  1. Search LM2903L-Q1. The box should say TI lists it as Preview and can still be built, link to the product page, and show no "Did you mean". Please don't request it again: it's already request 1210, held until TI publishes the package drawing.
  2. Search TLV1812-EP. The button should stay dimmed on "Finding orderable parts..." until the list loads, with no "Did you mean" beside the list.
  3. Search a made-up number and click Request. It should say we couldn't find it at Mouser, DigiKey or JLCPCB, and a field should appear for a link to the datasheet. Try mailto:[email protected], which should be refused, and don't submit a real link unless you want that part requested. "Did you mean" can appear here if there's a close match.
  4. Open your notifications. Issues in progress should show an amber "In progress" badge.

A build from a datasheet link you send stops for a person to review before it publishes. File uploads aren't included for now. Tell me here if anything looks wrong, and I'll close this once you've checked.

Log in to reply.