Skip to content

README_PT.md

Latest commit

 

History

History
566 lines (400 loc) · 67 KB

README_PT.md

File metadata and controls

566 lines (400 loc) · 67 KB

Com muito cuidado # ForexSignalBot: Sinais de Forex no Telegram com IA / Encaminhador Automático Inteligente Gratuito de Código Aberto para Bots do Telegram 📈🤖✨🚀

License GitHub Stars GitHub Forks GitHub Issues GitHub Closed Issues GitHub Pull Requests GitHub Closed Pull Requests Test Coverage Top Language .NET Version Last Commit Commit Activity Code Size Contributors GitHub Repo stars

🚀 Comece Agora!

Demonstração do ForexSignalBot

🚀 Primeiros Passos

Pode executar este projeto de duas formas: com Docker (recomendado para uma configuração rápida) ou configurando um ambiente local manualmente.

Opção 1: Início Rápido com Docker (Recomendado)

Coloque toda a pilha da aplicação — API, base de dados PostgreSQL e cache Redis — a funcionar em minutos com o Docker. Esta é a forma mais rápida e fácil de começar.

Pré-requisitos

Passo 1: Clonar o Repositório

Abra o seu terminal e clone o código-fonte do projeto.

git clone https://github.com/Opselon/ForexTradingBot.git
cd ForexTradingBot

Passo 2: Configure os Seus Segredos

A aplicação requer chaves de API e passwords. Usamos um ficheiro .env para isso, que é mantido privado.

  1. Crie o ficheiro de ambiente:

    cp .env.example .env

  2. Edite o ficheiro .env: Abra o novo ficheiro .env e preencha com os seus valores secretos reais.

    • TELEGRAM_BOT_TOKEN: Obtenha-o no @BotFather no Telegram.
    • POSTGRES_PASSWORD: Crie uma password forte e segura para a sua base de dados.

Passo 3: Execute a Aplicação! 🔥

Com o Docker a correr, execute um único comando a partir do diretório raiz do projeto:

docker-compose up --build -d

Este comando constrói e inicia os contentores da API, PostgreSQL e Redis. A API está configurada para aplicar automaticamente as migrações da base de dados no arranque.

Passo 4: Povoar a Base de Dados

O bot precisa de uma lista inicial de feeds RSS. Conecte-se à base de dados usando um cliente como o DBeaver ou o DataGrip e execute o script Populate_RssSources_Categories.sql.

  • Host: localhost
  • Port: 5432
  • Base de Dados: forexsignalbot_db
  • Utilizador: postgres
  • Password: A POSTGRES_PASSWORD que definiu no .env.

🎉 É isso! O seu bot está agora a correr dentro do Docker.

Opção 2: Configuração de Desenvolvimento Local (Sem Docker)

Siga estes passos se preferir executar a aplicação diretamente na sua máquina.

Pré-requisitos

  1. .NET 9 SDK:

  2. Base de Dados PostgreSQL:

    • Instale e execute um servidor PostgreSQL local.
    • Crie uma base de dados e um utilizador.
    • Atualize a sua connection string no ficheiro appsettings.Development.json.

  3. Servidor Redis:

    • O Redis é usado para caching e processamento de tarefas em segundo plano.
    • Para Windows: Instale um servidor compatível com Redis como o Memurai.
    • Para macOS/Linux: Instale através de um gestor de pacotes (ex: brew install redis ou sudo apt-get install redis-server).

Executar a Aplicação Localmente

Para programadores que preferem executar a aplicação diretamente na sua máquina, sigam estes passos:

  1. Clone o repositório (se ainda não o fez).
  2. Configure o appsettings.Development.json com a sua connection string da base de dados local e outras definições.
  3. Aplique as migrações da base de dados: 
    dotnet ef database update --startup-project WebApi --project Infrastructure
  4. Povoe a base de dados executando o script Populate_RssSources_Categories.sql na sua base de dados local.
  5. Execute a API: 
    dotnet run --project WebApi

Para detalhes mais abrangentes e instruções de implementação em produção, por favor consulte o guia dedicado INSTALL.md.

🛠️ Guia do Desenvolvedor

Esta secção contém comandos comuns para o desenvolvimento.

Gerir Migrações da Base de Dados

Antes de executar estes comandos, certifique-se de que tem as ferramentas do EF Core instaladas: dotnet tool install --global dotnet-ef

  • Adicionar uma Nova Migração: Quando alterar um modelo de domínio, crie uma nova migração.

    dotnet ef migrations add OSeuNomeDeMigracao --startup-project WebApi --project Infrastructure

    (Substitua OSeuNomeDeMigracao por um nome descritivo, ex: AddSignalStatus)

  • Aplicar Migrações: Para atualizar manualmente o esquema da base de dados.

    dotnet ef database update --startup-project WebApi --project Infrastructure

Criar uma Build de Produção

Para compilar a aplicação num executável autónomo para implementação:

# Exemplo para uma build autónoma para Windows x64
dotnet publish --configuration Release --runtime win-x64 --self-contained true --project WebApi
  • O resultado estará na pasta WebApi/bin/Release/net9.0/win-x64/publish.

Passo 4: O Assistente de Configuração Web ✨

Este é o novo processo de configuração simplificado.

  1. Abra o Painel Web: Navegue para http://localhost:5000/login.html no seu browser.
  2. Login: Use as credenciais padrão:
    • Nome de utilizador: admin
    • Password: admin (Será solicitado a alterar estes detalhes sensíveis durante o processo de configuração inicial na interface web para maior segurança.)
  3. Configuração Guiada: Após o primeiro login, será automaticamente redirecionado para uma página de configuração segura (/indexapp.html).
    • Nesta página, ser-lhe-á pedido para introduzir o seu Token do Bot do Telegram e outras configurações centrais.
    • O sistema irá testar ao vivo as suas credenciais para garantir que são válidas antes de as guardar.
    • Uma vez guardadas, estas configurações são armazenadas de forma segura na base de dados, e não em ficheiros de texto simples.
  4. Povoamento da Base de Dados: Após a configuração inicial, ser-lhe-á pedido para povoar a base de dados. Clique no botão "Seed Database" na interface web. Isto irá preencher a lista inicial de feeds RSS e outros dados necessários.

🎉 É isso! O seu bot está agora totalmente configurado e a funcionar. Pode gerir tudo a partir do painel web. alt text

🌟 Stargazers ao longo do tempo

Se este projeto lhe for útil, talvez queira dar-lhe uma 🌟 Stargazers over time

🌍 Ficheiros README Multilingues 🌍

Disponibilizamos ficheiros README em vários idiomas para tornar o nosso projeto acessível a utilizadores de todo o mundo. Escolha o seu idioma preferido abaixo:

