🏦 Coop Cred

Sistema de cooperativa de crédito digital, desenvolvido com Node.js e Javascript.
Oferece funcionalidades de contas, transações, relatórios financeiros com agregações MongoDB, autenticação JWT e documentação automática via Swagger, além de deploy automatico para AWS ECS com banco de dados persistente.

Este serviço complementa o Coop Cred Front

---

🚀 Tecnologias utilizadas

🧠 Backend

🧩 Documentação

🧪 Testes

🧰 Ambiente & DevOps

📈 Monitoramento e Logs

💬 Linguagem

---

🧩 Próximas integrações

---

📁 Estrutura do projeto

github/
├── workflows/ # Arquivo github actions para CI/CD
src/
├── config/ # Configurações (DB e Logs)
├── controllers/ # Regras de entrada da API
├── erros/ # Definições de erros
├── middlewares/ # JWT, errorHandler, logsMorgan
├── models/ # Schemas Mongoose
├── routes/ # Rotas Express
├── services/ # Lógica de negócios
├── tests/ # Testes unitarios e integrados
├──├─── factories/ # Criar dados de teste para reaproveitamento
├──├─── helpers/ # Configurações e utilitários
├──├─── integration/ # Testes integrados
├──├─── unit/ # Testes unitarios
├──├───├─── controllers/ # Testes dos controllers
├──├───├─── services/ # Testes dos services
├──├─── unit/ # Testes unitarios
├── app.js # Definições do servidor
├── server.js # Inicialização do servidor
└── Dockerfile # Nosso docker da aplicação
└── docker-compose.yml # Nosso container contendo a aplicação e o banco mongoDb

---

⚙️ Configuração e execução local

1️⃣ Clonar o repositório

git clone https://github.com/raimundofullstack/coop-cred.git
cd coop-cred

2️⃣ Instalar dependências

yarn install --frozen-lockfile

3️⃣ Criar arquivo .env

Crie o arquivo na raiz do projeto com as variáveis:

PORT=3000
MONGO_URL=mongodb://localhost:27017/nome-do-banco
JWT_SECRET=sua-chave-secreta
NODE_ENV=development
SENTRY_DSN=https://uuid@string.ingest.us.sentry.io/numberProject

4️⃣ Rodar em modo desenvolvimento

yarn dev

Depois, acesse: 📄 http://localhost:3000/docs

📚 Endpoints principais

Módulo	Rota base	Descrição
👤 Usuários	/api/users	Registro e login com JWT
💳 Contas	/api/accounts	Criação e consulta de conta
💸 Transações	/api/transactions	Depósito, saque e transferência
📊 Relatórios	/api/reports	Agregações financeiras e resumos

🧠 Agregações e relatórios

• Totais por tipo de transação
• Resumo mensal de entradas/saídas (a fazer)
• Saldo consolidado (a fazer)

Preparado para dashboards e gráficos no front-end

🧪 Testes

yarn test

💡 Próximos módulos

Módulo	Descrição
🏦 Crédito	Crédito Controle de limite, juros e crédito rotativo

👨‍💻 Autor

Raimundo Martins | Desenvolvedor Full Stack

💼 Projeto desenvolvido para fins de demonstração de arquitetura back-end moderna com Node.js, JavaScript e MongoDB.