Skip to content

Matheus904-12/cx-integration-lab

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

11 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

🚀 BCR Integration Hub (Mini-CX)

Um sistema Full Stack projetado para simular o ecossistema de atendimento ao cliente (CX), demonstrando a integração entre múltiplos canais de vendas (Marketplaces), bancos relacionais/não-relacionais e uma interface baseada no Design System da Zendesk.

Status Zendesk Garden FastAPI Postgres+Mongo

🌐 Acesso ao Projeto (Live)


🎯 Objetivo do Projeto

Demonstrar competência na stack técnica da BCR.CX, focando em:

  1. Arquitetura Híbrida de Dados: Uso simultâneo de SQL (Postgres) para dados transacionais e NoSQL (MongoDB) para auditoria de logs brutos.
  2. Integração de Sistemas: Simulação de um Channel Framework que recebe webhooks de e-commerce.
  3. Frontend Profissional: Utilização do Zendesk Garden (React) para criar interfaces consistentes com o ambiente de trabalho dos agentes.

🛠️ Stack Tecnológica

Backend (Python)

  • Framework: FastAPI (Python 3.11+) para alta performance e tipagem forte.
  • ORM: SQLAlchemy (Gerenciamento do Postgres/Neon).
  • Driver NoSQL: PyMongo (Conexão com MongoDB Atlas).
  • Schema Validation: Pydantic (Garantia de integridade dos dados de entrada).
  • Deploy: Zeabur (Docker Container).

Frontend (React)

  • Core: React 18 + Vite + TypeScript.
  • Design System: @zendeskgarden (Componentes oficiais da Zendesk).
  • Estilização: Styled-components.
  • Deploy: Vercel.

Infraestrutura & Banco de Dados

  • PostgreSQL (Neon.tech): Armazena os Tickets estruturados (Status, IDs, Cliente).
  • MongoDB (Atlas): Armazena o JSON bruto (payload) de cada requisição para fins de log e auditoria (padrão Dual Write).

⚡ Como Rodar Localmente

Pré-requisitos: Node.js, Python 3.10+ e Git.

1. Configurando o Backend

cd backend
# Criar ambiente virtual
python -m venv venv

# Ativar ambiente (Windows)
.\venv\Scripts\activate
# Ou Mac/Linux: source venv/bin/activate

# Instalar dependências
pip install -r requirements.txt

# Configurar variáveis de ambiente (.env)
# Crie um arquivo .env na pasta backend com:
# DATABASE_URL=sua_string_postgres_neon
# MONGO_URI=sua_string_mongo_atlas

# Rodar servidor
uvicorn main:app --reload

About

Laboratório de estudo Full Stack (FastAPI + React) focado em integrações de atendimento e Zendesk.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

No releases published

Packages

 
 
 

Contributors