admin/Odoo-Modules
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

feat(fusion_repairs): Bundle 2 - weekend self-service (CL6/CL7 + CL15 + CL17)

Browse Source 
CL6/CL7 AI self-check engine
- New fusion.repair.ai.service AbstractModel with single guardrailed
  suggest_self_check(category_id, symptoms, urgency) entry point.
- Hard-escalation FIRST (before any AI call): stairlift / porch lift +
  safety symptoms (smoke / burning / spark / stuck / motor), OR any
  mention of fire / injury / hurt / bleeding / trapped, OR urgency=safety
  -> escalate immediately regardless of AI availability.
- AI call via fusion.api.service.call_openai() (consumer='fusion_repairs',
  feature='client_self_triage') with try/fallback per project rule -
  no hard fusion_api dep, no install error if it's missing.
- Strict response validation: JSON schema check, max 3 steps, max 200
  chars per field, forbidden-phrase regex (diagnose, you have, medical
  condition, stop using, consult doctor, price patterns) - on any
  failure falls back to deterministic rules.
- 24h in-memory cache keyed by (category, symptom_hash) so repeat calls
  during AI cost-cap incidents come from cache.
- System prompt + JSON schema published as ir.config_parameter so office
  can refine without code changes (default prompt + schema in spec
  Appendix A).
- New fusion.repair.self.check.rule model + 17 seeded rules across all
  7 product categories (data/self_check_data.xml) - these are the
  deterministic fallback AND the canonical seed if AI is disabled.
- New /repair/self_check jsonrpc route (auth=public) gated by the
  per-IP rate-limit; defensive input bounds (max 5 symptoms, 500 chars
  each) defend against prompt-injection bloat.

CL15 weekend safety escalation + on-call paging
- New fusion.repair.on.call.service AbstractModel with:
  * find_next_on_call(exclude=...) -> lowest x_fc_on_call_priority
  * page_on_call(repair) -> sends mail to next available + writes
    x_fc_on_call_token / x_fc_on_call_paged_user_id / paged_at on the
    repair, posts chatter
  * acknowledge(repair, user) -> records ack, posts chatter
  * cron_escalate_unacknowledged() -> every 5 min, re-pages the next
    priority for repairs paged >15 min ago without ack
- Auto-fires from intake service whenever x_fc_urgency='safety' is
  submitted. _is_business_hours() defaults to "page" when no calendar
  is set or after working hours.
- New email_template_on_call_page with 4px red accent + acknowledge
  CTA button linking to /repair/on-call/ack/<token>.
- /repair/on-call/ack/<token> http route (auth=user, must be the paged
  manager OR any internal user) records the ack and renders confirmation.
- 5-minute cron 'Fusion Repairs: Escalate unacknowledged on-call pages'
  with configurable window via fusion_repairs.on_call_escalate_minutes
  (default 15).
- New repair.order fields x_fc_on_call_token, x_fc_on_call_paged_user_id,
  x_fc_on_call_paged_at, x_fc_on_call_acknowledged_user_ids,
  x_fc_on_call_acknowledged_at - all copy=False so duplicates start fresh.

CL17 QR sticker generator
- New fusion.repair.qr.sticker.wizard TransientModel takes a Many2many
  of stock.lot records (optionally filtered by product).
- QWeb PDF report fusion_repairs.report_qr_stickers prints a 4-up
  sticker sheet on letter paper: 80mm x 50mm per sticker with the
  QR code (38mm), product name, serial number, and the canonical
  portal URL (from web.base.url + fusion_repairs.client_portal_url).
- QR encodes /repair?sn=<serial> which the public client portal
  already pre-fills via the ?sn= query param.
- Uses the qrcode library if available; renders 'QR lib missing'
  placeholder otherwise so the PDF still prints.
- New menu Configuration > Generate QR Stickers + standalone wizard.

Verified end-to-end on local westin-v19:
  CL6 stairlift+smoke -> escalate=True source=escalated reason=safety
  CL6 bed (no AI) -> fallback returned escalate=True (safe default)
  CL15 admin paged for RO-202605-10 with 27-char token
  CL17 sticker URL: /repair?sn=001124032521528404
       QR data URI: data:image/png;base64,iVBORw... (PNG OK)

Bumped to 19.0.1.2.0 (minor bump - new public-facing capabilities).

Co-authored-by: Cursor <cursoragent@cursor.com>
This commit is contained in:
gsinghpal
2026-05-20 23:40:52 -04:00
parent 3a15164605
commit 5c8768c556
18 changed files with 1146 additions and 1 deletions
Download Patch File Download Diff File Expand all files Collapse all files

172
fusion_repairs/models/repair_on_call_service.py Normal file
View File

