docs: swager update

[oismaelash]

Description

Esta PR atualiza e melhora a documentação da API Swagger/OpenAPI do projeto. As mudanças incluem:

• Criação de modelos Swagger dedicados em pkg/core/swagger_models.go para melhor estruturação das respostas da API
• Atualização do arquivo docs/swagger.yaml com definições completas dos endpoints e modelos
• Melhoria nas anotações Swagger nos handlers para gerar documentação mais precisa
• Padronização das estruturas de resposta para erro (400, 401, 403, 404, 500) e sucesso
• Adição de exemplos (example) nos campos das estruturas para melhor visualização no Swagger UI
• Inclusão de modelos específicos para diferentes módulos: License, Call, Chat, Message, Community, Newsletter, Polls, User, Instance, Group, Label

Os modelos estão organizados por funcionalidade e incluem:

• Respostas genéricas e específicas por módulo
• Metadados de erro padronizados
• Estruturas de resposta com exemplos claros
• Suporte para todas as funcionalidades principais da API

Related Issue

Closes #(issue_number)

Type of Change

• Bug fix (non-breaking change which fixes an issue)
• New feature (non-breaking change which adds functionality)
• Breaking change (fix or feature that would cause existing functionality to not work as expected)
• Documentation update
• Refactoring (no functional changes)
• Performance improvement

Testing

• Manual testing completed
• Functionality verified in development environment
• No breaking changes introduced

Screenshots (if applicable)

Checklist

• My code follows the project's style guidelines
• I have performed a self-review of my code
• I have tested my changes thoroughly
• Any dependent changes have been merged and published

Additional Notes

• Esta branch foca apenas na melhoria da documentação Swagger, sem alterações funcionais
• Os modelos são mantidos separadamente em pkg/core/swagger_models.go para facilitar a manutenção
• O arquivo docs/swagger.yaml é gerado automaticamente a partir das anotações no código Go
• Para testar, inicie o servidor e acesse /swagger/index.html ou /api/docs

[sourcery-ai]

Sorry @oismaelash, your pull request is larger than the review limit of 150000 diff characters

[NeritonDias]

🔴 👎

Esse aqui é justamente o anti-padrão: aponta para main, está desatualizado e o diff é dominado por docs/swagger.* (que são GERADOS por swag init, não editados/commitados à mão) + ruído de sync, +39k linhas / 61 arquivos. Não commita o swagger gerado de base velha. Rebaseia em cima da develop e reabre.

@dpaes

[DavidsonGomes]

Obrigado pela contribuição! 🙏 Estamos fechando esta PR porque ela parte de um fork desatualizado e reintroduz o repositório quase inteiro (dezenas de arquivos: LICENSE, VERSION, README, artefatos de build em manager/dist, whatsmeow-lib, etc.), o que a torna não-mergeável / não-portável no estado atual — a mudança de fato fica afogada na divergência de base.

Se houver uma correção ou feature específica aqui que você acredita que ainda falta no projeto, por favor abra uma PR nova e focada (só os arquivos relevantes, a partir do branch atualizado) que teremos prazer em avaliar e integrar. Valeu pelo empenho!