feat: guided construction flow from BOQ to invoice

[skibanga]

Summary

These changes make the construction flow easier to follow from start to finish:

BOQ → Tender → Contract → Mobilization → Measurement → Progress Claim → Invoice

Each step can now be created from the step before it, every document links back and forth, and the forms explain their fields in plain language.

Changes

Tender

• Status is read-only. Saving sets Draft; submitting sets Awarded.
• Status is shown in the list view and filters.

Bill of Quantities

• Create → BF Contract appears once the BOQ's tender is awarded. It opens the existing contract if there already is one.
• Requested Qty on BOQ lines is kept up to date when Material Requests are submitted or cancelled.

Material Request

• New Get Items From → BF Bill of Quantities:
  • If the Material Request was opened from a BOQ, items are pulled straight from it. Otherwise a BOQ picker is shown.
  • Only stock items still left to request are added, linked to their BOQ line and project.
  • Pulling the same BOQ twice doesn't duplicate rows.
• A warning appears when someone requests more than is left on a BOQ line.

Contract

• Plain-language help on every field, and a three-column layout: references | amounts entered | calculated totals.
• Submittals:
  • Status is now Pending / Approved / Rejected.
  • The table stays editable after submit.
  • An attachment is required before a row can be Approved or Rejected (checked in the form and on the server).
• Create → Site Measurement Log appears once the Site Mobilization is submitted. It pre-fills the contract, project, BOQ and date. The server blocks it when there is no submitted mobilization.

Measurement Log / Progress Claim

• Plain-language help on No. / Length / Width / Height, on the claim lines, and on the financial summary.
• Fetch Measurements only shows once the claim is saved. Before, it failed on an unsaved claim.
• VAT moved to the invoice:
  • The claim now ends at Net Amount Due (Excl. VAT).
  • Sales and Purchase Invoices made from a claim apply the company's default tax template.
  • The FIDIC IPC print format was updated to match, and a leftover VAT setting was removed.

Navigation

• Connections tab added to Tender, Variation Order, Site Mobilization, Site Measurement Log and Mobilization Template. Links now go both ways between related documents.
• Fixed the Contract connections pointing to a non-existent "BF Measurement Log".
• Fixed the BOQ procurement links (Material Request, Purchase Order, Purchase Receipt, Purchase Invoice via bf_boq).

Testing

Each change was tested on a local v15 site against real BOQ / Tender / Contract / Claim records, with test data rolled back:

• Tender: Draft → Awarded on submit.
• BOQ → Contract button: pre-fills tender, project, BOQ and amount.
• Submittals: approving without a file is blocked; changes work after submit.
• Measurement Log: blocked until mobilization is submitted.
• Material Request:
  • 5 stock rows pulled and services skipped.
  • After requesting 10 m of pipe, the next pull offers only the remaining 10 m.
  • Over-request warning is shown.
• Claim → Sales Invoice: net 1,048,800 + VAT 188,784 = 1,237,584 with a default tax template.

Notes

• For VAT to appear on claim invoices, the company needs a default Sales Taxes and Charges Template.

🤖 Generated with Claude Code