NEXUS Social Accounts

Resumo técnico

O NEXUS Social Accounts centraliza as contas de redes sociais do NEXUS organizadas por projeto, com tabela MySQL própria e CRUD completo (listar, criar, atualizar e excluir) exposto pela API. A aba Social no painel exibe as contas agrupadas por projeto com avatar de marca em cores oficiais, busca e filtros por status, e o frontend usa um mixin Alpine.js com atualização otimista ao salvar ou excluir.

Escopo executado

• Registro do plugin em plugin.php (13 linhas): registerTab('social', tab.php) com ícone share-2, registerDoc('social-accounts', doc.md), registerModal('social-account', modals/social-account.php), registerJs('social', assets/social.js) e style: design.css em plugin.json.
• Banco de dados: tabela MySQL social_accounts (id INT PK, project_id VARCHAR(64) FK para projects.id, platform VARCHAR(100), url VARCHAR(255), username VARCHAR(255), email VARCHAR(255), login_type VARCHAR(50), status VARCHAR(50)) — sem install.sql, DDL documentado no README.
• Backend (backend.php, 81 linhas): social_accounts_read_grouped() (JOIN indireto — busca projects em ordem alfabética e filtra as contas por project_id), social_account_get() (busca por id), social_account_save() (INSERT ou UPDATE com os 7 campos) e social_account_delete() (exclusão por id).
• API com 6 actions: social_list/social_accounts_list (contas agrupadas por projeto), social_save/social_accounts_save (criar/atualizar) e social_delete/social_accounts_delete (excluir) — aliases para compatibilidade.
• Aba Social (tab.php, 249 linhas): stats grid clicável (Total/Criadas/Pendentes/Em Revisão que aplicam filtro de status), toolbar premium com busca e badge de filtro ativo, grupos colapsáveis por projeto e tabela com avatar da marca em cores oficiais.
• Paleta de marcas (socialPlatformMeta em social.js): mapa com 28 entradas (Facebook #1877F2, Instagram gradiente, Twitter/X #1DA1F2/#000, LinkedIn #0A66C2, YouTube #FF0000, TikTok, GitHub #24292e, Discord #5865F2, Telegram #26A5E4, WhatsApp #25D366, Pinterest #E60023, Reddit #FF4500, Twitch #9146FF, Spotify #1DB954, Medium, Behance #1769FF, Dribbble #EA4C89, ProductHunt #DA552F, DevTo, GitLab #FC6D26, Gravatar #1E8CBE, Meetup #ED1C40, Patreon #FF424D, Etsy #F56400, Arduino #00979D, E-mail, Google #DB4437, Apple #000) com fallback indigo.
• Frontend (assets/social.js, 190 linhas): mixin Alpine socialModule(initialGroups) compatível com spread no x-data global — estado (socialGroups, socialForm, socialSearch, socialFilterStatus), 9 tipos de login (E-mail, Google, Facebook, Instagram, Twitter/X, GitHub, LinkedIn, Apple, Outro) e chamadas à API com Bearer token.
• Atualização otimista: exclusão remove a conta da lista imediatamente; salvamento (criar/editar) recarrega os grupos via social_list e exibe toast de confirmação.
• Modal (modals/social-account.php): formulário "Nova/Editar Conta Social" com campos platform, url, username, email, login_type e status, usando x-teleport + trap de foco.
• Fast Responses: manifesto fastr.json com /social (sem arg obrigatório), action social_list — lista as contas cadastradas.
• Sob demanda: cronjob.json com jobs: [] (nenhuma rotina periódica necessária); sem CLI.
• Documentação registrada via registerDoc (doc.md): hub de contas sociais com estrutura do banco e funções.

Stack e ferramentas

• PHP 8 backend (sem framework) + MySQL (social_accounts)
• Alpine.js (mixin socialModule) + Tailwind CSS (aba, modal e empty state)
• Plugin API interno: PluginManager tabs/docs/modals/js/actions + fastr.json
• Autenticação via Bearer token (API_KEY) nas chamadas de API

Tags operacionais

• Social
• Redes sociais
• Contas
• CRUD
• Integrações
• Automação
• Gestão
• Plugin NEXUS

Resultado operacional

• Centralização por projeto: contas agrupadas por projeto com contagem e acesso rápido.
• CRUD completo via API: listar, criar, atualizar e excluir — com aliases para compatibilidade.
• Visual de marca: avatar com cor oficial e letra distintiva para 23+ plataformas.
• Filtros rápidos: stats clicáveis por status (Criada, Pendente, Em Revisão) + busca por plataforma/usuário/e-mail/URL.
• UX reativa: atualização otimista na exclusão e toasts de confirmação.
• Sem rotinas: plugin puramente sob demanda — sem cron nem CLI.