Idioma Código do Idioma Ficheiro README Estado
Inglês 🇺🇸 EN README.md ✅ Completo
Russo 🇷🇺 RU README_RU.md ✅ Completo
Persa 🇮🇷 FA README_FA.md ✅ Completo
Chinês 🇨🇳 ZH README_ZH.md ✅ Completo
Espanhol 🇪🇸 ES README_ES.md ✅ Completo
Francês 🇫🇷 FR README_FR.md ✅ Completo
Alemão 🇩🇪 DE README_DE.md ✅ Completo
Turco 🇹🇷 TR README_TR.md ✅ Completo
Árabe 🇸🇦 AR README_AR.md ✅ Completo
Hindi 🇮🇳 HI README_HI.md ✅ Completo
Italiano 🇮🇹 IT README_IT.md ✅ Completo
Português 🇵🇹 PT README_PT.md ✅ Completo

Cada ficheiro README contém a documentação completa do projeto, instruções de configuração e funcionalidades traduzidas para o respetivo idioma. Todos os ficheiros são mantidos atualizados com as informações mais recentes do projeto.

📖 Índice 📚

🚀 Visão Geral do Projeto: Negociação de Precisão com o ForexSignalBot 🎯

O ForexSignalBot destaca-se como um sistema pioneiro baseado em Telegram e aprimorado por IA 🤖, meticulosamente projetado para fornecer sinais de negociação hiper-precisos, em tempo real e altamente confiáveis 📈 para os mercados financeiros globais, com um foco estratégico e abrangente no dinâmico mercado Forex 🌍. Na sua essência, este projeto é construído sobre uma arquitetura de ponta .NET 9, aderindo rigorosamente aos mais altos padrões de boas práticas de engenharia de software, incluindo Domain-Driven Design (DDD) 🏗️, modularidade robusta, testabilidade excecional e manutenibilidade simplificada. Fundamentalmente, fornece uma plataforma resiliente, intuitiva e de alto desempenho, capacitando traders individuais 💼, analistas astutos 🔬 e entusiastas apaixonados dos mercados financeiros a executar decisões de negociação excecionalmente informadas e estratégicas. O nosso compromisso vai além da mera provisão de sinais; visamos fomentar um ecossistema de negociação mais inteligente e acessível para todos, entregue através de uma Interface de Utilizador totalmente intuitiva diretamente no Telegram e um abrangente painel web planeado. 💡

Contexto e Necessidade: Navegando nos Mercados Voláteis 🌊🌪️

O mercado Forex, reconhecido globalmente como o maior e mais líquido mercado financeiro, gera um volume avassalador e incessante de dados financeiros, notícias e insights analíticos complexos diariamente. Esta magnitude de informação apresenta um desafio intransponível tanto para traders novatos 🐣 como para os experientes, levando frequentemente à paralisia de análise e a oportunidades perdidas 😔. Existe uma procura crítica e persistente por ferramentas inteligentes e automatizadas que possam destilar eficazmente esta complexidade inerente do mercado em sinais acionáveis e confiáveis e em insights analíticos abrangentes, entregues no formato mais simples, digerível e oportuno possível. O ForexSignalBot foi precisamente criado para responder a esta necessidade imperativa de frente, oferecendo serviços de sinais premium, análises económicas profundas e acesso direto e credível a notícias — tudo perfeitamente integrado numa interface de bot do Telegram excecionalmente amigável, democratizando a inteligência de mercado sofisticada para as massas. 🌐🔗

Objetivos Principais: Potenciar a Negociação Estratégica 💪🚀

A nossa missão abrangente com o ForexSignalBot é redefinir fundamentalmente a acessibilidade, precisão e eficiência na negociação financeira, proporcionando uma vantagem incomparável aos nossos utilizadores:

  • 📈 Sinais de Alta Precisão: O nosso principal objetivo é fornecer sinais de compra/venda altamente precisos, rigorosamente sustentados por análises de mercado sofisticadas em tempo real, modelagem estatística avançada e insights baseados em dados. Esforçamo-nos por uma capacidade preditiva que supere consistentemente as médias do mercado. 🏆
  • ⚡ Informação Instantânea e Sem Esforço: Estamos empenhados em garantir o acesso ultrarrápido e sem esforço a notícias económicas críticas, desenvolvimentos geopolíticos significativos e eventos globais que impactam diretamente os mercados financeiros. O nosso sistema é projetado para latência mínima, garantindo que a informação chegue aos utilizadores quando é mais importante. 🔔
  • 🌐 Plataforma Centrada no Utilizador e Extensível: Um princípio fundamental da nossa filosofia de design é cultivar uma plataforma intuitiva, altamente adaptável e totalmente personalizável. Esta plataforma é meticulosamente adaptada para atender a traders de todos os níveis de experiência, desde iniciantes que procuram orientação até profissionais que exigem controlo granular e análises profundas. A sua natureza extensível permite o crescimento futuro e a integração, com um forte foco numa rica e completa experiência de UI. 🤝
  • 🧠 IA Avançada e Análise de Dados: Estamos incansavelmente focados na melhoria contínua da qualidade dos sinais e das capacidades preditivas do mercado. Isto é alcançado através da aplicação estratégica e do refinamento de algoritmos de Inteligência Artificial de última geração e técnicas de análise de dados de ponta, incluindo modelos de machine learning para reconhecimento de padrões e deteção de anomalias. 📊
  • 🔒 Segurança e Estabilidade Inabalável: Fundamental para a nossa operação é a garantia da segurança dos dados do utilizador e a provisão de uma estabilidade de serviço inabalável. Conseguimos isto através da aplicação diligente de princípios robustos de engenharia de software, protocolos de segurança rigorosos e resiliência operacional contínua 24/7, garantindo confiança e acesso ininterrupto. ✨

🌟 Destaques Principais ✨

  • Geração de Sinais Potenciada por IA: Utilizando algoritmos avançados para análise de mercado e insights preditivos. 🤖📊
  • Agregação de Notícias em Tempo Real: Curadoria de mais de 100 feeds RSS de alta qualidade, categorizados inteligentemente para relevância. 📰🔍
  • Integração com UI Completa no Telegram: Uma experiência de UI completa, rica, interativa e intuitiva diretamente no Telegram, projetada para máxima usabilidade e envolvimento. 💬✨
  • Arquitetura Robusta e Escalável: Construída em .NET 9, aderindo aos princípios da Arquitetura Limpa e Domain-Driven Design (DDD), projetada para alto desempenho, facilidade de manutenção e extensibilidade. 🏗️⚡
  • Execução Automatizada de Sinais (Auto-Forwarder): Encaminhamento direto e seguro de sinais para clientes de negociação conectados como o Telegram TL (Trading Client), minimizando a latência e erros manuais para uma experiência de negociação perfeita. 🔗🚀
  • Implementação em Contentores: Utilizando Docker para ambientes consistentes, isolados e escaláveis (pronto para "dotnet ducker"!). 🐳📦
  • Resiliência e Segurança: Apresentando Polly para tolerância a falhas transitórias, tratamento robusto de exceções e gestão segura de tokens. 🛡️🔒
  • Roadmap à Prova de Futuro: Evolução contínua com melhorias planeadas de IA/ML, painéis web dedicados para administradores/utilizadores e integração mais profunda com plataformas de negociação. 🛣️🔮

