fusion_claims: MOD workflow rework — two-assessment split, 3 submission paths, recovery actions (v19.0.8.0.3)

Reworks the March of Dimes workflow to match reality: the OT does their own
disability assessment and provides the VOD letter; our accessibility specialist
then visits to produce the proposal/drawings/quote; and the application can be
submitted by us (internal), the client, or the authorizer themselves. The old
workflow flattened all this into one assessment state with a dead-end
funding_denied and no document tracking.

Data model (13 new sale.order fields):
- 5 new document binaries + filenames: VOD letter, Application Form (filled),
  Notice of Assessment, Property Tax, Proposal Document
- x_fc_mod_submitted_by Selection (internal/client/authorizer)
- x_fc_mod_handoff_date, x_fc_mod_vod_requested_date
- x_fc_mod_accessibility_specialist_id (m2o res.partner — internal or external)
- x_fc_mod_previous_status_before_hold (for proper resume)
- x_fc_mod_funding_denial_reason (captured via wizard)

Settings (4 res.company fields + res_config_settings mirrors):
- x_fc_mod_application_form (blank) + filename
- x_fc_mod_vod_form (blank) + filename
- x_fc_mod_followup_assignee_mode (office_contact / sales_rep)
- x_fc_mod_followup_office_contact_id

res.partner: added 'accessibility_specialist' to x_fc_contact_type.

State machine:
- New state handoff_to_client between quote_submitted and awaiting_funding,
  used for paths B/C (client or authorizer submits themselves)
- Fixed action_mod_on_hold to save x_fc_mod_previous_status_before_hold
- Fixed action_mod_resume to restore previous status (was hardcoded to
  in_production, losing context for cases held earlier)

4 new wizards:
- mod_submission_path_wizard — chooses submitted_by, auto-fires VOD request
  email on first switch to 'internal'
- mod_funding_denied_wizard — captures denial category + reason
- mod_resubmit_wizard — revises + resubmits denied cases (with optional
  doc clearing)
- mod_submission_confirmed_wizard — records client/authorizer confirmed
  submission, advances to awaiting_funding

8 new action methods:
- action_mod_set_submission_path, action_mod_request_vod,
  action_mod_handoff_to_client (validates docs, fires handoff email),
  action_mod_confirmed_submission, action_mod_resubmit_from_denied,
  action_mod_cancel_from_denied, action_mod_reopen_cancelled
- action_mod_funding_denied now opens the denial wizard

3 new email methods + 2 existing fixes:
- _send_mod_vod_request_email — auto-attaches blank VOD form from company
  settings, sent to authorizer when we are handling submission
- _send_mod_handoff_email — two templates (client vs authorizer), attaches
  proposal + drawing + blank MOD Application Form
- _mod_company_attachment helper for building attachments from company Binary
- Fixed _send_mod_assessment_completed_email to include authorizer
- Fixed _send_mod_pod_submitted_email to include client

New cron:
- _cron_mod_handoff_followup (daily 09:00) — creates mail.activity for office
  to confirm MOD submission. Assignee via company setting (office contact or
  sales rep). Uses existing rolling-window cap (2/month per order).

Views:
- sale_order form: new status-bar buttons (set path, request VOD, handoff,
  confirm, resubmit, cancel, reopen), new document section in MOD Documents
  tab with submission-path tracking, denial details, hold history
- res_config_settings: new MOD blank forms upload + assignee config

Deployed to odoo-westin (westin-v19) and odoo-mobility (mobility). Pre-deploy
FK cleanup from earlier session means mobility updated cleanly without
workaround. HTTP 200 on both, cron verified active, all new fields present.

fusion_claims/wizard/mod_submission_path_wizard.py

@@ -0,0 +1,76 @@
+# -*- coding: utf-8 -*-
+# Copyright 2024-2026 Nexa Systems Inc.
+# License OPL-1 (Odoo Proprietary License v1.0)
+"""
+MOD Submission Path Wizard — asks the office which party is submitting the
+March of Dimes application. Sets x_fc_mod_submitted_by on the order and,
+when the path is 'internal', auto-triggers the VOD request email to the
+authorizer the first time it is selected.
+"""
+from odoo import models, fields, api, _
+from odoo.exceptions import UserError
+from markupsafe import Markup
+
+
+class ModSubmissionPathWizard(models.TransientModel):
+    _name = 'fusion_claims.mod.submission.path.wizard'
+    _description = 'MOD - Set Submission Path'
+
+    sale_order_id = fields.Many2one('sale.order', required=True, readonly=True)
+    submitted_by = fields.Selection(
+        selection=[
+            ('internal', 'We submit on client\'s behalf'),
+            ('client', 'Client submits themselves'),
+            ('authorizer', 'Authorizer (OT) submits'),
+        ],
+        string='Who is submitting to March of Dimes?',
+        required=True,
+    )
+    notes = fields.Text(string='Notes')
+
+    @api.model
+    def default_get(self, fields_list):
+        res = super().default_get(fields_list)
+        if self.env.context.get('active_id'):
+            order = self.env['sale.order'].browse(self.env.context['active_id'])
+            res['sale_order_id'] = order.id
+            if order.x_fc_mod_submitted_by:
+                res['submitted_by'] = order.x_fc_mod_submitted_by
+        return res
+
+    def action_confirm(self):
+        self.ensure_one()
+        order = self.sale_order_id
+        previous = order.x_fc_mod_submitted_by
+        vals = {'x_fc_mod_submitted_by': self.submitted_by}
+        order.with_context(skip_status_emails=True).write(vals)
+
+        labels = dict(self._fields['submitted_by'].selection)
+        body = (
+            f'<div class="alert alert-info" role="alert">'
+            f'<strong>MOD submission path set:</strong> {labels[self.submitted_by]}'
+        )
+        if self.notes:
+            body += f'<br/>{self.notes}'
+        body += '</div>'
+        order.message_post(
+            body=Markup(body),
+            message_type='notification',
+            subtype_xmlid='mail.mt_note',
+        )
+
+        # First-time internal path → auto-trigger the VOD request email so
+        # the authorizer knows to fill and send the VOD form back.
+        if (
+            self.submitted_by == 'internal'
+            and previous != 'internal'
+            and not order.x_fc_mod_vod_requested_date
+        ):
+            try:
+                order._send_mod_vod_request_email()
+            except Exception:
+                # Don't block the wizard if the email fails — office can
+                # retry via the manual "Request VOD" button.
+                pass
+
+        return {'type': 'ir.actions.act_window_close'}