chore(F6.1): stage targeted cancellation UX patch

scripts/f6-1-apply-cancel-ux.py

@@ -0,0 +1,77 @@
+from pathlib import Path
+import re
+
+path = Path('web-v2/src/pages/InspectionVisitEditorF4Page.tsx')
+text = path.read_text()
+
+state_before = "  const [success, setSuccess] = useState('');\n"
+state_after = """  const [success, setSuccess] = useState('');
+  const [showCancelForm, setShowCancelForm] = useState(false);
+  const [cancelReason, setCancelReason] = useState('');
+"""
+if text.count(state_before) != 1:
+    raise SystemExit('Could not locate success state exactly once')
+text = text.replace(state_before, state_after)
+
+lifecycle_pattern = re.compile(
+    r"  const lifecycleAction = async \(action: 'PLAN' \| 'UNPLAN' \| 'CANCEL'\) => \{.*?\n  \};\n\n  if \(loading\)",
+    re.S,
+)
+lifecycle_replacement = """  const lifecycleAction = async (action: 'PLAN' | 'UNPLAN') => {
+    if (!id) return;
+    setBusy(true); setError(''); setSuccess('');
+    try {
+      let updated: InspectionVisit;
+      if (action === 'PLAN') {
+        updated = await planInspectionVisit(id);
+        setSuccess('Inspección planificada. Ya puede iniciarse desde la APK.');
+      } else {
+        updated = await unplanInspectionVisit(id);
+        setSuccess('La Inspección volvió a borrador para corregir la planificación.');
+      }
+      applyVisit(updated);
+    } catch (requestError) { setError(errorMessage(requestError)); }
+    finally { setBusy(false); }
+  };
+
+  const cancelCurrentVisit = async (event: FormEvent) => {
+    event.preventDefault();
+    if (!id) return;
+    const reason = cancelReason.trim();
+    if (reason.length < 10) {
+      setError('El motivo de cancelación debe tener al menos 10 caracteres.');
+      return;
+    }
+    if (reason.length > 500) {
+      setError('El motivo de cancelación no puede superar los 500 caracteres.');
+      return;
+    }
+    setBusy(true); setError(''); setSuccess('');
+    try {
+      const updated = await cancelInspectionVisit(id, reason);
+      applyVisit(updated);
+      setCancelReason('');
+      setShowCancelForm(false);
+      setSuccess('Inspección cancelada. El motivo quedó registrado y auditado.');
+    } catch (requestError) { setError(errorMessage(requestError)); }
+    finally { setBusy(false); }
+  };
+
+  if (loading)"""
+text, count = lifecycle_pattern.subn(lifecycle_replacement, text, count=1)
+if count != 1:
+    raise SystemExit(f'Lifecycle block replacements: {count}')
+
+actions_pattern = re.compile(
+    r"    \{visit && <article className=\"panel survey-status-actions\">.*?</article>\}\n",
+    re.S,
+)
+actions_replacement = """    {visit && <article className=\"panel survey-status-actions\"><div><strong>Flujo de la Inspección</strong><p>La oficina planifica. El inicio y cierre operativo se realizan desde la APK. Una Inspección no puede cerrarse hasta que todas sus Actas estén selladas.</p></div><div className=\"form-actions\">{canManage && visit.status === 'DRAFT' && <button type=\"button\" className=\"button primary\" disabled={busy} onClick={() => void lifecycleAction('PLAN')}>Confirmar planificación</button>}{canManage && visit.status === 'PLANNED' && <button type=\"button\" className=\"button secondary\" disabled={busy} onClick={() => void lifecycleAction('UNPLAN')}>Volver a borrador</button>}{canManage && ['DRAFT', 'PLANNED', 'IN_PROGRESS'].includes(visit.status) && <button type=\"button\" className=\"button danger-outline\" disabled={busy} onClick={() => { setError(''); setSuccess(''); setShowCancelForm(true); }}>Cancelar inspección</button>}</div></article>}
+
+    {visit && showCancelForm && ['DRAFT', 'PLANNED', 'IN_PROGRESS'].includes(visit.status) && <form className=\"panel form-panel\" onSubmit={cancelCurrentVisit}><div className=\"panel-heading\"><div><span className=\"eyebrow\">CANCELACIÓN</span><h2>Cancelar inspección</h2><p className=\"section-copy\">La cancelación es definitiva y queda auditada. No se permite si la Inspección ya tiene un Acta sellada.</p></div></div><label className=\"field\"><span>Motivo de cancelación</span><textarea value={cancelReason} onChange={(event) => setCancelReason(event.target.value)} minLength={10} maxLength={500} rows={4} placeholder=\"Explicá el motivo de la cancelación…\" required /><small className=\"muted\">{cancelReason.trim().length}/500 · mínimo 10 caracteres</small></label><div className=\"form-actions\"><button type=\"button\" className=\"button secondary\" disabled={busy} onClick={() => { setShowCancelForm(false); setCancelReason(''); }}>Volver</button><button type=\"submit\" className=\"button danger-outline\" disabled={busy || cancelReason.trim().length < 10 || cancelReason.trim().length > 500}>{busy ? 'Cancelando…' : 'Confirmar cancelación'}</button></div></form>}
+"""
+text, count = actions_pattern.subn(actions_replacement, text, count=1)
+if count != 1:
+    raise SystemExit(f'Actions block replacements: {count}')
+
+path.write_text(text)