🏛️ Arquitetura e Tecnologias Principais: Projetado para a Excelência 🏗️✨

O ForexSignalBot é arquitetado sobre os princípios fundamentais da Arquitetura Limpa 🧹 e profundamente informado pelos princípios do Domain-Driven Design (DDD). Isto fomenta um design altamente lógico, agnóstico em relação à tecnologia e em camadas. Esta estrutura intencional separa meticulosamente as responsabilidades, garantindo uma testabilidade excecional ✅, manutenibilidade simplificada 🔧 e extensibilidade inerente ➕, assegurando que a lógica de domínio principal permaneça totalmente independente de frameworks externos, bases de dados ou especificidades da UI. Este design promove um sistema altamente modular capaz de evoluir graciosamente com as mudanças nas exigências do mercado e avanços tecnológicos, suportando uma solução robusta и escalável. 🔄

Visualizando a Arquitetura Limpa e o DDD 📊

Para compreender plenamente o design elegante do ForexSignalBot, uma representação visual da sua Arquitetura Limpa, sobreposta com conceitos de DDD (como Contextos Delimitados, Agregados, Entidades, Objetos de Valor), é altamente recomendada. Este diagrama ilustraria tipicamente as camadas distintas (Domínio, Aplicação, Infraestrutura, Apresentação/APIs) e as suas interações, juntamente com os componentes externos (WebAPI, TelegramPanel, BackgroundTasks). Tal ativo visual destaca claramente as regras de dependência estritas que impedem que as camadas externas influenciem a lógica central interna, garantindo a integridade e a modularidade do sistema. (Espaço reservado para o Diagrama de Arquitetura) 🖼️💡

Camadas do Projeto: Um Modelo para Escalabilidade e DDD 🧩📏

Cada camada definida dentro do ecossistema do ForexSignalBot serve um propósito crucial e distinto, melhorando coletivamente a manutenibilidade geral do sistema, a velocidade de desenvolvimento e a adaptabilidade futura, com uma forte ênfase na linguagem ubíqua e nos contextos delimitados do DDD:

  • Domínio: 🎯 Esta representa a camada mais interna e fundamental, encapsulando meticulosamente a lógica de negócio principal, as entidades de domínio (como Utilizador 👤, Sinal 📊, Subscricao 💳, Transacao 💰), objetos de valor (ex: Preco, Timeframe), serviços de domínio (ex: SignalGenerationService), e agregados (ex: Utilizador como uma raiz de agregado para as suas subscrições e carteira). Criticamente, esta camada permanece totalmente independente de qualquer tecnologia externa, framework ou base de dados, garantindo a pureza e portabilidade das regras de negócio principais e da linguagem ubíqua do domínio de negociação Forex. É aqui que reside o verdadeiro valor do negócio, modelado explicitamente. 🏡
  • Aplicação: ⚙️ Situada diretamente acima da camada de Domínio, esta camada implementa as regras de negócio específicas da aplicação e orquestra vários casos de uso. Atua como a interface primária para a camada de Domínio, contendo serviços de aplicação responsáveis por fluxos de trabalho complexos de geração de sinais (ex: GenerateForexSignalCommand), gestão abrangente de utilizadores (ex: ManageSubscriptionCommand), e processamento de análises avançadas. Define interfaces (portas) que a camada de Infraestrutura implementa, aderindo ao Princípio da Inversão de Dependência. 🧠
  • Infraestrutura: 📦 Esta camada fornece as implementações concretas para todas as preocupações e abstrações externas (adaptadores) definidas na camada de Aplicação. As suas responsabilidades são vastas, abrangendo soluções de armazenamento de dados persistentes (utilizando o EF Core para interações com o PostgreSQL 🐘), integração robusta com APIs externas (como a API do Bot do Telegram 🔗 e APIs de Negociação externas para encaminhamento automático 🚀), mecanismos fiáveis para a obtenção de feeds RSS 📡, e processamento sofisticado de tarefas em segundo plano. Esta camada trata do "como" (detalhes técnicos) para cumprir o "o quê" (lógica de negócio). 🏭
  • WebAPI: 🌐 Servindo como o ponto de entrada principal para todos os pedidos HTTP, esta camada contém controladores meticulosamente projetados para gerir interações de utilizadores, ciclo de vida de subscrições, disseminação de sinais e outras interações críticas orientadas por API RESTful. Atua como uma ponte entre os clientes web (ex: futuro Painel de Admin/Utilizador) e a lógica central da aplicação. 🌉
  • TelegramPanel: 🤖 Esta camada de serviço dedicada é exclusivamente responsável por lidar com todas as interações provenientes do bot do Telegram. As suas funcionalidades incluem receber e processar eficientemente os comandos dos utilizadores via Webhooks ou Polling 📬, gerir inteligentemente as sessões individuais dos utilizadores 🗣️, e enviar mensagens ricas e formatadas de volta para os utilizadores. Forma a ponte crucial entre as interações do utilizador no Telegram e a camada de Aplicação subjacente, proporcionando a experiência de UI completa diretamente ao utilizador. 💬
  • BackgroundTasks: ⏳ Esta camada vital é dedicada à gestão de todos os processos periódicos ou de longa duração que não devem bloquear o thread principal da aplicação. Isto inclui a agregação automatizada de feeds RSS 🔄, análises de sinais complexas e demoradas 📈, atualizações de dados de rotina 💾, e o despacho eficiente de notificações 📧, muitas vezes potenciado por filas de tarefas distribuídas robustas como o Hangfire para operações assíncronas. ⚙️
  • Shared: 🤝 Uma biblioteca transversal que atua como um repositório comum para classes de utilitários universalmente utilizadas, métodos de extensão poderosos e componentes reutilizáveis que são aproveitados consistentemente em toda a solução, promovendo a reutilização e consistência do código. 🔗

Tecnologias Principais: Potenciando o Desempenho e a Fiabilidade ⚡🛠️

