bot-mwsm 3.0.2 → 3.0.4

package/.github/CODE_OF_CONDUCT.md

@@ -0,0 +1,18 @@
+# 🤝 Código de Conduta
+
+Como participantes e mantenedores do projeto **Mwsm**, comprometemo-nos a criar um ambiente acolhedor, inclusivo e respeitoso.
+
+## Comportamento esperado
+- Ser respeitoso com todos
+- Aceitar críticas construtivas
+- Colaborar de forma positiva
+
+## Comportamento inaceitável
+- Comentários ofensivos ou discriminatórios
+- Assédio ou intimidação
+- Publicação de informações privadas
+
+## Aplicação
+Violação deste código pode resultar em advertência ou banimento de participação.
+
+Para reportar incidentes, envie um e-mail para **mkcodec@proton.me**.

package/.github/CONTRIBUTING.md

@@ -0,0 +1,29 @@
+# 🧩 Guia de Contribuição
+
+Obrigado por querer contribuir com o **Mwsm**! 💙
+
+## 🚀 Como contribuir
+1. Faça um fork do repositório  
+2. Crie uma nova branch:  
+   ```bash
+   git checkout -b minha-feature
+   ```
+3. Faça suas alterações  
+4. Commit com mensagem clara:  
+   ```bash
+   git commit -m "✨ Nova funcionalidade X"
+   ```
+5. Envie seu PR (Pull Request)
+
+## 🧠 Diretrizes
+- Código limpo e comentado
+- Mensagens de commit objetivas
+- Evite dependências desnecessárias
+
+## 🧰 Ambiente recomendado
+- Node.js 18+
+- Git 2.40+
+- Editor: VSCode (com ESLint e Prettier)
+
+## 📬 Dúvidas
+Abra uma discussão em [Discussions](https://github.com/MKCodec/Mwsm/discussions).

package/.github/ISSUE_TEMPLATE/bug_report.yml

@@ -0,0 +1,56 @@
+name: "🐞 Reportar bug"
+description: Crie um relatório para nos ajudar a melhorar o Mwsm.
+title: "[BUG] Descreva o problema brevemente"
+labels: ["bug"]
+assignees: [MKCodec]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Obrigado por ajudar a melhorar o **Mwsm**! 🧩  
+        Preencha as informações abaixo com o máximo de detalhes possível.
+  - type: textarea
+    id: descricao
+    attributes:
+      label: Descrição do bug
+      description: Explique claramente o que está acontecendo.
+      placeholder: "Exemplo: O comando 'mwsm update' falha ao tentar migrar o banco."
+    validations:
+      required: true
+  - type: textarea
+    id: reproducao
+    attributes:
+      label: Passos para reproduzir
+      description: Liste as etapas para reproduzir o problema.
+      placeholder: |
+        1. Vá para '...'
+        2. Execute '...'
+        3. Veja o erro
+    validations:
+      required: true
+  - type: textarea
+    id: esperado
+    attributes:
+      label: Comportamento esperado
+      description: O que você esperava que acontecesse?
+      placeholder: "Exemplo: Esperava que a atualização fosse concluída sem erros."
+  - type: textarea
+    id: prints
+    attributes:
+      label: Capturas de tela
+      description: Se possível, adicione prints ou logs que ajudem a entender o problema.
+  - type: input
+    id: sistema
+    attributes:
+      label: Sistema operacional
+      placeholder: "Exemplo: Ubuntu 22.04 / Windows 11"
+  - type: input
+    id: versao
+    attributes:
+      label: Versão do Mwsm
+      placeholder: "Exemplo: 3.0.2"
+  - type: textarea
+    id: contexto
+    attributes:
+      label: Contexto adicional
+      description: Adicione qualquer outra informação relevante.

package/.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1,5 @@
+blank_issues_enabled: false
+contact_links:
+  - name: 💬 Suporte ou dúvidas gerais
+    url: https://github.com/MKCodec/Mwsm/discussions
+    about: Use a aba "Discussions" para dúvidas, sugestões ou feedback.

package/.github/ISSUE_TEMPLATE/feature_request.yml

@@ -0,0 +1,30 @@
+name: "🌟 Solicitar nova funcionalidade"
+description: Sugira uma ideia ou melhoria para o Mwsm.
+title: "[FEATURE] Descreva sua sugestão brevemente"
+labels: ["enhancement"]
+assignees: [MKCodec]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Quer sugerir algo novo? 🚀  
+        Conte-nos sua ideia abaixo!
+  - type: textarea
+    id: proposta
+    attributes:
+      label: Descrição da funcionalidade
+      description: Explique o que você gostaria que fosse adicionado.
+      placeholder: "Exemplo: Adicionar suporte automático a OpenRouter."
+    validations:
+      required: true
+  - type: textarea
+    id: justificativa
+    attributes:
+      label: Por que isso é útil?
+      description: Qual problema ou limitação isso resolveria?
+      placeholder: "Exemplo: Facilitaria a integração com modelos externos."
+  - type: textarea
+    id: detalhes
+    attributes:
+      label: Detalhes adicionais
+      description: Inclua ideias, exemplos ou referências.

package/.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,23 @@
+# 🔀 Pull Request
+
+## 📋 Descrição
+Explique brevemente o que foi alterado ou adicionado.
+
+## 🧩 Tipo de alteração
+- [ ] Correção de bug
+- [ ] Nova funcionalidade
+- [ ] Melhoria de código
+- [ ] Documentação
+
+## ✅ Checklist
+- [ ] Testado localmente
+- [ ] Documentação atualizada
+- [ ] Nenhum erro no build
+
+## 🧠 Contexto adicional
+Adicione observações relevantes ou links relacionados.
+
+---
+
+👤 **Autor:** @MKCodec  
+🧠 **Revisor:** @MKCodec  

package/.github/SECURITY.md

@@ -0,0 +1,17 @@
+# 🛡️ Política de Segurança
+
+Se você encontrar uma vulnerabilidade de segurança no **Mwsm**, **não abra uma issue pública**.
+
+## 📩 Como reportar
+Envie um e-mail para **mkcodec@proton.me** com:
+- Descrição clara da vulnerabilidade
+- Etapas de reprodução (se aplicável)
+- Impacto estimado
+
+## 🧭 Diretrizes
+Nós:
+- Confirmaremos o recebimento em até 48h
+- Avaliaremos a gravidade em até 7 dias
+- Corrigiremos o problema e informaremos você antes da divulgação pública
+
+Agradecemos por ajudar a manter o projeto seguro 💙

package/.github/workflows/Mwsm.yml

@@ -247,3 +247,28 @@ jobs:
           }
           echo "✅ Publicação via token concluída com sucesso!"
 
