Nexus ITIL Service Management

Resumo técnico

Plugin nativo do NEXUS que implementa um ITSM ITIL MVP para incidentes, mudanças e problemas vinculáveis às tarefas. Registros recebem códigos sequenciais, máquinas de estado e SLA calculado por prioridade; o painel reúne operação, CAB, erros conhecidos e violações, com consulta pelo Intelligence Hub e pelo comando /itil.

Escopo executado

• plugin.json — v1.0.0, is_core: true, categoria NEXUS, ícone lucide layers com icon_bg #eff6ff, settings_route "plugin=nexus-itil-sm".
• Registros: registerTab("nexus-itil-sm", "ITIL SM", "layers", tab.php, "NEXUS") e registerDoc("nexus-itil-sm", "ITIL Service Management", "layers", doc.md).
• 8 actions de API (plugin.php, via PluginManager::registerApiAction) — itil_list (filtros type/status/q/open_only, busca LIKE em title/description/category/owner/id + match de código, ORDER BY updated_at DESC LIMIT 200, payload com stats/types/statuses), itil_get (por id ou code), itil_save (cria com itil_ + uniqid('', true) e seq MAX+1, ou atualiza; valida tipo/título ≤255/status), itil_transition (só status, com auto-flags), itil_delete, itil_lookup (data + markdown + summary para /itil), itil_stats (total, por tipo, open, sla_breached, cab_pending — change em submitted/cab_review sem aprovação —, known_errors), itil_sla_breaches (vencidos e abertos, LIMIT 50).
• Banco: itil_install() roda no load — CREATE TABLE IF NOT EXISTS itil_records com UNIQUE uq_itil_type_seq(type, seq), índices idx_itil_type_status, idx_itil_task, idx_itil_sla.
• SLA: incidente P3/P4 (priority >= 3) recebe SLA automático 8h/4h quando sla_hours não informado; sla_due_at sobre created_at; flag derivada sla_breached na leitura (itil_row_public).
• Flags automáticas: cab_approved=1 ao transicionar para approved (change); known_error=1 ao transicionar para known_error (problem) — aprovação de Change é humana, o agente de IA só sugere em comentário.
• Intelligence Hub: enricher nexus-itil-sm (prioridade 58) — itil_detect_codes() (\b(INC|CHG|PRB)-\d{1,6}\b) + itil_intel_enrich() geram artefatos itil_incident/itil_change/itil_problem (severity: sla_breached→3, priority≥3→2, senão 0; data com id/code/itil_type/itil_status/title/priority/task_id/sla_breached) ou itil_ref (severity 1, status unknown) quando o registro não existe.
• Fast Responses: fastr.json — /itil <INC-0001|CHG-0001|PRB-0001> via action itil_lookup (arg code requerido, pass_task_id: false).
• UI Alpine.js (tab.php, 419 linhas): 4 cards com barra de proporção (Total/Abertos/SLA breach/CAB pendente), link para o Compliance Hub (?plugin=nexus-compliance-hub), lista com filtros e badges CAB/KE, form com campos condicionais por tipo (Change: janela + rollback; Problem: workaround), mensagens de erro/sucesso inline.

Stack e ferramentas

• PHP 8 (sem framework, strict_types)
• MySQL 8 (itil_records — DDL no load, sem install.sql)
• Alpine.js + Tailwind CSS
• Sistema de plugins do NEXUS (PluginManager::registerTab/registerDoc/registerApiAction)
• Intelligence Hub do NEXUS (nx_intel_register_enricher)

Tags operacionais

• ITSM
• ITIL
• Incidentes
• Change
• Problemas
• CAB
• Known Error
• Plugin NEXUS
• SLA

Resultado operacional

• Fonte de verdade operacional (ITSM) no NEXUS: Incidentes, Mudanças e Problemas com código rastreável (INC-/CHG-/PRB-) e máquina de estados por tipo.
• SLA automático para incidentes P3/P4 (8h/4h) com flag de breach derivada na leitura e lista de vencidos pronta para cron/worker.
• Change com CAB humano (submitted → cab_review → approved) e atributos de RFC (janela, rollback); o agente de IA nunca aprova Change sozinho.
• Problem com known error + workaround, contados em itil_stats para o painel.
• Códigos citados em descrições/comentários são detectados pela Intelligence Hub (enricher nexus-itil-sm) com severidade proporcional ao SLA/prioridade, ou itil_ref quando o registro ainda não existe.
• Vínculo com o core de tarefas via task_id — o ITIL complementa, não substitui, o fluxo de tarefas NEXUS.