A base robusta do ForexSignalBot é construída sobre um conjunto cuidadosamente selecionado de tecnologias modernas, de alto desempenho e fiáveis. Uma representação visual desta stack tecnológica comunicaria eficazmente o ambiente de desenvolvimento coeso e poderoso que impulsiona este projeto. (Espaço reservado para o Diagrama da Stack Tecnológica) 💡

  • .NET 9: A mais recente iteração da plataforma de desenvolvimento versátil, de alto desempenho e multiplataforma da Microsoft. Proporciona velocidade, eficiência e um ecossistema rico sem paralelo para construir aplicações de nível empresarial, garantindo um desempenho ótimo para operações financeiras exigentes. 🚀
  • Docker 🐳: Utilizado extensivamente para contentorização robusta, o Docker garante ambientes de implementação consistentes, isolados e altamente escaláveis. Isto otimiza os fluxos de trabalho de desenvolvimento, teste e produção, permitindo pipelines de Integração Contínua e Entrega Contínua (CI/CD) sem falhas. Isto define fundamentalmente a nossa abordagem "dotnet ducker" para implementações modernas e portáteis, contribuindo significativamente para a fiabilidade e desempenho do sistema. 📦
  • PostgreSQL 🐘: Um sistema de base de dados objeto-relacional de código aberto, altamente avançado e poderoso. O PostgreSQL é reconhecido pela sua robustez comprovada, fiabilidade inabalável, riqueza de funcionalidades e desempenho excecional na gestão de armazenamento de dados complexos e de grande volume, crítico para a integridade dos dados financeiros. 💾
  • Entity Framework Core (EF Core): O moderno, leve e de alto desempenho Object-Relational Mapper (ORM) da Microsoft para .NET. O EF Core simplifica significativamente as interações complexas com a base de dados, a gestão de esquemas e a consulta de dados, abstraindo grande parte do código SQL repetitivo, mantendo ao mesmo tempo um alto desempenho. 📖
  • Telegram.Bot API: A biblioteca .NET oficial, abrangente e ativamente mantida, projetada especificamente para uma interação perfeita e eficiente com a API do Bot do Telegram. Lida com todas as complexidades das comunicações do bot, análise de mensagens e envio de conteúdo rico, crucial para a experiência de UI completa. 💬🤖
  • Hangfire ⏱️: Uma biblioteca poderosa de código aberto que permite o processamento de tarefas em segundo plano de forma transparente e fácil, agendando tarefas recorrentes e gerindo o processamento distribuído. O Hangfire garante que as operações assíncronas são executadas de forma fiável, melhorando a capacidade de resposta e a resiliência do sistema sob carga pesada. 🔄
  • Polly 🛡️: Uma biblioteca .NET robusta e fluente para resiliência e tratamento de falhas transitórias. O Polly implementa inteligentemente várias políticas como Retry, Circuit Breaker, Timeout, Bulkhead Isolation e mecanismos de Fallback, garantindo que a aplicação permaneça altamente resiliente contra falhas transitórias em chamadas de API externas (ex: plataformas de negociação) e interações com a base de dados, garantindo assim o máximo tempo de atividade e um desempenho consistente. 💪
  • HTML Agility Pack: Um parser de HTML robusto e flexível. Esta biblioteca é extensivamente usada para extrair e manipular eficientemente o conteúdo HTML proveniente de feeds RSS complexos e outras páginas web, permitindo a ingestão de dados estruturados para análise de notícias. 🕸️📄
  • AutoMapper: Uma poderosa biblioteca de mapeamento de objeto para objeto baseada em convenções. O AutoMapper simplifica significativamente a transferência de dados entre diferentes camadas da aplicação (ex: mapeamento de entidades para DTOs), reduzindo drasticamente o código repetitivo e melhorando a manutenibilidade. 🔄
  • Microsoft.Extensions.Logging: Uma framework de logging altamente estruturada e eficiente fornecida pela Microsoft. Permite uma observabilidade e diagnósticos abrangentes em toda a aplicação, facilitando a depuração eficaz, a monitorização e a análise de desempenho, essenciais para um sistema crítico como um bot de negociação. 📝🔍
  • ML.NET / TensorFlow.NET: (Visão Futura) Integração estratégica de frameworks de ponta de Inteligência Artificial e Machine Learning. Isto está planeado para análise de sentimento avançada das notícias de mercado 🧐, modelagem preditiva sofisticada dos movimentos de preços 🔮, e melhoria contínua e adaptativa da qualidade dos sinais, proporcionando uma vantagem competitiva significativa e impulsionando a inteligência central do bot. 🚀

✨ Funcionalidades Principais: Desbloqueando a Inteligência de Mercado 💡🔓

O ForexSignalBot é projetado com um conjunto extenso e meticulosamente desenhado de funcionalidades destinadas a atender às necessidades matizadas e em evolução dos traders financeiros modernos, proporcionando-lhes inteligência de mercado e eficiência operacional inigualáveis:

Sistema Flexível de Adesão e Subscrição: Acesso Personalizado 💎💳

A plataforma oferece diversos níveis de adesão, desde um plano Básico Gratuito até subscrições premium ricas em funcionalidades. Estes níveis são cuidadosamente projetados para fornecer acesso diferenciado a funcionalidades avançadas, conteúdo premium e frequências de sinal mais elevadas. Um sistema de carteira seguro e baseado em tokens 👛 facilita a gestão transparente dos créditos do utilizador, permite o rastreamento transparente de transações 🧾 e suporta modelos de subscrição flexíveis, permitindo que os utilizadores dimensionem o seu acesso com base nas suas necessidades de negociação e orçamento. 💲

📰 Agregação Avançada de Notícias e Análise Inteligente: Mantenha-se à Frente 🚀📡

  • Mais de 100 Feeds RSS de Alta Qualidade: O ForexSignalBot busca e agrega meticulosamente notícias de uma lista extensa e cuidadosamente curada de mais de 100 fontes de notícias financeiras globais altamente fiáveis e estáveis 🌐, garantindo uma cobertura de mercado abrangente e em tempo real das fontes mais credíveis, evitando silos de informação. 🗞️
  • Feeds Categorizados: Todos os feeds de notícias recebidos são processados e categorizados inteligentemente em grupos temáticos granulares. Exemplos incluem Essenciais Forex ✨, pares de moedas específicos como Forex USD/EUR/JPY/GBP/AUD/CAD/CHF 💱, mercados mais amplos como Ações Globais 🏢, Matérias-primas ⛏️, Cripto ₿, e temas macroeconómicos como Macroeconomia 🏛️, Geopolítica 🌍, Negócios em Geral 👔, e Tecnologia & FinTech 💻. Isto proporciona um fluxo de notícias altamente personalizado e relevante para cada utilizador. 🎯
  • Desduplicação Inteligente: O sistema emprega uma lógica algorítmica avançada para detetar rigorosamente e impedir o envio de notícias duplicadas aos utilizadores. Esta desduplicação inteligente funciona eficazmente mesmo que várias fontes reformulem ou republiquem o mesmo conteúdo, garantindo um fluxo de notícias limpo, conciso e eficiente, livre de redundância. 🧹🔄
  • Padrões para Novos Utilizadores: Para fornecer valor imediato sem sobrecarregar os novos utilizadores, estes são automaticamente subscritos a feeds de notícias essenciais e de alta prioridade (IsActive=1) por padrão, proporcionando valor imediato sem sobrecarga de informação inicial. Outros feeds especializados (IsActive=0) estão prontamente disponíveis para ativação manual pelos utilizadores com base nos seus interesses e estratégias de negociação em evolução, promovendo uma experiência de onboarding personalizada. ✅🆕
  • Preferências do Utilizador: Os utilizadores mantêm um controlo granular e intuitivo para personalizar as suas categorias de notícias e preferências de notificação. Isto garante que recebem apenas o conteúdo mais relevante para as suas estratégias de negociação individuais e interesses de mercado específicos, eliminando o ruído e aumentando o foco. 🛠️👤

Para ilustrar a amplitude da sua agregação de notícias, um gráfico que ilustre a sua distribuição seria benéfico aqui. (Espaço reservado para o Gráfico de Distribuição de Notícias) 📊

