Files
Odoo-Modules/fusion_repairs/views/repair_order_views.xml
gsinghpal ebbadb3002 feat(fusion_repairs): Bundle 8 - rush service + emergency pricing + parts-ordered workflow
The grumpy-old-customer-with-broken-stairlift scenario. Four real workflows
the office faces every week, with comms baked in so the client never has to
call back asking for status.

NEW MODELS
- fusion.repair.emergency.charge (rate card)
  Per (category, tier) rate with per_tech_multiplier; 5 tiers
  (same_day / next_day / after_hours / weekend / holiday). Each category
  can have its own rates - bed motors need 2 techs, stairlift is single.
  Seeded with realistic Westin rates: stairlift same-day $250, weekend
  $450; porch lift same-day $300; bed same-day $175 with 0.6 multiplier
  (2-tech jobs frequent); powerchair same-day $200.

- fusion.repair.part.order (procurement-facing record)
  One per distinct part the tech needs from the manufacturer. Carries
  description + OEM # + manufacturer + quantity + photos + notes.
  4-state lifecycle: draft -> ordered -> received -> fitted (or
  cancelled). On state transitions:
    draft -> ordered:  email client "ordered, expected by X"
    ordered -> received: email client "arrived, scheduling return visit"
                         + auto-create follow-up dispatch task when ALL
                         outstanding parts on the repair have arrived.

REPAIR.ORDER EXTENSIONS
- Rush fields: x_fc_rush_requested, x_fc_rush_tier,
  x_fc_rush_techs_required, x_fc_rush_surcharge (computed via rate card),
  x_fc_rush_acknowledged_at + x_fc_rush_acknowledged_by_id (audit trail
  proving CS got verbal OK before charging).
- Parts-awaiting fields: x_fc_parts_awaiting + x_fc_parts_eta_date +
  x_fc_part_order_ids One2many + x_fc_part_order_count.

- New methods:
  * action_acknowledge_rush() - one-click "client agreed" with audit.
  * action_squeeze_into_today() - picks the lightest-loaded skilled tech,
    finds their first free 1-hour slot between 9am-6pm, schedules the
    task in it, sends:
      1) live bus.bus push to the tech (sticky notification in their
         web client - so they see it MID-SHIFT)
      2) rush-alert email (force_send=True - this can't wait in the queue)
      3) chatter post on the tech task itself
    Validates against fusion_tasks' time-conflict rule by passing
    force_schedule via context (intake.service honours it).
  * action_view_part_orders() - smart button.

WIZARD EXTENSIONS
- repair.intake.wizard:
  New rush_requested + rush_tier + rush_techs_required + rush_acknowledged
  controls. Live rush_surcharge_preview compute shows CS the price in
  real-time as they change category / tier / tech count. Yellow alert
  reminds CS to read the price to the client BEFORE submitting.

- repair.visit.report.wizard:
  New outcome radio: completed / parts_needed / rescheduled.
  When outcome=parts_needed, needs_parts_line_ids One2many appears for
  the tech to capture each part (description, OEM, manufacturer, qty,
  lead days, notes, photos). On submit each line creates a
  fusion.repair.part.order, the repair flips to x_fc_parts_awaiting=True
  with an ETA, and the client gets the "we found the problem, here's the
  plan" email immediately.

INTAKE SERVICE
- _create_dispatch_task now honours force_schedule (date + time_start +
  time_end) via context so squeeze + auto-redispatch don't crash on
  fusion_tasks' time-window validator.
- _create_single_repair carries rush_requested/tier/techs through to
  the new repair fields.

MAIL TEMPLATES (4 new)
- email_template_rush_tech_alert: red 4px accent, address + phone + the
  $surcharge - what the tech needs to know mid-shift.
- email_template_repair_awaiting_parts: amber accent, "we found the
  problem, parts ordered, return visit ~ETA, no action needed".
- email_template_parts_ordered: blue, per-part confirmation.
- email_template_parts_received: green, "arrived, office will call to
  confirm visit".