@@ -0,0 +1,172 @@
# -*- coding: utf-8 -*-
# Copyright 2024-2026 Nexa Systems Inc.
# License OPL-1 (Odoo Proprietary License v1.0)
"""On-call service - finds the next on-call manager and pages them.
Triggered when a safety-flagged repair comes in outside business hours
(or any time, if the user wants to call us about a stuck stairlift).
Per the design spec section "Weekend safety escalation":
1. 911 disclaimer is shown to the client
2. repair.order created with priority=high + Monday-followup activity
3. Page next on-call manager (lowest x_fc_on_call_priority among
active users with x_fc_on_call=True)
4. SMS + email sent; tokenized /repair/on-call/ack/<token> for ack
5. 15-minute escalation cron pages next priority if first doesn't ack
6. All actions logged to repair chatter
Phase 2 ships with priority-int sorting; Phase 4 will replace with proper
shift scheduling (date ranges per on-call user).
"""
import logging
import secrets
from datetime import timedelta
from markupsafe import Markup
from odoo import _, api, fields, models
_logger = logging.getLogger(__name__)
class FusionRepairOnCallService(models.AbstractModel):
_name = 'fusion.repair.on.call.service'
_description = 'Repair On-Call Paging Service'
# ------------------------------------------------------------------
# PUBLIC API
# ------------------------------------------------------------------
@api.model
def find_next_on_call(self, exclude_user_ids=None):
"""Return the highest-priority active on-call user, or empty recordset."""
exclude_user_ids = exclude_user_ids or []
Users = self.env['res.users'].sudo()
return Users.search([
('x_fc_on_call', '=', True),
('active', '=', True),
('id', 'not in', exclude_user_ids),
], order='x_fc_on_call_priority asc, id asc', limit=1)
@api.model
def page_on_call(self, repair, force=False):
"""Page the next on-call manager for the given repair.
Skips if outside business hours check disabled OR already paged
unless force=True. Returns the paged user or empty recordset.
"""
repair.ensure_one()
if not force and self._is_business_hours():
_logger.info('On-call page skipped for %s - inside business hours',
repair.name)
return self.env['res.users']
# Don't re-page a repair that's already been paged in this cycle.
already_paged = repair.x_fc_on_call_acknowledged_user_ids.ids
target = self.find_next_on_call(exclude_user_ids=already_paged)
if not target:
self._notify_office_no_oncall(repair)
return self.env['res.users']
token = secrets.token_urlsafe(20)
repair.write({
'x_fc_on_call_token': token,
'x_fc_on_call_paged_user_id': target.id,
'x_fc_on_call_paged_at': fields.Datetime.now(),
})
self._send_page_email(repair, target, token)
self._post_chatter(repair, target)
return target
@api.model
def acknowledge(self, repair, user):
"""Mark a repair's on-call page as acknowledged by `user`."""
repair.ensure_one()
repair.x_fc_on_call_acknowledged_user_ids = [(4, user.id)]
repair.x_fc_on_call_acknowledged_at = fields.Datetime.now()
repair.message_post(body=Markup(_(
'On-call page <b>acknowledged</b> by %s.'
)) % (user.name or user.login or ''))
@api.model
def cron_escalate_unacknowledged(self):
"""Cron: re-page the next priority for any repair whose first page
is older than 15 minutes without acknowledgement."""
ICP = self.env['ir.config_parameter'].sudo()
try:
window_min = int(ICP.get_param(
'fusion_repairs.on_call_escalate_minutes', '15'
))
except (ValueError, TypeError):
window_min = 15
cutoff = fields.Datetime.now() - timedelta(minutes=window_min)
Repair = self.env['repair.order'].sudo()
stale = Repair.search([
('x_fc_on_call_paged_at', '!=', False),
('x_fc_on_call_paged_at', '<=', cutoff),
('x_fc_on_call_acknowledged_at', '=', False),
('state', 'not in', ('done', 'cancel')),
])
for r in stale:
already = r.x_fc_on_call_acknowledged_user_ids.ids + [
r.x_fc_on_call_paged_user_id.id
]
self.page_on_call(r, force=True)
# ------------------------------------------------------------------
# HELPERS
# ------------------------------------------------------------------
@api.model
def _is_business_hours(self):
"""True when within the company resource_calendar's working time."""
cal = self.env.company.resource_calendar_id
if not cal:
return False # Treat "no calendar" as always after-hours so we always page.
now = fields.Datetime.now()
try:
return bool(cal._work_intervals_batch(now, now)[False])
except Exception:
return False
@api.model
def _send_page_email(self, repair, target, token):
try:
tpl = self.env.ref(
'fusion_repairs.email_template_on_call_page',
raise_if_not_found=False,
)
if tpl:
tpl.with_context(
on_call_token=token,
on_call_user=target,
).send_mail(repair.id, force_send=False, email_values={
'email_to': target.email or target.partner_id.email or '',
})
except Exception as e:
_logger.warning('On-call page email failed for repair %s: %s',
repair.name, e)
@api.model
def _post_chatter(self, repair, target):
repair.message_post(body=Markup(_(
'After-hours <b>safety paged</b> %(name)s '
'(priority %(p)s). Awaiting acknowledgement.'
)) % {
'name': target.name or target.login or '',
'p': str(target.x_fc_on_call_priority or 99),
})
@api.model
def _notify_office_no_oncall(self, repair):
_logger.error(
'No on-call user configured (x_fc_on_call=True) - safety repair '
'%s will queue for Monday with no page.',
repair.name,
)
repair.message_post(body=Markup(_(
'<span style="color:#c00"><b>WARNING:</b> No on-call user '
'configured. This safety repair was queued but no one was paged. '
'Configure x_fc_on_call on a manager.</span>'
)))