📈 Suporte a Sinais Multimoeda: Cobertura de Mercado Diversificada 🌐💱

O ForexSignalBot fornece sinais analíticos precisos para todos os principais pares de moedas Forex, incluindo USD, EUR, JPY, GBP, AUD, CAD, CHF, e NZD. Além disso, estende o seu alcance analítico a outros ativos globais chave, como matérias-primas e índices selecionados, oferecendo uma perspetiva de negociação abrangente e diversificada através de vários instrumentos financeiros. 🪙🏭

🔗 Execução Automatizada de Sinais e Integração com Plataformas de Negociação (Auto-Forwarder) 🚀

Esta funcionalidade crítica transforma o ForexSignalBot numa ponte perfeita entre a inteligência e a execução, permitindo o encaminhamento seguro, quase em tempo real, de sinais de negociação verificados diretamente do bot para as contas de negociação externas conectadas do utilizador ou plataformas de negociação preferidas (ex: MetaTrader 4/5, cTrader).

  • Transmissão Direta e Segura: Utilizando integrações de API robustas (atuando como um Trading Client ou Web Client dedicado para plataformas como o MetaTrader), os sinais são transmitidos de forma segura e com latência mínima. Esta capacidade, muitas vezes referida como "Auto-Forwarder", reduz significativamente o tempo de chegada ao mercado das negociações, o que é crítico em ambientes Forex voláteis.
  • Eliminar Entrada Manual e Erros: Automatiza o processo de colocação de ordens, eliminando erros de entrada manual e permitindo que os traders capitalizem instantaneamente em oportunidades de mercado rápidas, especialmente crucial para estratégias de alta frequência.
  • Automação Controlada pelo Utilizador: Os utilizadores mantêm controlo total e granular sobre quais sinais são encaminhados automaticamente e podem configurar parâmetros de risco vitais (ex: tamanho do lote, desvio máximo, take-profits parciais) e ativar/desativar a automação através da UI interativa do bot do Telegram ou de um futuro painel web.
  • Fiabilidade e Resiliência (abordagem TL _Wclinet): Projetado com mecanismos avançados de tolerância a falhas (utilizando políticas do Polly) para garantir a entrega consistente de sinais e a fiabilidade da execução, mesmo em meio a problemas de rede transitórios ou interrupções da plataforma. Isto espelha a resiliência e o tratamento de erros robusto esperado de integrações de clientes de negociação profissionais, visando níveis de fiabilidade "TL _Wclinet".

Esta capacidade melhora fundamentalmente o ForexSignalBot de um mero provedor de sinais para um assistente de negociação abrangente e semiautomatizado, capacitando os utilizadores com inteligência de mercado superior e eficiência de execução inigualável.

🧠 Análise Inteligente e de Sentimento (Futuro/Em Curso): Vantagem Potenciada por IA 🚀🔮

O projeto está ativamente a integrar e a refinar continuamente sofisticados algoritmos de análise de sentimento. Estes algoritmos analisam meticulosamente notícias de mercado, dados de redes sociais e vários fluxos de dados, com o objetivo de melhorar significativamente a qualidade dos sinais, identificar com precisão as tendências de mercado emergentes e fornecer insights de mercado mais profundos e acionáveis. Os planos estratégicos futuros incluem uma integração mais avançada de IA/ML para modelagem preditiva altamente sofisticada 📈, reconhecimento de padrões complexos em diversos conjuntos de dados 🧩, e mecanismos de sinalização adaptativos, coletivamente expandindo as fronteiras da inteligência de negociação automatizada. 💡

🤖 Bot do Telegram Robusto e Responsivo: Experiência de Utilizador Perfeita 💬📲

  • Flexibilidade de Webhook/Polling: O bot do Telegram alcança uma receção de mensagens excecionalmente rápida e responsiva através de Webhooks, proporcionando uma interação quase em tempo real. Em cenários onde os Webhooks possam enfrentar desafios de conectividade, um fallback gracioso para Polling garante a máxima fiabilidade e alta disponibilidade contínua, mantendo a experiência de UI completa. ⚡🔄
  • Processamento de Mensagens em Fila: Todos os comandos de utilizador recebidos e mensagens enviadas são processados de forma assíncrona através de uma fila de mensagens robusta e tolerante a falhas (potenciada pelo Hangfire). Esta arquitetura garante uma experiência de utilizador consistentemente suave e sem bloqueios e previne eficazmente a sobrecarga do sistema, mesmo sob períodos de alto tráfego de utilizadores ou atividade intensa de mercado, contribuindo para o desempenho geral. 🚦➡️
  • Elementos de UI Ricos (UI Completa): O bot aproveita e suporta totalmente a extensa gama de capacidades de Interface de Utilizador ricas do Telegram. Isto inclui teclados inline interativos para navegação perfeita 👆, formatação MarkdownV2 para mensagens visualmente atraentes и altamente legíveis ✨, e a inclusão de anexos de multimédia para entrega de conteúdo interativo e informativo 📸, proporcionando uma experiência de utilizador verdadeiramente premium e de UI completa diretamente na aplicação do Telegram. 🌟

🔒 Segurança e Integridade dos Dados: Operações Confiáveis 🛡️🔐

  • O ForexSignalBot prioriza a gestão segura de tokens para uma autenticação e autorização robustas do utilizador em diferentes níveis de acesso, protegendo assim meticulosamente as contas dos utilizadores e informações sensíveis contra acesso não autorizado. 🔑
  • O sistema implementa mecanismos abrangentes de tratamento de exceções e utiliza estrategicamente políticas avançadas do Polly para uma tolerância a falhas transitórias sofisticada. Esta abordagem de engenharia garante um tempo de atividade próximo de 24/7 e assegura uma consistência de dados inigualável, mesmo perante interrupções temporárias de rede ou serviço, aumentando a resiliência e o desempenho do sistema. ✅ uptime
  • Projetado para implementação em produção sem falhas com Docker, o sistema integra logging estruturado para monitorização contínua 📊, alertas proativos 🔔, e otimização de desempenho granular, garantindo operações excecionalmente fiáveis e seguras, refletindo um compromisso com a estabilidade de nível empresarial. 🏭

📊 Informações de Desempenho: Dados num Relance 📈✨

Embora gráficos dinâmicos específicos não possam ser diretamente incorporados num README padrão do GitHub, compreender o desempenho dos algoritmos inteligentes e da infraestrutura do ForexSignalBot é crucial. Aqui, delineamos os principais indicadores de desempenho que demonstram a eficácia e fiabilidade do bot. Para representar visualmente estes indicadores, seria típico gerar gráficos a partir dos dados reais do seu projeto e carregá-los como imagens para o seu repositório (ex: em /assets/images/). 🖼️

Precisão dos Sinais ao Longo do Tempo 🎯📈

Esta métrica acompanha a taxa de precisão histórica dos sinais do ForexSignalBot durante um período definido (ex: mensal, trimestral). Um gráfico de linhas ilustraria tipicamente uma percentagem consistentemente alta (idealmente acima de 85-90%) com uma potencial tendência ascendente, demonstrando fortes capacidades preditivas e a melhoria contínua dos modelos de IA subjacentes. Isto fornece uma validação crucial da eficácia do bot. (Espaço reservado para o Gráfico de Precisão de Sinais) 💯