+      - name: 🐋 Build & Push Docker Image
+        if: steps.detect.outputs.DB_CHANGED == 'true'
+        env:
+          DOCKERHUB_USERNAME: ${{ secrets.DOCKERHUB_USERNAME }}
+          DOCKERHUB_TOKEN: ${{ secrets.DOCKERHUB_TOKEN }}
+        run: |
+          set -e
+          echo "🐋 Iniciando build e push da imagem Docker..."
+
+          VERSION="${{ steps.version.outputs.version }}"
+          IMAGE="${DOCKERHUB_USERNAME}/mwsm"
+
+          echo "🔐 Fazendo login no Docker Hub..."
+          echo "${DOCKERHUB_TOKEN}" | docker login -u "${DOCKERHUB_USERNAME}" --password-stdin
+
+          echo "🏗️ Construindo imagem ${IMAGE}:${VERSION}..."
+          docker buildx create --use --name builder || true
+          docker buildx build --platform linux/amd64 \
+            -t "${IMAGE}:${VERSION}" \
+            -t "${IMAGE}:latest" \
+            --push .
+
+          echo "✅ Imagem publicada com sucesso:"
+          echo "   🔹 ${IMAGE}:${VERSION}"
+          echo "   🔹 ${IMAGE}:latest"

package/.github/workflows/cleanup.yml

