ligbox/obsidian-vault
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
obsidian-vault/ligbox-ops-platform/specs/010-desk-assist-takeover/tasks.md
Ligbox Obsidian Vault a8b62b2de1 Initial import: obsidian-infra vault
2026-06-19 17:26:42 +00:00

2.9 KiB
Raw Blame History

Tasks — Spec 010 Desk Assist & Takeover

Status: 🔄 Fase A+B+C+F entregues — Fase D (push 007) pendente
Prioridade: P0
API: 0.9.3-desk-assist-c

Fase A — Escalada + estados (VM122) ✅

  • T001 Schema: ticket status escalated|assisting|resolved + session_id, assist_mode, assisted_by
  • T002 Tabelas assist_sessions, assist_actions
  • T003 Webhook ingress onboarding.escalated + onboarding.failed → ticket escalated
  • T004 GET /api/v1/assist/sessions — merge funil + assist state
  • T005 POST /api/v1/assist/sessions/{id}/escalate — técnico puxa (≥ domain.validated)
  • T006 UI: sessões funil clicáveis + badges estado
  • T007 UI ticket/sessão: assignee + botão «Assumir sessão» + handoff
  • T008 Regra RBAC assist (permissions.py)
  • T009 Lock optimista — 409 se sessão já assisting

Fase B — ASM Takeover (VM112 + VM122) ✅

  • T010 VM112: POST .../pause, .../takeover, .../resume
  • T011 VM112: wizard ASM UI + banner «A actuar em nome do cliente»
  • T012 VM112: botão cliente «Preciso de ajuda técnica»
  • T013 Desk: POST .../takeover → chama VM112, guarda token hash
  • T014 Desk: POST .../handoff → resume cliente
  • T015 Webhooks onboarding.assist.started|ended
  • T016 Teste E2E: cliente pausado → técnico ASM → handoff → cliente retoma

Fase C — Console acções Desk ✅

  • T020 POST .../actions/{action} — proxy VM112
  • T021 Catálogo MVP: dns.revalidate, dns.reapply, account.retry_sync, infra.resync
  • T022 UI Console: painel acções + disabled se não assisting
  • T023 GET .../links — Proxmox, Carbonio, Traefik, Cloudflare (nova aba)
  • T024 Audit log cada acção em assist_actions
  • T025 onboarding.mark_step_complete + onboarding.abort (ops_lead+)

Fase F — Ranking técnicos (Roger) ✅

  • T040 GET /api/v1/assist/technicians/ranking — assumidos, escalados, acções, score
  • T041 UI Dashboard: tabela ranking 30 dias
  • T042 Audit movimento visível no console da sessão

Fase D — Integração transversal

  • T030 Spec 007: push «sessão escalada» → technician/ops_lead
  • T031 Auto-escalada onboarding.failed + stale 24h
  • T032 Docs quickstart + runbook técnico pt-BR
  • T033 Testes permissões: noc read-only, technician takeover

VM112 backlog (repo separado)

  • V112-A1 Assist API assist-v1 contract
  • V112-A2 Wizard pause overlay pt-BR
  • V112-A3 SUP-4 painel humano base

Env vars (previstas)

DESK_ASSIST_ENABLED=true
VM112_ASSIST_API=https://onboard.ligbox.com.br/api/onboarding
VM112_ASSIST_SERVICE_TOKEN=
DESK_ASSIST_MIN_STAGE=domain_validated

Dependências

  • Spec 001 ✅ webhooks + funil
  • Spec 003 ✅ RBAC
  • Spec 011 📋 OTRS futuro (não bloqueia)