Extracted from ../entities/item.md.


  • v0.4 — Added Reviewed → Priced cascade on rate change (BR-049a). Reflects Worksheet Resource rate-edit mechanisms (BR-047/048/049).
  • v0.3 — Plugged status clarified:
    • Plugged = item-level direct rate entry (no Worksheet build-up). Distinct from Plug Rate (Resource flag)
    • Added plug_rate attribute on Item (nullable number)
    • Rewrote §5 state transitions — derived automatically from Worksheet content + plug_rate presence for Unpriced / Plugged / Priced; Reviewed / Locked remain manual/cascaded
    • Added validation invariants #13 (mutual exclusion Plugged/Priced) and #14 (plug_rate cleared when Worksheet has cost-contributing children)
    • Added Example D (Plugged Item) and Example E (Priced Item with Plug Rate Resources inside — showing the two concepts are distinct)
    • Re-opened from Reviewed goes back to Priced only (per Q4)
    • Resolved Q1/Q2/Q3/Q4 and updated open items
  • v0.2 — BR review pass:
    • Added Unpriced and Plugged Item statuses (per BR review)
    • Documented submission-block behaviour (navigation to Publisher allowed; Submit action blocked if any Item Unpriced or Plugged)
    • Added Anomaly checks for Unpriced + Plugged Items
    • New derived attributes: is_submission_ready, has_plug_rate_resources
    • New validation invariant (#12) — submission readiness gate
    • Flagged open items around Plugged automation, naming, and Unpriced Worksheet semantics
  • v0.1 — initial draft (Batch B). Consolidates rules from business-rules.md §3.2, glossary Items section, domain-model Item entry. Adds validation invariants, state machine, four worked examples.