@@ -0,0 +1,31 @@
+name: 🧹 Actions Cleaner
+
+on:
+  workflow_dispatch:
+
+jobs:
+  clean:
+    runs-on: ubuntu-latest
+    steps:
+      - name: 🧩 Checkout
+        uses: actions/checkout@v4
+
+      - name: ⚙️ Configurar Bot-Mwsm
+        run: |
+          git config --global user.name "Bot-Mwsm 🤖"
+          git config --global user.email "143403919+MKCodec@users.noreply.github.com"
+
+      - name: 🧹 Deletar execuções antigas de workflows
+        uses: Mattraks/delete-workflow-runs@v2
+        with:
+          token: ${{ secrets.GITHUB_TOKEN }}
+          repository: ${{ github.repository }}
+          retain_days: 0
+          keep_minimum_runs: 0
+
+      - name: 🧨 Deletar artefatos antigos
+        uses: c-hive/gha-remove-artifacts@v1
+        with:
+          age: '0 days'
+          skip-tags: false
+          skip-recent: 0

package/Dockerfile

@@ -0,0 +1,42 @@
+# ========================================
+# 🐋 Mwsm - Ambiente Completo
+# ========================================
+FROM node:20-bullseye
+
+# Instalar pacotes do sistema e Python
+RUN apt-get update && apt-get install -y \
+    python3 python3-pip python3-venv sqlite3 git curl wget jq build-essential \
+    libnss3-dev libgdk-pixbuf2.0-dev libgtk-3-dev libxss-dev libasound2 \
+    ca-certificates fonts-liberation libappindicator3-1 \
+    libatk-bridge2.0-0 libatk1.0-0 libc6 libcairo2 libcups2 libdbus-1-3 \
+    libexpat1 libfontconfig1 libgbm1 libglib2.0-0 libgtk-3-0 libnspr4 libnss3 \
+    libpango-1.0-0 libpangocairo-1.0-0 libstdc++6 libx11-6 libx11-xcb1 libxcb1 \
+    libxcomposite1 libxcursor1 libxdamage1 libxext6 libxfixes3 libxi6 libxrandr2 \
+    libxrender1 libxss1 libxtst6 lsb-release xdg-utils \
+    && rm -rf /var/lib/apt/lists/*
+
+# Instalar libs Python
+RUN pip3 install --no-cache-dir \
+    flask==2.2.5 \
+    sentence-transformers==2.2.2 \
+    huggingface_hub==0.10.1 \
+    transformers==4.25.1 \
+    safetensors==0.3.1
+
+# Instalar PM2 globalmente
+RUN npm install -g pm2@latest
+
+# Criar diretório do app
+WORKDIR /var/api/Mwsm
+
+# Copiar o projeto local
+COPY . .
+
+# Instalar dependências Node
+RUN npm install --production
+
+# Expor a porta padrão
+EXPOSE 8000
+
+# Iniciar via PM2 (como no Ubuntu real)
+CMD ["pm2-runtime", "npm", "--", "run", "setup:mwsm"]

package/README.md

@@ -1,21 +1,22 @@
 <h1 align="center">📦 MkAuth WhatsApp Send Message (Mwsm)</h1>
+
 <p align="center">
   <a href="javascript:void(0)">
-          <img src="https://img.shields.io/badge/Build-3.0.2-blue?style=for-the-badge" alt="Badge">
+    <img src="https://img.shields.io/badge/Build-3.0.4-blue?style=for-the-badge" alt="Badge">
   </a>
   <a href="javascript:void(0)">
-          <img src="https://img.shields.io/badge/Update-15%2F10%2F2025%2013:20-green?style=for-the-badge" alt="Badge">
+    <img src="https://img.shields.io/badge/Update-17%2F10%2F2025%2015:00-green?style=for-the-badge" alt="Badge">
   </a>
   <a href="https://github.com/MKCodec/Mwsm">
-          <img src="https://img.shields.io/github/stars/MKCodec/Mwsm?style=for-the-badge" alt="Badge">
+    <img src="https://img.shields.io/github/stars/MKCodec/Mwsm?style=for-the-badge" alt="Badge">
   </a>
   <a href="https://github.com/MKCodec/Mwsm/issues">
-          <img src="https://img.shields.io/github/issues/MKCodec/Mwsm?style=for-the-badge" alt="Badge">
+    <img src="https://img.shields.io/github/issues/MKCodec/Mwsm?style=for-the-badge" alt="Badge">
   </a>
 </p>
 
 <p align="center">
-  <img src="https://raw.githubusercontent.com/MKCodec/Mwsm/main/img/Mwsm.png?style=for-the-badge" width="600" alt="Mwsm Logo"/>
+  <img src="https://raw.githubusercontent.com/MKCodec/Mwsm/main/img/Mwsm.png" width="600" alt="Mwsm Dashboard"/>
 </p>
 
 <h3 align="center">💖 Apoie o projeto Mwsm:</h3>
@@ -31,15 +32,15 @@
           </a>
 </p>
 
-
-
-
 ---
 
-## 🚀 Sobre o Projeto
+## 🧠 Sobre o Projeto
 
-O **Mwsm** é uma API que integra notificações automatizadas por **WhatsApp** ao sistema **MkAuth**.  
-Ela permite disparar mensagens, sincronizar cobranças e automatizar comunicações com seus clientes.
+O **Mwsm** é uma API gratuita que integra notificações automatizadas via **WhatsApp** ao sistema **MkAuth**,  
+permitindo enviar mensagens, sincronizar cobranças e gerenciar comunicações com seus clientes de forma inteligente e automatizada.
+
+> 🔗 **Toda a documentação completa (instalação, configuração e uso) está disponível no Wiki oficial:**  
+> 👉 [https://github.com/MKCodec/Mwsm/wiki](https://github.com/MKCodec/Mwsm/wiki)
 
 ---
 
@@ -52,144 +53,53 @@ Ela permite disparar mensagens, sincronizar cobranças e automatizar comunicaç
 | **GalaxPay**    | ✅ | ✅ | ✅ | ✅ | ✅ |
 | **Santander**   | ✅ | ❌ | ❌ | ❌ | ✅ |
 
-> ⚠️ Compatibilidade relatada por usuários. Pode funcionar com outros gateways não listados.
+> ⚠️ Compatibilidade relatada por usuários. Outros gateways podem funcionar normalmente.
 
 ---
 
 ## 🧠 Requisitos
 
-- Servidor Linux (Ubuntu, Debian ou Proxmox)
+- Servidor Linux (Ubuntu/Proxmox ou Debian/MkAuth)
 - [API MkAuth](https://github.com/MKCodec/MkAuth-API) modificada para uso com Mwsm
+- Conexão estável com o WhatsApp Web
 
 ---
 
-## ⚙️ Instalação
-
-### Pré-instalação
-
-Execute no MkAuth se o Mwsm for instalado separadamente:
-
-```sh
-cd ~ && sudo wget https://raw.githubusercontent.com/MKCodec/MkAuth-API/main/titulo.api -O /opt/mk-auth/api/titulo.api
-```
+## 📚 Documentação Completa
 
-### Instalação
+Acesse o **Wiki Oficial do Mwsm** e aprenda passo a passo como instalar, configurar e usar:
 
-Rode o instalador (Ubuntu/Proxmox ou Debian/MkAuth):
+> 📘 **Wiki Oficial:**  
+> [https://github.com/MKCodec/Mwsm/wiki](https://github.com/MKCodec/Mwsm/wiki)
 
-```sh
-bash <(wget -qO- "https://raw.githubusercontent.com/MKCodec/Mwsm/refs/heads/main/bash/setup.sh?nocache=$(date +%s)")
-```
+### 🔹 Seções Disponíveis:
+- **[Introdução](https://github.com/MKCodec/Mwsm/wiki/Home)** — visão geral e recursos do projeto  
+- **[Instalação](https://github.com/MKCodec/Mwsm/wiki/Instalação)** — instalação automática e pré-requisitos  
+- **[Configuração](https://github.com/MKCodec/Mwsm/wiki/Configuração)** — como ajustar e ativar o sistema  
+- **[Suporte e Integração](https://github.com/MKCodec/Mwsm/wiki/Suporte-e-Intregração)** — integrações externas e testes  
 
 ---
 
-<details>
-<summary>🧭 Configuração</summary>
-
-### 1️⃣ Ative o Túnel Dev API no MkAuth
-
-```
-Opções > Rede do Servidor > MkTunel > (Ativar e Gravar)
-```
+## 💬 Suporte e Comunidade
 
-![MkAuth Dev](https://raw.githubusercontent.com/MKCodec/Mwsm/main/img/dev.png)
+- 🧩 Fórum oficial do MkAuth:  
+  [https://mk-auth.com.br/forum/topics/envio-de-mensagem-via-whatsapp-100-gratuito](https://mk-auth.com.br/forum/topics/envio-de-mensagem-via-whatsapp-100-gratuito)
 
-### 2️⃣ Ative os Endpoints `titulo.api GET` e `cliente.api GET`
-
-```
-Provedor > Controle de Usuarios > API
-ou
-Provedor > DEV > API do Usuario
-```
-
-![Endpoints](https://raw.githubusercontent.com/MKCodec/Mwsm/main/img/endpoint.png)
-
-### 3️⃣ Acesse o servidor via IP:PORTA
-
-![Terminal](https://raw.githubusercontent.com/MKCodec/Mwsm/main/img/terminal.png)
-
-### 4️⃣ Escaneie o QR Code com o WhatsApp
-
-![QRCode](https://raw.githubusercontent.com/MKCodec/Mwsm/main/img/settings.png)
-
-### 5️⃣ Configure a API do MkAuth no Mwsm
-
-| Campo | Descrição |
-| ------ | ---------- |
-| `TUNEL` | URL do túnel configurado no MkAuth |
-| `CLIENT` | Código do cliente |
-| `SECRET` | Código secreto |
-| `DOMAIN` | Domínio/IP do servidor MkAuth |
-| `VERSION` | Selecione v1 ou v2 |
-| `MODE` | Escolha o tipo de conexão |
-
-![Sync](https://raw.githubusercontent.com/MKCodec/Mwsm/main/img/sync.png)
-
-</details>
+- 🐞 Relate bugs e sugestões:  
+  [https://github.com/MKCodec/Mwsm/issues](https://github.com/MKCodec/Mwsm/issues)
 
 ---
 
-<details>
-<summary>📊 Gerenciamento</summary>
+## 💖 Apoie o Projeto
 
-Escolha seu gerenciador principal: **MkAuth** ou **Mwsm**.
+O **Mwsm** é mantido por voluntários e distribuído gratuitamente.  
+Ajude a manter o projeto vivo e em constante evolução 💪
 
-### 🧩 MkAuth
-
-1️⃣ Configure o servidor no MkAuth seguindo as instruções do painel web.
-
-**Senha:** insira o *Token fixo* de acesso.
-
-#### MkAuth até versão 24.02
-```
-Opções > Servidor de SMS > Servidor
-```
-
-![MkAuth](https://raw.githubusercontent.com/MKCodec/Mwsm/main/img/mkauth.png)
-
-#### MkAuth 24.03 ou superior
-```
-Opções > Servidor de WhatsApp > Servidor
-```
-
-![WhatsApp](https://raw.githubusercontent.com/MKCodec/Mwsm/main/img/whatsapp.png)
-
-### 🧩 Mwsm
-
-No Mwsm:
-
-```
-Settings > API > Tela 2
-```
-
-As mensagens são disparadas conforme o agendamento configurado na API.
-
-![Autobot](https://raw.githubusercontent.com/MKCodec/Mwsm/main/img/autobot.png)
-
-</details>
-
----
-
-## 💬 Dúvidas, Erros e Suporte
-
-Se ocorrerem erros, ative o modo **Debug** em:
-
-```
-Settings > Extras > Debug ON
-```
-
-Em caso de persistência, visite o fórum oficial:  
-🔗 [https://mk-auth.com.br/forum/topics/envio-de-mensagem-via-whatsapp-100-gratuito](https://mk-auth.com.br/forum/topics/envio-de-mensagem-via-whatsapp-100-gratuito)
-
----
-
-## 💖 Doações PIX
-
-Apoie o projeto e ajude a manter o **Mwsm** gratuito e atualizado.
+## 💸 Doações PIX
 
 ![Pix](https://github.com/user-attachments/assets/53092d48-c31b-430b-bc10-68ba5b43f7c2)
 
-**Chave:**  
+**Chave Aleatória:**
 ```sh
 e9b9d669-4412-4dec-994c-310005904088
 ```
@@ -198,7 +108,3 @@ e9b9d669-4412-4dec-994c-310005904088
 ```sh
 00020126580014BR.GOV.BCB.PIX0136e9b9d669-4412-4dec-994c-3100059040885204000053039865802BR5924CLEBER FERREIRA DE SOUZA6007CARUARU62070503***63045854
 ```
-
----
-
-<p align="center">© 2025 MkAuth WhatsApp Send Message - Desenvolvido por MKCodec</p>