NEXUS 5W2H

Resumo técnico

Plugin NEXUS que aplica a metodologia 5W2H (What, Why, Where, When, Who, How, How Much) para criar planos de ação com delegação clara de responsáveis e controle de custos — com conversão em 1 clique em tarefa NEXUS, snippets Markdown para reuniões e monitoramento financeiro do investimento estimado.

Escopo executado

• plugin.json: v1.0.0, slug nexus-5w2h ("Matriz 5W2H & Delegação"), categoria "Gestão & Produtividade" (aba Gestão & Produtividade, ícone clipboard, is_core: false).
• Config (DB::getConfig('nexus_5w2h_settings')): currency_symbol (R$), auto_create_task (false), default_project (Geral) — salvos com validação de valores vazios.
• Tabela nexus_5w2h_plans — criada lazy (fivew2h_install, CREATE TABLE IF NOT EXISTS com static $installed; sem migrations): id, task_id (VARCHAR 64, idx_task_id), project (default Geral), title, what_action, why_reason, where_location, when_deadline (DATETIME), who_responsible, how_method, how_much_cost (VARCHAR, default R$ 0,00), status, priority, created_by, created_at, updated_at (ON UPDATE CURRENT_TIMESTAMP); índices idx_project, idx_status, idx_who; InnoDB utf8mb4_unicode_ci.
• Validações do save — What e Who obrigatórios (mensagens em PT); title fallback = 80 primeiros chars do What; when_deadline via strtotime/date; status whitelist pending|in_progress|completed|cancelled; priority clamp 1–4 (default 2).
• Conversão em tarefa (fivew2h_convert_to_task) — bloqueia re-conversão (task_id preenchido → retorna o vínculo existente); descrição Markdown com os 7 pilares formatados (### 📋 Plano de Ação 5W2H + defaults Não especificado/Geral / Servidor/A definir/Seguir procedimentos padrão); tarefa [5W2H] <título> com project/priority do plano — via task_create() quando disponível, senão INSERT direto (id task_+uniqid, seq = MAX(seq)+1, status pending); plano ganha task_id e status in_progress.
• Listagem (fivew2h_list) — filtros project (≠ all), status, responsible e busca LIKE em 5 campos; limit 1–100 (default 50), offset; retorna total, itens, responsáveis únicos (DISTINCT) e stats.
• KPIs (fivew2h_stats) — total, pending, in_progress, completed, linked_tasks (planos vinculados a tarefa).
• API: 8 actions (fivew2h_list, fivew2h_get, fivew2h_save, fivew2h_delete, fivew2h_convert, fivew2h_stats, fivew2h_settings, fivew2h_settings_save).
• Fastr — trigger /5w2h (o manifesto usa trigger, não command) → fivew2h_list.
• UI Alpine.js (tab.php, 42 KB) — tema slate (cinza) com destaques emerald-600 (ações), indigo (converter) e amber (snippet); aba Gestão & Produtividade; 5 KPI cards (Total, Pendentes, Em Andamento, Concluídos, Convertidos em Tarefa); busca com debounce 300ms + filtros de status/responsável; cards de planos com Converter em Tarefa (só quando não vinculado) e Copiar Snippet Markdown; formulário guiado dos 7 pilares (Who obrigatório no form, What no backend); configurações (símbolo da moeda, projeto padrão, auto-conversão); toasts de feedback.
• Sem i18n (textos em português).

Stack e ferramentas

• PHP 8 (sem framework)
• MySQL 8 (nexus_5w2h_plans + tasks na conversão)
• Alpine.js + Tailwind CSS (premium light, slate/emerald)
• Plugin NEXUS (PluginManager: tabs, API actions, Fastr)

Tags operacionais

• 5W2H
• Matriz 5W2H
• Delegação
• Plano de Ação
• Gestão
• Produtividade
• Plugin NEXUS

Resultado operacional

• Delegação transparente: cada plano responde às 7 perguntas da metodologia com responsável (Who) e prazo (When) obrigatórios.
• Conversão em 1 clique: matriz vira tarefa NEXUS com descrição Markdown formatada dos 7 pilares — sem retrabalho manual.
• Controle financeiro: campo *How Much* com símbolo de moeda configurável e monitoramento do investimento estimado por plano.
• Alinhamento rápido: snippets Markdown copiáveis para e-mails e reuniões.
• Rastreabilidade: vínculo plano ↔ tarefa preservado (task_id), KPIs por status e filtros por projeto/responsável.
• Zero dependência de cron: instalação lazy do schema e conversão sob demanda — sem rotinas agendadas.
• Comando /5w2h no chat.