https://github.com/eletherioalexandre/echo-mind
Plataforma de análise de sentimentos aplicada a feedbacks de usuários. Microserviço Python integrado com arquitetura profissional para projetos.
https://github.com/eletherioalexandre/echo-mind
artificial-intelligence csharp domain-driven-design dotnet microservice nlp python
Last synced: 11 months ago
JSON representation
Plataforma de análise de sentimentos aplicada a feedbacks de usuários. Microserviço Python integrado com arquitetura profissional para projetos.
- Host: GitHub
- URL: https://github.com/eletherioalexandre/echo-mind
- Owner: EletherioAlexandre
- Created: 2025-04-07T04:43:47.000Z (12 months ago)
- Default Branch: main
- Last Pushed: 2025-04-24T03:16:24.000Z (11 months ago)
- Last Synced: 2025-04-24T03:28:44.298Z (11 months ago)
- Topics: artificial-intelligence, csharp, domain-driven-design, dotnet, microservice, nlp, python
- Language: Python
- Homepage:
- Size: 7.32 MB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# EchoMind — Plataforma de Análise de Sentimentos
EchoMind é uma plataforma, em desenvolvimento, de análise de sentimentos desenvolvida para transformar feedbacks de usuários em insights estratégicos para negócios.
Este projeto integra dois serviços distintos:
- Um microserviço Python com FastAPI, responsável por analisar os sentimentos.
- Uma API backend em .NET, estruturada com validações FluentValidation, preparada para integração com banco de dados, serviços e a IA.
## Funcionalidades atuais
- **API Python com FastAPI**
- **Análise de sentimentos com TextBlob (Inglês)**
- **API .NET estruturada com DDD, validação e separação de camadas**
- **Validação com FluentValidation**
## Próximos passos
- Integração entre .NET e Python via HTTP
- Persistência no banco de dados
- Evolução da IA com modelos multilíngues (HuggingFace Transformers)
- Implementação de CI/CD
- Automação de relatórios e alertas inteligentes
## Como rodar o projeto
1. Clone este repositório
2. Navegue até a pasta `ai-python-service`
3. Crie e ative o ambiente virtual
4. Instale as dependências: pip install -r requirements.txt
5. Execute a aplicação: uvicorn app.main:app --reload
6. Acesse a documentação interativa: http://127.0.0.1:8000/docs
# EchoMind API — Dockerfile
O **Dockerfile** presente neste projeto automatiza a criação da imagem Docker da aplicação EchoMind, garantindo a execução da solução em um ambiente totalmente preparado, coerente com suas dependências, e livre de erros durante a execução do container, por meio da utilização de imagem imutável.
Além disso, o desenvolvimento deste arquivo já considera a futura integração com pipelines de **CI/CD**, visando escalar nossa solução e implementar automatizações na geração e entrega de novas imagens.
Este Dockerfile assegura:
- ✅ Portabilidade entre ambientes.
- ✅ Previsibilidade e confiabilidade na execução do serviço.
- ✅ Aderência às boas práticas de **infraestrutura como código**.
- ✅ Preparação para escalabilidade futura e integração simplificada com microserviços, como a camada .NET planejada do EchoMind.
---
## 1. Função Geral
O **Dockerfile** automatiza a construção da imagem Docker do projeto, definindo o ambiente base, as instruções de execução da aplicação e todas as dependências necessárias, garantindo que a aplicação seja construída de forma reproduzível e consistente para qualquer ambiente de execução.
---
## 2. Objetivo dentro do EchoMind
Garantir que a API de análise de sentimentos do EchoMind seja executada:
- 📦 Em um ambiente isolado, consistente e replicável em qualquer máquina ou servidor.
- 🚀 Preparado para integração futura com outros serviços da solução EchoMind.
- 🛠️ Pronto para orquestração multi-container e deploys automatizados em pipelines CI/CD.
---
## 3. Como usar
Siga as seguintes etapas para execução do projeto:
1. Clone o repositório:
```bash
git clone https://github.com/EletherioAlexandre/Echo-Mind
```
2. Dentro da raiz do repositório, execute o comando abaixo para construir a imagem Docker da aplicação:
```bash
docker build -t echomind-py .
```
3. Após gerar a imagem com sucesso, execute o container com:
```bash
docker run -d -p 8000:8000 echomind-py
```
4. Acesse a documentação interativa da API em:
[http://localhost:8000/docs](http://localhost:8000/docs)
---
### 🧩 API .NET
> Essa API está estruturada em múltiplas camadas, com arquitetura inspirada em DDD.
**Projetos:**
- `EchoMind.Api`: camada de apresentação
- `EchoMind.Application`: regras de negócio (UseCases, validações)
- `EchoMind.Communication`: contratos de entrada e saída (DTOs)
- `EchoMind.Domain`: entidades e abstrações
- `EchoMind.Infrastructure`: futura camada de persistência e serviços externos
- `EchoMind.Exception`: camada de tratamento de erros customizados
**Como rodar:**
1. Abra a solução no Visual Studio:
`EchoMind.sln`
2. Defina o projeto `EchoMind.Api` como startup
3. Execute o projeto (F5 ou Ctrl+F5)
---
## 🧱 EchoMind API — Dockerfile (.NET)
> *Ainda não implementado para a API .NET.*
Será estruturado futuramente para facilitar deploy em containers, com CI/CD.
---
## 🧠 Tecnologias Utilizadas
- Python
- FastAPI
- TextBlob
- C# / .NET 8
- FluentValidation
- Docker
- Git & GitHub
---
## Autor
- [Alexandre Junior](https://www.linkedin.com/in/alexandre-junior-ab799719a/)
---