Crescimento e Envolvimento do Utilizador 🌱👥

Esta secção foca-se na expansão da base de utilizadores e no seu envolvimento ativo com o bot. Um gráfico de barras mostraria tipicamente o crescimento mensal de utilizadores ativos, refletindo a crescente adoção, retenção e a proposta de valor geral do serviço no mercado. Um crescimento consistente indica uma receção positiva do mercado e satisfação do utilizador. (Espaço reservado para o Gráfico de Crescimento de Utilizadores) 🚀

Latência na Entrega de Sinais ⏱️⚡

Esta métrica crítica mede o tempo médio que um sinal leva para ser entregue desde o seu ponto de geração no sistema até à notificação do utilizador no Telegram. Uma baixa latência (tipicamente visando menos de 3 segundos) é primordial para decisões de negociação atempadas. Um gráfico de medidor ou um simples gráfico de linhas representaria visualmente isto, destacando a capacidade de resposta em tempo real e a eficiência operacional do bot. (Espaço reservado para o Gráfico de Latência) 💨

Débito e Escalabilidade do Sistema ⚡

Esta métrica quantifica o número de sinais processados, artigos de notícias agregados e mensagens entregues por segundo ou minuto, demonstrando a capacidade e eficiência do sistema sob carga. Um alto débito, combinado com uma baixa utilização de recursos, indica uma escalabilidade robusta. Um gráfico de linhas mostrando o débito em relação a utilizadores concorrentes destacaria a capacidade do sistema de lidar com a crescente procura sem degradação do desempenho, afirmando a sua prontidão para o nível empresarial. (Espaço reservado para o Gráfico de Débito/Escalabilidade) 📈🔄

🎨 Conceitos de UI/UX: Interfaces de Utilizador Intuitivas e Cativantes ✨🤩

O ForexSignalBot é projetado desde o início para fornecer uma experiência de utilizador totalmente intuitiva e cativante, seja através da interface principal do bot do Telegram ou do painel web abrangente planeado. A nossa UI/UX está focada em promover interações sem esforço, garantir uma comunicação cristalina e permitir uma personalização extensiva para cada trader.

Bot do Telegram: A Experiência de UI Completa 🖼️🤳

Como o bot do Telegram serve como a interface de utilizador principal e mais direta para a maioria dos utilizadores, o nosso design garante uma experiência rica, interativa e visualmente apelativa. Capturas de ecrã reais ou mockups de alta fidelidade da interface do bot do Telegram são altamente recomendados aqui para mostrar as capacidades de UI completa. (Espaço reservado para Capturas de Ecrã/Mockups da UI do Telegram) 📸

  • Menu Principal e Comandos: Os utilizadores interagem principalmente com o bot através de uma interface natural, baseada em comandos, iniciando ações com comandos intuitivos como /start 👋 (boas-vindas e visão geral), /help ❓ (orientação e FAQs), e /settings ⚙️ (centro de personalização).
    • Elementos Visuais: Comandos a negrito, descrições claras e teclados inline responsivos para navegação rápida.
  • Feeds de Notícias:
    • Formato da Mensagem: As notícias são apresentadas num formato MarkdownV2 limpo e altamente legível. Esta formatação garante que elementos chave como títulos a negrito 📰, fontes em itálico 🖊️, resumos inteligentemente truncados 📝, e um proeminente botão inline "Ler Artigo Completo" 🔗 sejam visualmente distintos e fáceis de analisar, proporcionando uma rica experiência multimédia.
    • Interação do Utilizador: Botões inline para Ler Mais, Partilhar, ou Guardar para Mais Tarde para aumentar o envolvimento.
  • Notificações de Sinais:
    • Formato da Mensagem: Os sinais de negociação são transmitidos com a máxima clareza e urgência, apresentando indicadores distintos de compra/venda (ex: COMPRA verde ✅ / VENDA vermelha ❌), símbolos de ativos precisos (ex: EUR/USD), preços específicos de entrada, stop-loss (SL) e take-profit (TP), juntamente com atualizações de estado em tempo real (ex: Ativo, Fechado-TP1, Fechado-SL). Isto garante que todos os parâmetros críticos de negociação sejam imediatamente visíveis e acionáveis. 📈📉🔔
    • Elementos Interativos: Botões inline para Confirmar Negociação (para o Auto-Forwarder), Mais Informações, ou Feedback.
  • Definições e Preferências:
    • Os utilizadores navegam e personalizam as suas definições sem esforço através de teclados inline intuitivos, criando uma verdadeira experiência de UI completa diretamente no Telegram. Exemplos incluem opções granulares como ⚙️ Preferências ▶️ Categorias de Notícias 📰 ▶️ Forex 💱 ▶️ USD [✅/❌], permitindo uma experiência de personalização contínua, orientada por toques. 👆
    • Opções: Frequência de notificação, alertas de mercado específicos, preferências de idioma e gestão de subscrições.
  • Configuração do Auto-Forwarder (Novo):
    • Formato da Mensagem: Os utilizadores podem gerir as suas integrações com plataformas de negociação e preferências de encaminhamento automático através de menus claros e interativos. As opções incluirão 🔗 Conectar Plataforma (ex: MetaTrader), ⚙️ Definições de Auto-Forward (ex: níveis de risco, pares para automatizar), 📈 Histórico de Negociações (para negociações automatizadas), e Desconectar.
    • Orientação: Instruções passo a passo para conectar plataformas e configurar a negociação automatizada, garantindo um processo de configuração suave.
  • Tratamento de Erros: No caso de problemas não tratados, mensagens de erro amigáveis e informativas são enviadas de volta ao utilizador. Estas mensagens indicam claramente que a equipa de desenvolvimento foi notificada e está ativamente a resolver o problema, minimizando assim a frustração do utilizador e mantendo a confiança. ⚠️🤖

Painel Web de Administração e Utilizador (Visão Futura) 🌐👨‍💻

Além do bot do Telegram, um painel abrangente baseado na web está planeado para oferecer uma experiência mais rica e detalhada tanto para administradores como para utilizadores avançados, estendendo a visão de UI completa:

  • Dashboard de Administração:
    • Funcionalidades: Gestão centralizada de utilizadores, supervisão detalhada de subscrições, configuração granular de feeds de notícias, monitorização ao vivo da geração de sinais, verificações abrangentes da saúde do sistema, análises de desempenho aprofundadas com dashboards personalizáveis e ferramentas poderosas de moderação de conteúdo.
    • Elementos de UI: Dashboards ricos em dados com gráficos interativos, tabelas filtráveis, funcionalidades de pesquisa avançada e controlos administrativos para afinar o sistema.
  • Painel Web do Utilizador:
    • Funcionalidades: Gestão detalhada de subscrições, personalização avançada de preferências (além das capacidades do Telegram), registos históricos extensivos de sinais com métricas de desempenho e análise, feeds de notícias personalizados com filtragem avançada, e uma interface robusta para gerir conexões de plataformas de negociação e definições granulares de encaminhamento automático.
    • Elementos de UI: Navegação intuitiva, widgets personalizáveis, gráficos interativos para acompanhamento do desempenho pessoal e formulários seguros para configurações sensíveis e gestão de chaves de API.