UI / NAVIGATION
- Backend wizard: rush controls + live surcharge preview + verbal-OK alert.
- repair.order form: new Rush / Parts notebook tab with all the fields
  + linked part orders list. Two new header buttons (Squeeze into
  Today / Client Agreed to Rush Price). Two new search filters
  (Rush, Awaiting Parts).
- Part Order form: statusbar with the 4 transitions + Cancel; notes +
  photos notebook tabs; full chatter for audit.
- Menus: 'Parts to Order' under root; 'Emergency Surcharges' under
  Configuration.

SECURITY
- 8 new ACL entries (emergency_charge user/manager; part_order
  user/dispatcher/manager/technician; visit_report partline for office
  and field tech). Office sees parts but only managers can edit
  emergency rates.

Verified end-to-end on local westin-v19 - all 4 scenarios green:
  S1 Same-day rush stairlift -> $250 surcharge, ack stamped, squeeze
     assigned garry@ at first free 1h slot today, alert email queued,
     chatter posted.
  S2 Next-day priority bed -> $0 surcharge (no rate seeded for bed
     next_day - office can configure), 4 emails queued (client + office).
  S3 2-tech weekend stairlift -> $675 (450 base + 0.5x base for 2nd tech).
  S4 Parts-needed visit-report -> 2 PART-#### records created, repair
     awaiting_parts=True, ETA=2026-06-06, office activity scheduled,
     client email sent. Marking part ordered -> client mail. Marking
     all parts received -> auto-dispatch follow-up + client mail.

Bumped to 19.0.1.9.1.

Co-authored-by: Cursor <cursoragent@cursor.com>
2026-05-21 01:28:13 -04:00

362 lines
19 KiB
XML

