Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.firstresonance.io/llms.txt

Use this file to discover all available pages before exploring further.

​
Overview

A build requirement is a line item on an aBOM (As-Built Bill of Materials) that specifies which parts must be installed onto a parent assembly to complete a build. The aBOM Part Manager modal lets you edit those requirements directly: add a part to the build, remove one, set the quantity, configure substitutes, and call out Made on Assembly (MOA) parts. Edit the aBOM whenever the planned build deviates from the engineering BOM — supply substitutions, late-stage design changes, or sub-assemblies that need to be built directly onto the parent.

​
Prerequisites

  • Permission to edit aBOMs on the part inventory you’re working with.
  • An existing aBOM. ION creates one automatically when a part inventory is staged for a build.
  • The aBOM Part Manager modal is open. You can launch it from a part inventory page or from inside an active run.

​
Open the aBOM Part Manager

The modal shows the parent assembly card at the top, then a filterable list of build requirements for that assembly. If you’re working inside a sub-assembly, breadcrumbs at the top of the modal let you navigate back up the assembly tree.

​
Steps

​
1. Enter Edit aBOM Mode

Click the edit toggle in the filter bar at the top of the modal. While in edit mode you’ll see a “You are in Edit aBOM Mode” banner and the add-part dropdown becomes available. Add, remove, and quantity changes are only available while edit mode is on.

​
2. Add a part

  1. With edit mode on, open the part dropdown under the edit-mode banner.
  2. Select the part to add. ION creates a new build requirement with quantity = 1.
  3. (Optional) Toggle Add as MOA before selecting to mark the part Made on Assembly — see Made on Assembly below.
The dropdown automatically excludes parts that are already on the aBOM, so you can’t double-add the same part.

​
3. Set the quantity

Each build requirement card has a quantity field representing the count of that part required to complete one parent assembly. ION multiplies this by the parent assembly’s quantity to compute total demand for the build.
Quantity is per one parent unit. If the parent has quantity 5, ION calculates total demand as quantity × 5.

​
4. Configure substitutes (alternates)

Expand the substitutes list on a build requirement card to add alternate parts that may be installed in place of the primary part. Substitutes are useful when:
  • The primary part is constrained by supply.
  • Multiple part numbers are functionally interchangeable.
  • An engineering change introduces a drop-in replacement mid-program.
When operators install against this build requirement during a run, they can scan any of the listed substitutes to satisfy the requirement.

​
5. Add reference designators

For build requirements that need positional callouts — for example R12 or U7 on a PCB — enter the reference designators on the build requirement card. Each designator must be unique within the build requirement and counts toward the total quantity required.

​
6. Remove a part

Click Remove on a build requirement card. ION will ask you to confirm before removing the requirement. If installations have already been recorded against this build requirement on a run-in-flight, you’ll need to reconcile those installations after removal.

​
Made on Assembly (MOA)

Toggle Add as MOA when adding a part whose sub-assembly is built directly onto the parent rather than as a standalone unit. MOA parts roll up into the parent’s installation flow instead of triggering their own run, which keeps the production graph aligned with how operators actually work the bench. Use MOA when:
  • A sub-assembly only ever exists in the context of its parent.
  • You want operators to track install steps for the sub-assembly inside the parent’s run rather than as a separate routing.

​
Tips

  • Show only incomplete filter (top of the modal) hides build requirements that already have full installations recorded — useful for working through a long aBOM late in a build.
  • Expand all / Collapse all toggles every build requirement card open or closed in one click, so you can review substitutes, MOA settings, and installations across the whole aBOM at once.
  • Sub-assemblies: Click Expand sub-assembly on a build requirement whose part is itself an assembly. The modal drills into that sub-assembly’s aBOM. The breadcrumbs at the top of the modal let you walk back up the assembly tree at any point.
  • Search and filter: Use the filter bar to narrow the build requirement list by part number, description, or status while editing — your filter is preserved as you toggle in and out of edit mode.