Esta abordagem de interface dupla garante acessibilidade e conveniência através da UI completa do Telegram, complementada por capacidades de gestão e análise poderosas e detalhadas através de uma aplicação web dedicada, proporcionando uma experiência de utilizador holística e robusta.

🛠️ Primeiros Passos (Para Desenvolvedores): Ative o Seu Bot 🔥💻

Pronto para mergulhar no código-fonte e contribuir para a evolução do ForexSignalBot? Siga estes passos abrangentes para configurar o projeto localmente. A nossa filosofia de desenvolvimento enfatiza uma abordagem dotnet ducker 🐳, garantindo ambientes de desenvolvimento consistentes, isolados e altamente reprodutíveis em várias máquinas. 🚀

🚀 Primeiros Passos com o Docker

Este projeto está totalmente contentorizado usando o Docker Compose. Esta é a forma recomendada de executar a aplicação para desenvolvimento, pois configura automaticamente a aplicação .NET e a base de dados SQL Server num ambiente isolado.

Não precisa de instalar o .NET SDK ou o SQL Server na sua máquina.

Pré-requisitos

Tudo o que precisa é do Docker Desktop instalado e a correr no seu sistema.

1. Clonar o Repositório

Primeiro, obtenha o código-fonte para a sua máquina local.

git clone https://github.com/Opselon/ForexTradingBot.git
cd ForexTradingBot

2. Configure os Seus Segredos

A aplicação requer chaves secretas (como tokens de API e passwords) para funcionar. Estas são geridas num ficheiro local .env que é mantido privado e não é submetido para o Git.

Um ficheiro de modelo chamado .env.example é fornecido para si.

  • Configuração Automática (Recomendado): Simplesmente execute o script de arranque para o seu sistema operativo. Ele criará o ficheiro .env para si se não existir.
  • Configuração Manual: Se preferir, pode copiar manualmente .env.example para um novo ficheiro chamado .env.

Abra o ficheiro .env num editor de texto e preencha com os seus valores secretos reais.

3. Execute a Aplicação! 🔥

Com o Docker a correr e o seu ficheiro .env configurado, pode iniciar toda a pilha da aplicação com um único comando.

  • No Windows: Dê um duplo clique no ficheiro start.bat.
  • No Linux ou macOS: Abra um terminal na raiz do projeto e execute: 
    # Torne o script executável (só precisa de fazer isto uma vez)
chmod +x start.sh

# Execute o script
./start.sh

É isso! O script irá:

  1. Construir a imagem Docker da aplicação .NET.
  2. Fazer o download e iniciar um contentor do SQL Server.
  3. Iniciar o contentor da sua aplicação.
  4. Conectar tudo numa rede privada.
  5. A sua aplicação, se configurada com o Entity Framework, aplicará automaticamente as migrações da base de dados no arranque.

A API estará disponível em http://localhost:8080 em breve.

Gerir a Sua Aplicação

  • Ver logs em tempo real: docker-compose logs -f
  • Parar a aplicação: docker-compose down
  • Conectar à Base de Dados (Opcional): Pode conectar-se à instância do SQL Server a correr no Docker usando qualquer ferramenta de base de dados (como o Azure Data Studio ou o SSMS).
    • Servidor: localhost,1433 (Pode precisar de descomentar a linha das portas no docker-compose.yml para o serviço db primeiro)
    • Autenticação: Login SQL
    • Utilizador: sa
    • Password: A DB_SA_PASSWORD que definiu no seu ficheiro .env.

  1. Clone o repositório: Inicie o processo de desenvolvimento clonando o código-fonte do projeto a partir do GitHub:

    git clone https://github.com/Opselon/ForexTradingBot.git
cd ForexTradingBot

    Este comando busca o código para a sua máquina local. ⬇️

  2. Configuração da Base de Dados (PostgreSQL): O ForexSignalBot utiliza o PostgreSQL 🐘 para a sua camada robusta de persistência de dados.

    • Certifique-se de que uma instância do PostgreSQL está instalada, configurada e a correr ativamente no seu sistema local ou acessível através da sua rede. ✅
    • Atualize a string DefaultConnection no seu ficheiro appsettings.json (ou appsettings.Development.json para configurações de desenvolvimento local) para apontar corretamente para a sua instância operacional do PostgreSQL, incluindo as credenciais. 🔑
    • Aplique as migrações necessárias do Entity Framework Core para inicializar e atualizar o esquema da base de dados para a versão mais recente: 
      dotnet ef database update --project Infrastructure --startup-project WebAPI
      Isto configura as tabelas da sua base de dados. 🏗️
    • Povoar Feeds e Categorias RSS: Execute o script Populate_RssSources_Categories.sql fornecido (localizado na raiz do projeto, ou execute-o diretamente a partir do seu cliente SQL) na sua base de dados. Este passo crucial, a ser feito uma única vez, estabelecerá as categorias iniciais e povoará a lista abrangente de feeds RSS que o bot agrega. 📡🔄

  3. Token do Bot do Telegram: Para que a funcionalidade do bot do Telegram opere, requer um token de autenticação. 🤖

    • Obtenha um token de bot único interagindo com o @BotFather oficial no Telegram. Siga as suas instruções para criar um novo bot e obter o seu token. 🤝
    • Configure o token do seu bot obtido no ficheiro appsettings.json sob a chave de configuração TelegramPanelSettings:BotToken. 📝

  4. Dashboard do Hangfire (Opcional mas Recomendado): O Hangfire é usado para gerir tarefas em segundo plano. ⏱️

    • Configure o caminho do seu dashboard do Hangfire e as definições de segurança conforme necessário no appsettings.json. Este dashboard fornece informações valiosas sobre o processamento de tarefas, falhas e agendamentos, o que é altamente recomendado para monitorizar operações em segundo plano. 📊🔍

  5. Construir e Executar (.NET): Com todos os pré-requisitos configurados, construa e execute a aplicação. 🚀

    dotnet build
dotnet run --project WebAPI # Ou use o seu IDE (ex: Visual Studio, VS Code) para executar o projeto WebAPI.

    Isto compila e inicia a sua aplicação. ⚙️

  6. Integração com Docker (Recomendado para Produção e Consistência - dotnet ducker): A utilização do Docker proporciona um ambiente consistente e isolado, crucial para o desenvolvimento e implementação. 🐳

    • Para representar visualmente a sua configuração do Docker, um diagrama ilustrando a arquitetura contentorizada (ex: mostrando os serviços PostgreSQL, WebAPI e TelegramPanel a correr em contentores separados e interligados) seria benéfico aqui. (Espaço reservado para o Diagrama de Arquitetura do Docker) 🏗️
    • Certifique-se de que o Docker Desktop está instalado e a correr na sua máquina para orquestrar os contentores. ✅
    • Construa e execute todos os serviços usando o Docker Compose, que gere aplicações Docker multi-contentor: 
      docker-compose build