<?xml version="1.0" encoding="utf-8"?>
<odoo>
<!-- ============================================================== -->
<!-- Form view extensions -->
<!-- ============================================================== -->
<record id="view_repair_order_form_inherit_fusion_repairs" model="ir.ui.view">
<field name="name">repair.order.form.inherit.fusion_repairs</field>
<field name="model">repair.order</field>
<field name="inherit_id" ref="repair.view_repair_order_form"/>
<field name="arch" type="xml">
<!-- Header action buttons (visit report + collect payment) -->
<xpath expr="//header" position="inside">
<button name="action_open_visit_report"
type="object"
string="Visit Report"
class="btn-primary"
invisible="state in ('draft', 'cancel') or x_fc_technician_task_count == 0"
groups="fusion_repairs.group_fusion_repairs_user"/>
<button name="action_collect_payment"
type="object"
string="Collect Payment"
class="btn-secondary"
invisible="state != 'done'"
groups="fusion_repairs.group_fusion_repairs_user"/>
<button name="action_offer_loaner"
type="object"
string="Offer Loaner"
class="btn-secondary"
icon="fa-handshake-o"
invisible="state in ('done', 'cancel')"
groups="fusion_repairs.group_fusion_repairs_user"/>
<!-- Bundle 8: squeeze a rush into today's tech route + acknowledge surcharge -->
<button name="action_squeeze_into_today"
type="object"
string="Squeeze into Today"
class="btn-warning"
icon="fa-flash"
invisible="state in ('done', 'cancel') or not x_fc_rush_requested"
groups="fusion_repairs.group_fusion_repairs_dispatcher"/>
<button name="action_acknowledge_rush"
type="object"
string="Client Agreed to Rush Price"
class="btn-warning"
icon="fa-check"
invisible="not x_fc_rush_requested or x_fc_rush_acknowledged_at"
groups="fusion_repairs.group_fusion_repairs_user"/>
</xpath>
<!-- Smart buttons: Technician Tasks + Intake Answers + Original SO. -->
<xpath expr="//div[hasclass('oe_button_box')]" position="inside">
<button name="action_view_technician_tasks"
type="object"
class="oe_stat_button"
icon="fa-wrench"
invisible="x_fc_technician_task_count == 0">
<field name="x_fc_technician_task_count" widget="statinfo" string="Tech Tasks"/>
</button>
<button name="action_view_intake_answers"
type="object"
class="oe_stat_button"
icon="fa-list-alt"
invisible="x_fc_intake_answer_count == 0">
<field name="x_fc_intake_answer_count" widget="statinfo" string="Answers"/>
</button>
<button name="action_view_original_sale_order"
type="object"
class="oe_stat_button"
icon="fa-dollar"
invisible="not x_fc_original_sale_order_id">
<field name="x_fc_original_sale_order_id" widget="statinfo" string="Original SO"/>
</button>
</xpath>
<!-- Add intake metadata under partner_id -->
<xpath expr="//field[@name='partner_id']" position="after">
<field name="x_fc_repair_category_id" options="{'no_create': True}"/>
<field name="x_fc_urgency" widget="badge"
decoration-success="x_fc_urgency == 'normal'"
decoration-warning="x_fc_urgency == 'urgent'"
decoration-danger="x_fc_urgency == 'safety'"/>
<field name="x_fc_third_party_equipment"/>
<field name="x_fc_is_quote_only"/>
<field name="x_fc_intake_source" readonly="1"/>
<field name="x_fc_intake_user_id" readonly="1" invisible="not x_fc_intake_user_id"/>
<field name="x_fc_intake_session_id" readonly="1" invisible="not x_fc_intake_session_id"/>
</xpath>
<!-- Add a Fusion Repairs notebook tab with intake + photos. -->
<xpath expr="//notebook" position="inside">
<page string="Intake" name="fusion_intake">
<group>
<group>
<field name="x_fc_intake_template_id" readonly="1"/>
<field name="x_fc_issue_category"/>
</group>
<group>
<field name="x_fc_warranty_override_reason"
placeholder="Reason if warranty status was overridden"/>
<field name="x_fc_estimated_duration" widget="float_time"/>
</group>
</group>
<separator string="Answers"/>
<field name="x_fc_intake_answer_ids" readonly="1">
<list>
<field name="sequence" column_invisible="True"/>
<field name="question_name"/>
<field name="value_display"/>
<field name="question_type" optional="hide"/>
</list>
</field>
<separator string="Photos &amp; Videos"/>
<field name="x_fc_photo_ids" widget="many2many_binary"/>
</page>
<page string="Pricing" name="fusion_pricing" invisible="not x_fc_estimated_cost and not x_fc_actual_cost">
<group>
<group>
<field name="x_fc_estimated_cost" widget="monetary"/>
<field name="x_fc_actual_cost" widget="monetary"/>
</group>
<group>
<field name="x_fc_cost_variance_pct" widget="float" digits="[16,2]"/>
<field name="x_fc_requires_requote"/>
<field name="company_currency_id" invisible="1"/>
</group>
</group>
</page>
<page string="AI Brief" name="fusion_ai" invisible="not x_fc_ai_summary">
<field name="x_fc_ai_summary" readonly="1"/>
</page>
<page string="Margin" name="fusion_margin"
groups="fusion_repairs.group_fusion_repairs_manager">
<group>
<group>
<field name="x_fc_revenue" widget="monetary"/>
<field name="x_fc_labour_cost" widget="monetary"/>
<field name="x_fc_parts_cost" widget="monetary"/>
</group>
<group>
<field name="x_fc_margin" widget="monetary"/>
<field name="x_fc_margin_pct" widget="float" digits="[12,1]"/>
<field name="company_currency_id" invisible="1"/>
</group>
</group>
</page>
<page string="Rush / Parts" name="fusion_rush_parts">
<group>
<group string="Rush Service">
<field name="x_fc_rush_requested"/>
<field name="x_fc_rush_tier"
invisible="not x_fc_rush_requested"/>
<field name="x_fc_rush_techs_required"
invisible="not x_fc_rush_requested"/>
<field name="x_fc_rush_surcharge"
widget="monetary"
readonly="1"
invisible="not x_fc_rush_requested"/>
<field name="x_fc_rush_acknowledged_at"
readonly="1"
invisible="not x_fc_rush_requested"/>
<field name="x_fc_rush_acknowledged_by_id"
readonly="1"
invisible="not x_fc_rush_requested"/>
</group>
<group string="Awaiting Parts">
<field name="x_fc_parts_awaiting" readonly="1"/>
<field name="x_fc_parts_eta_date" readonly="1"
invisible="not x_fc_parts_awaiting"/>
<field name="x_fc_part_order_count" readonly="1"/>
</group>
</group>
<field name="x_fc_part_order_ids" readonly="1">
<list>
<field name="name"/>
<field name="description"/>
<field name="oem_part_number"/>
<field name="quantity"/>
<field name="expected_date"/>
<field name="received_date"/>
<field name="state" widget="badge"/>
</list>
</field>
</page>
</xpath>
</field>
</record>
<!-- ============================================================== -->
<!-- Kanban: add urgency badge + intake source -->
<!-- ============================================================== -->
<record id="view_repair_order_kanban_inherit_fusion_repairs" model="ir.ui.view">
<field name="name">repair.order.kanban.inherit.fusion_repairs</field>
<field name="model">repair.order</field>
<field name="inherit_id" ref="repair.view_repair_kanban"/>
<field name="arch" type="xml">
<xpath expr="//field[@name='partner_id']" position="after">
<field name="x_fc_urgency"/>
<field name="x_fc_third_party_equipment"/>
</xpath>
</field>
</record>
<!-- ============================================================== -->
<!-- List: add urgency + source columns -->
<!-- ============================================================== -->
<record id="view_repair_order_list_inherit_fusion_repairs" model="ir.ui.view">
<field name="name">repair.order.list.inherit.fusion_repairs</field>
<field name="model">repair.order</field>
<field name="inherit_id" ref="repair.view_repair_order_tree"/>
<field name="arch" type="xml">
<xpath expr="//field[@name='partner_id']" position="after">
<field name="x_fc_urgency" widget="badge"
decoration-success="x_fc_urgency == 'normal'"
decoration-warning="x_fc_urgency == 'urgent'"
decoration-danger="x_fc_urgency == 'safety'"
optional="show"/>
<field name="x_fc_intake_source" optional="hide"/>
<field name="x_fc_third_party_equipment" optional="hide"/>
</xpath>
</field>
</record>
<!-- ============================================================== -->
<!-- New Service Call action - opens the wizard as a modal -->
<!-- ============================================================== -->
<record id="action_open_repair_intake_wizard" model="ir.actions.act_window">
<field name="name">New Service Call</field>
<field name="res_model">fusion.repair.intake.wizard</field>
<field name="view_mode">form</field>
<field name="target">new</field>
</record>
<!-- ============================================================== -->
<!-- Fusion Repairs Service Calls dashboard -->
<!-- Branded kanban / list of repair.order filtered to repairs that -->
<!-- came through one of the Fusion intake surfaces, with the -->
<!-- New Service Call wizard wired into the header. -->
<!-- ============================================================== -->
<record id="view_fusion_repair_dashboard_kanban" model="ir.ui.view">
<field name="name">repair.order.dashboard.fusion_repairs</field>
<field name="model">repair.order</field>
<field name="arch" type="xml">
<kanban default_group_by="state"
class="o_kanban_small_column o_kanban_repair_dashboard"
sample="1">
<field name="name"/>
<field name="partner_id"/>
<field name="state"/>
<field name="x_fc_urgency"/>
<field name="x_fc_third_party_equipment"/>
<field name="x_fc_repair_category_id"/>
<field name="x_fc_intake_source"/>
<field name="x_fc_estimated_cost"/>
<field name="company_currency_id"/>
<field name="schedule_date"/>
<templates>
<t t-name="card">
<div class="d-flex justify-content-between mb-2">
<strong class="o_kanban_record_title">
<field name="name"/>
</strong>
<span t-attf-class="badge {{ {'safety':'text-bg-danger','urgent':'text-bg-warning','normal':'text-bg-secondary'}[record.x_fc_urgency.raw_value] }}">
<field name="x_fc_urgency"/>
</span>
</div>
<div class="text-muted small mb-1">
<i class="fa fa-user me-1"/>
<field name="partner_id"/>
</div>
<div class="text-muted small mb-1" t-if="record.x_fc_repair_category_id.raw_value">
<i class="fa fa-wrench me-1"/>
<field name="x_fc_repair_category_id"/>
</div>
<div class="text-muted small mb-1" t-if="record.schedule_date.raw_value">
<i class="fa fa-calendar me-1"/>
<field name="schedule_date" widget="date"/>
</div>
<div class="d-flex justify-content-between mt-2">
<span class="small text-muted">
<field name="x_fc_intake_source"/>
</span>
<span t-if="record.x_fc_third_party_equipment.raw_value"
class="badge text-bg-warning small">3rd-party</span>
</div>
</t>
</templates>
</kanban>
</field>
</record>
<record id="view_fusion_repair_dashboard_search" model="ir.ui.view">
<field name="name">repair.order.search.fusion_repairs</field>
<field name="model">repair.order</field>
<field name="arch" type="xml">
<search string="Service Calls">
<field name="name"/>
<field name="partner_id"/>
<field name="x_fc_repair_category_id"/>
<filter string="Today" name="today"
domain="[('create_date', '&gt;=', datetime.datetime.combine(context_today(), datetime.time(0,0,0)))]"/>
<filter string="This Week" name="week"
domain="[('create_date', '&gt;=', datetime.datetime.combine(context_today() - datetime.timedelta(days=7), datetime.time(0,0,0)))]"/>
<separator/>
<filter string="Safety" name="safety"
domain="[('x_fc_urgency', '=', 'safety')]"/>
<filter string="Urgent" name="urgent"
domain="[('x_fc_urgency', '=', 'urgent')]"/>
<filter string="Third-Party" name="thirdparty"
domain="[('x_fc_third_party_equipment', '=', True)]"/>
<filter string="Quote Only" name="quote_only"
domain="[('x_fc_is_quote_only', '=', True)]"/>
<filter string="Rush / Emergency" name="rush"
domain="[('x_fc_rush_requested', '=', True)]"/>
<filter string="Awaiting Parts" name="awaiting_parts"
domain="[('x_fc_parts_awaiting', '=', True)]"/>
<separator/>
<filter string="From Backend Wizard" name="src_backend"
domain="[('x_fc_intake_source', '=', 'backend_wizard')]"/>
<filter string="From Sales Rep Portal" name="src_salesrep"
domain="[('x_fc_intake_source', '=', 'sales_rep_portal')]"/>
<filter string="From Client Portal" name="src_client"
domain="[('x_fc_intake_source', '=', 'client_portal')]"/>
<separator/>
<filter string="Open (not closed)" name="open"
domain="[('state', 'not in', ('done', 'cancel'))]"/>
<group>
<filter string="Status" name="group_state" context="{'group_by': 'state'}"/>
<filter string="Urgency" name="group_urgency" context="{'group_by': 'x_fc_urgency'}"/>
<filter string="Category" name="group_category" context="{'group_by': 'x_fc_repair_category_id'}"/>
<filter string="Intake Source" name="group_source" context="{'group_by': 'x_fc_intake_source'}"/>
</group>
</search>
</field>
</record>
<record id="action_fusion_repair_dashboard" model="ir.actions.act_window">
<field name="name">Service Calls</field>
<field name="res_model">repair.order</field>
<field name="view_mode">kanban,list,form</field>
<field name="search_view_id" ref="view_fusion_repair_dashboard_search"/>
<field name="context">{'search_default_open': 1}</field>
<field name="help" type="html">
<p class="o_view_nocontent_smiling_face">No service calls yet</p>
<p>
Click <strong>New</strong> in the top-left to open the guided
intake wizard. The form will walk you through caller info,
equipment selection, the issue, urgency and photos.
</p>
</field>
</record>
<record id="action_fusion_repair_dashboard_kanban" model="ir.actions.act_window.view">
<field name="sequence" eval="1"/>
<field name="view_mode">kanban</field>
<field name="view_id" ref="view_fusion_repair_dashboard_kanban"/>
<field name="act_window_id" ref="action_fusion_repair_dashboard"/>
</record>
</odoo>