Resource Balance Operations

Resource balancing answers the question: "I have $X of budget for this resource across all items — how should that quantity be spread?" It's a commercial rather than an estimating tool.

Core Concepts

Typical Workflow

1. Open the Resource Balance panel from the Resources view.
2. Choose a target resource (e.g. "Concrete 25MPa").
3. Select the items you want to balance across.
4. Choose a distribution method:
5. Proportional — distribute by each item's BuildUpCost.
6. Equal — split the quantity equally.
7. Manual — you type the shares.
8. Click Preview to see the proposed changes.
9. Click Apply to commit, or Cancel.

Preview vs Apply

• PreviewResourceBalanceAsync returns the calculated changes without saving.
• ApplyResourceBalanceAsync writes the changes and records the operation history.

The history log means you can rollback a specific operation later.

Rollback

1. Open Balance Operation History.
2. Select the operation.
3. Click Rollback → TX1 calls RollbackResourceBalanceOperationAsync and restores prior values.

Rebalancing Stale Allocations

When upstream quantities change, existing balances can become stale (the ratio they were built on is no longer true). Two options:

• Rebalance Stale (RebalanceStaleResourceBalancesAsync) — automatically redistributes all stale balances.
• Rebalance Selected — pick which ones to refresh.

When to Use This

• Pricing supply deals: you've negotiated 500 t of steel. Balance the quantity across the items that use steel so the sum exactly matches.
• Bid adjustments: "cut $50k from the concrete budget" — balance rather than editing item by item.
• Rebalancing after late-stage quantity changes.