docker-compose up
    • Este comando irá orquestrar a sua base de dados PostgreSQL, WebAPI e serviços do TelegramPanel dentro de contentores Docker isolados, garantindo um ambiente de desenvolvimento/produção consistente e escalável desde o início, incorporando a filosofia "dotnet ducker". 🚀📦

🗺️ Roadmap e Planos Futuros: O Caminho para 2025 e Além 🛣️🌟

O projeto ForexSignalBot está numa trajetória acelerada de inovação contínua e expansão estratégica. Os nossos planos futuros ambiciosos são projetados para melhorar significativamente as suas capacidades, experiência do utilizador e alcance de mercado, posicionando-o como uma solução líder em inteligência financeira impulsionada por IA:

  • 🧠 Integração Avançada de IA/ML: O nosso foco principal será na implementação de modelos de Inteligência Artificial e Machine Learning ainda mais sofisticados para uma análise de dados preditiva e mais profunda 📊, desenvolvendo insights de mercado hiper-personalizados e adaptados a perfis de utilizador individuais 👤, e construindo algoritmos de sinalização adaptativos que aprendem e se refinam ao longo do tempo 🔄, aproveitando os mais recentes avanços em deep learning e reinforcement learning. 💡
  • 🌐 Painel Web de Administração e Utilizador (Expansão da UI Completa): Planeamos desenvolver um painel de gestão baseado na web, abrangente, intuitivo e rico em funcionalidades. Este painel servirá tanto os administradores (para uma supervisão robusta do sistema 👁️‍🗨️, gestão eficiente de utilizadores 👥, curadoria de conteúdo ✍️, e monitorização granular do desempenho) como os utilizadores finais (para gestão de subscrições sem falhas 💳, personalização avançada de preferências 🛠️, registos detalhados de sinais históricos com métricas de desempenho, e controlo direto e total sobre integrações de encaminhamento automático e outras funcionalidades avançadas além do que o Telegram oferece). 📈
  • ➕ Categorias de Sinais e Classes de Ativos Expandidas: Com base no feedback dos utilizadores e nas exigências de mercado em evolução, introduziremos progressivamente novas categorias de sinais e ampliaremos significativamente a gama de classes de ativos suportadas. Isto poderá incluir índices específicos 📊, vários tipos de obrigações 📜, uma gama mais vasta de criptomoedas ₿, e outros investimentos alternativos, expandindo a utilidade e o apelo do bot para um público de negociação mais amplo. 💹
  • 🎯 Personalização Melhorada: Estamos empenhados em fornecer opções de personalização ainda mais granulares e inteligentes. Isto abrangerá tipos de notificação (ex: alertas críticos vs. resumos diários 🔔), definições de frequência ⏱️, filtros de conteúdo sofisticados baseados em interesses individuais 🔎, e alertas de mercado preferidos, dando aos utilizadores um controlo inigualável sobre a sua informação de negociação recebida. 🚀
  • 🔗 Integração Mais Profunda com Plataformas de Negociação (Auto-Forwarder Avançado): Uma iniciativa estratégica chave é expandir e refinar as capacidades de integração direta e segura com plataformas de negociação externas populares (ex: MetaTrader 4/5 💻, cTrader, TradingView). Isto permitiria funcionalidades de execução de sinais automatizada mais avançadas (sempre com o consentimento explícito do utilizador e funcionalidades robustas de gestão de risco), otimizando o fluxo de trabalho de negociação desde a receção do sinal até à colocação da ordem e potencialmente oferecendo tipos de ordem avançados como trailing stops, ordens OCO e gestão de posições integrada. Isto levará o conceito "TL _Wclinet" mais longe. 🤝
  • 🤝 Funcionalidades Comunitárias: Para fomentar um ecossistema vibrante e colaborativo em torno do bot, prevemos a integração de funcionalidades comunitárias. Isto poderia potencialmente incluir insights partilhados 🧠, fóruns de discussão dentro de grupos do Telegram 💬, funcionalidades de aprendizagem colaborativa 🎓, e apoio peer-to-peer, construindo uma comunidade próspera de traders informados. 🧑‍🤝‍🧑

🤝 Contribuir: Junte-se à Nossa Jornada 🌍✨

Acolhemos e encorajamos com entusiasmo as contribuições da comunidade global de desenvolvedores! Se está interessado em contribuir para o desenvolvimento contínuo e o sucesso do ForexSignalBot, por favor, siga estas diretrizes para garantir um processo suave, eficiente e colaborativo:

  1. Faça um Fork do repositório: Comece por fazer um fork do repositório oficial ForexTradingBot para a sua conta pessoal do GitHub. Isto cria a sua própria cópia onde pode fazer alterações livremente. 🍴
  2. Crie um novo branch: Para cada nova funcionalidade ou correção de bug, crie um branch dedicado. Isto mantém as suas alterações isoladas e torna a gestão de pull requests mais limpa. Use nomes de branch descritivos, ex: git checkout -b feature/sua-nova-feature ou bugfix/corrigir-issue-numero. 🌿
  3. Faça commit das suas alterações: Faça as suas alterações de código e faça commit delas usando mensagens de commit claras, concisas e descritivas. Encorajamos a seguir as diretrizes de commits convencionais (ex: feat: adicionar novo tipo de sinal ✨, fix: resolver problema com parsing de RSS 🐛, docs: atualizar roadmap 📝). 📝
  4. Faça push do seu branch: Após o commit, faça push do seu novo branch para o seu repositório forkado no GitHub. ⬆️
  5. Abra um Pull Request (PR): Navegue para o repositório original ForexTradingBot no GitHub e abra um novo Pull Request. Forneça uma descrição clara e detalhada das suas alterações, incluindo por que são necessárias e que problema resolvem. Referencie quaisquer issues relacionadas. 🚀 Pull! . Por favor, reveja o nosso ficheiro CONTRIBUTING.md (que será criado em breve! 🔜 Fique atento para diretrizes detalhadas de contribuição e padrões de codificação! 📋) para instruções mais específicas.

📄 Licença 📜

Este projeto está orgulhosamente licenciado sob a Licença MIT. Esta licença de código aberto permissiva permite-lhe usar, copiar, modificar, fundir, publicar, distribuir, sublicenciar e/ou vender cópias do software, sujeito à inclusão do aviso original de direitos de autor e permissão. Para detalhes abrangentes, por favor, consulte o ficheiro LICENSE localizado na raiz deste repositório. ✅

#Tags: #NegociacaoForex #BotTelegram #SinaisIA #NegociacaoAutomatizada #BotForex #AutomacaoDeNegociacao #NETCore #DotNet9 #TecnologiaFinanceira #FinTech #NegociacaoAlgoritmica #BotDeSinais #CodigoAberto #NegociacaoCripto #AnaliseDeMercado #Bots #Software #BotDeNegociacao