

# #8 Desafio de Programação: Encurtador de Links

## **Descrição**
Desenvolva um sistema completo para encurtar links, utilizando **Docker**, **Traefik** como reverse proxy, e um sistema que **identifique URLs encurtadas automaticamente** com base no domínio e estrutura da URL. O desafio inclui funcionalidades de gerenciamento de links, redirecionamento dinâmico e registro de métricas.

---

## **Objetivo**
1. Criar um sistema que permita encurtar links e gerenciá-los.
2. Permitir que links encurtados sejam redirecionados com base apenas no **short_code** presente na URL.
3. Utilizar **Traefik** como reverse proxy para roteamento dinâmico.
4. Configurar todo o ambiente com **Docker Compose** para facilitar o deploy.

---

## **O que será Aprendido**
1. **Redirecionamento Inteligente:**
   - Processar URLs encurtadas diretamente pelo domínio e path.
2. **APIs Avançadas:**
   - Criar endpoints RESTful para gerenciamento de links.
3. **Docker e Containers:**
   - Orquestrar serviços e ambiente de produção com Docker Compose.
4. **Traefik como Reverse Proxy:**
   - Configurar roteamento dinâmico sem rotas adicionais.
5. **Métricas Avançadas:**
   - Registro de acessos (IP, agente de usuário e data/hora).

---

## **Arquitetura**

### **Diagrama de Arquitetura**
![Fluxo do Encurtador de Links](/assets/challenges/encurtador-de-links/fluxo-encurtador-links.png)

---

## **Especificações Técnicas**

### **Backend**
- **Banco de Dados:** PostgreSQL, MySQL, SQL.
- **Reverse Proxy:** Traefik.
- **Ambiente:** Docker e Docker Compose.
- **Métricas:** Contador de cliques, rastreamento de IPs e agente de usuário.

---

## **Endpoints e Payloads**

### 1. **Criar Link Curto**
- **POST** `/api/shorten`
- **Body:**
  ```json
  {
    "url": "https://exemplo.com/minha-url"
  }
  ```
- **Response:**
  ```json
  {
    "short_url": "https://short.local/abc123",
    "original_url": "https://exemplo.com/minha-url"
  }
  ```

---

### 2. **Redirecionamento**
- O sistema reconhece o formato `https://short.local/{short_code}` automaticamente.
- Ao acessar `https://short.local/abc123`, a requisição é roteada para a API, que:
  1. Busca o `short_code` no banco.
  2. Redireciona o cliente para a URL original com código **`302 Found`**.

---

### 3. **Listar Links Criados**
- **GET** `/api/links`
- **Response:**
  ```json
  [
    {
      "short_url": "https://short.local/abc123",
      "original_url": "https://exemplo.com",
      "clicks": 42
    },
    {
      "short_url": "https://short.local/xyz789",
      "original_url": "https://outra.com",
      "clicks": 15
    }
  ]
  ```

---

### 4. **Excluir Link Curto**
- **DELETE** `/api/links/{short_code}`
- **Response:**
  ```json
  {
    "message": "Link deleted successfully"
  }
  ```

---

## **Resultados Esperados**
1. **Encurtador Funcional:**
   - Gerar links curtos e redirecionar automaticamente sem necessidade de rotas explícitas.
2. **Integração com Traefik:**
   - Roteamento dinâmico baseado em `short_code`.
3. **Métricas Avançadas:**
   - Registro de IPs, agentes de usuário e datas de acesso.
4. **Ambiente Contenerizado:**
   - Docker Compose configurado para fácil deploy.

---

Boa sorte com o desafio! 🚀


Desenvolva um sistema completo de encurtador de links com Docker, Traefik e métricas avançadas. Aprenda a gerenciar redirecionamentos e automatizar o deploy com Docker Compose

#8 Encurtador de Links



# #7 Desafio de Programação: Controle de Assinaturas

## **Descrição**
Desenvolva uma API para gerenciar assinaturas em um sistema SaaS ou serviço de streaming. A API deve lidar com planos de assinaturas, cobrança recorrente, upgrades/downgrades e gerenciamento do ciclo de vida das assinaturas. O sistema será orientado a eventos, utilizando uma fila de mensagens para processar atualizações de cobrança e assinaturas.

---

## **Objetivo**
1. Criar uma API para gerenciar assinaturas e seus planos.
2. Implementar filas para processar eventos de cobrança e atualizações.
3. Atualizar assinaturas automaticamente com base nos eventos processados.
4. Fornecer métricas básicas sobre assinaturas e planos.

---

## **O que será Aprendido**
1. **Mensageria:**
   - Uso de filas (RabbitMQ ou Kafka) para processamento assíncrono de eventos.
2. **Gerenciamento de Assinaturas:**
   - Criação, atualização e cancelamento de assinaturas.
3. **Arquitetura Orientada a Eventos:**
   - Como estruturar um sistema desacoplado utilizando eventos.
4. **Modelagem de Dados:**
   - Estruturas para planos, assinaturas e eventos de pagamento.

---

## **Arquitetura**

### **Diagrama de Fluxo**

![Fluxo Sistema de Assinatura](/assets/challenges/controle-de-assinaturas/fluxo-sistema-assinatura.png)

---

## **Especificações Técnicas**
### **Backend**
- **Mensageria:** RabbitMQ, Kafka ou Redis Streams.
- **Banco de Dados:** PostgreSQL ou MongoDB.

### **Componentes Adicionais**
- **Worker de Processamento:**
  - Processa eventos da fila, como atualizações de cobrança.
- **Fila de Mensagens:**
  - Armazena eventos para processamento assíncrono.

---

## **Endpoints e Payloads**

### 1. **Gerenciamento de Assinaturas**
#### **Criar Assinatura**
- **POST** `/api/subscriptions`
- **Body:**
  ```json
  {
    "plan_id": "plan_12345",
    "customer_email": "cliente@email.com"
  }
  ```
- **Response:**
  ```json
  {
    "subscription_id": "sub_67890",
    "status": "pending",
    "next_billing_date": "2025-02-01"
  }
  ```

#### **Atualização Automática**
- Após a criação, a assinatura entra na fila como um evento do tipo `subscription_created`.

---

### 2. **Webhooks**
#### **Atualização de Cobrança**
- **POST** `/api/webhooks/payment`
- **Body:**
  ```json
  {
    "subscription_id": "sub_67890",
    "event": "payment_success",
    "amount": 29.99,
    "date": "2025-01-01"
  }
  ```
- **Processo:**
  1. A API coloca o evento na fila de mensagens.
  2. O worker processa o evento e atualiza a assinatura no banco.

---

### 3. **Relatórios**
#### **Obter Métricas de Assinaturas**
- **GET** `/api/reports/subscriptions`
- **Response:**
  ```json
  {
    "total_active": 120,
    "total_cancelled": 15,
    "plans": [
      {
        "plan_id": "plan_12345",
        "name": "Basic Plan",
        "active_subscriptions": 80
      },
      {
        "plan_id": "plan_54321",
        "name": "Premium Plan",
        "active_subscriptions": 40
      }
    ]
  }
  ```

---

## **Processos com Mensageria**

### **1. Processamento de Webhook**
1. O provedor de pagamentos envia um evento de pagamento para o webhook.
2. A API valida o evento e o coloca na fila de mensagens.
3. O worker consome o evento e atualiza o status da assinatura no banco.

### **2. Processamento de Assinatura**
1. Após a criação de uma assinatura, um evento `subscription_created` é colocado na fila.
2. O worker verifica a assinatura e simula o envio para o sistema de cobrança.

---

## **Modelo de Dados**

### **Tabelas**
1. **Plans**
   - `id`: UUID.
   - `name`: Nome do plano.
   - `price`: Preço do plano.
   - `billing_cycle`: Mensal ou anual.

2. **Subscriptions**
   - `id`: UUID.
   - `plan_id`: Relacionamento com a tabela de planos.
   - `customer_email`: Email do cliente.
   - `status`: Pendente, Ativa, Suspensa, Cancelada.
   - `next_billing_date`: Data do próximo pagamento.

3. **Events**
   - `id`: UUID.
   - `type`: subscription_created, payment_success, payment_failed.
   - `data`: Dados do evento (JSON).
   - `processed`: Boolean indicando se o evento já foi processado.

---

## **Resultados Esperados**
1. **API Funcional:** Capaz de gerenciar assinaturas e lidar com planos.
2. **Mensageria:** Processamento assíncrono de eventos utilizando filas.
3. **Automação:** Atualização automática de status com base em eventos.
4. **Relatórios:** Métricas básicas sobre assinaturas e planos.

---

## **Publicação**
1. Configure RabbitMQ, Kafka ou Redis em um ambiente local ou na nuvem.
2. Teste os endpoints com ferramentas como Postman ou Insomnia.
3. Realize o deploy em serviços como Heroku, AWS ou Google Cloud.

---

Boa sorte com o desafio! 🚀


Desenvolva uma API para gerenciar assinaturas com mensageria, cobrindo planos, cobrança recorrente e atualizações automáticas com eventos assíncronos

#7 Controle de Assinaturas



# #6 Desafio de Programação: Amigo Secreto

## Descrição
Este desafio propõe a recriação de um sistema para sorteio de Amigo Secreto utilizando IndexDB para armazenamento local. O objetivo é criar uma aplicação simples, funcional e offline-friendly, que permita organizar e realizar sorteios de forma intuitiva. É ideal para aprender sobre tecnologias modernas de front-end e persistência de dados no navegador.

Você pode conferir um exemplo do projeto no post original: [Sorteio de Amigo Secreto](https://racoelho.com.br/posts/sorteio-de-amigo-secreto).

Ou uma demo funcionando nesse link: [Amigo Secreto](https://secret-santa.racoelho.com.br/).

---

## Objetivo
1. Criar uma aplicação web para sorteio de Amigo Secreto.
2. Implementar o armazenamento de dados localmente com **IndexDB**.
3. Publicar a aplicação para uso real.

---

## O que será Aprendido
1. **Persistência de Dados no Front-end:**
   - Como usar o **IndexDB** para salvar informações localmente.
2. **Manipulação de Arrays e Objetos:**
   - Técnicas para criar e embaralhar listas para o sorteio.
3. **Desenvolvimento Web:**
   - Uso de HTML, CSS e JavaScript para criar interfaces interativas.
4. **Publicação de Projetos:**
   - Como hospedar uma aplicação web usando GitHub Pages ou outro serviço.

---

## Especificações do Desafio

### Funcionalidades Obrigatórias
1. **Cadastro de Participantes**
   - Adicionar participantes com nome e email.
   - Listar participantes na tela.

2. **Sorteio do Amigo Secreto**
   - Realizar o sorteio embaralhando a lista de participantes.
   - Garantir que nenhum participante seja seu próprio amigo secreto.
   - Mostrar o resultado de forma segura (ex.: exibir apenas o amigo secreto de cada participante mediante interação).

3. **Armazenamento Local**
   - Salvar os participantes no **IndexDB**.
   - Manter os dados persistentes mesmo ao recarregar a página.

4. **Interface Amigável**
   - Design simples e funcional para cadastro, sorteio e visualização dos resultados.


---
### Telas
Como o projeto é front-end apenas, as operações são feitas localmente, mas seguem uma estrutura lógica:

- Adicionar Participante: Salva no IndexDB.
- Listar Participantes: Recupera do IndexDB.
- Realizar Sorteio: Gera o resultado no front-end e salva no IndexDB.
- Visualizar Resultados: Recupera os dados do sorteio e exibe para o usuário.

---

### Funcionalidades Opcionais (Diferenciais)
1. **Envio de Resultados**
   - Implementar envio de emails para notificar os participantes com seus amigos secretos (usando serviços como EmailJS ou APIs de email).
2. **Temas Personalizáveis**
   - Adicionar a possibilidade de mudar a aparência da aplicação com temas diferentes.
3. **Histórico de Sorteios**
   - Salvar múltiplos sorteios no **IndexDB** e permitir consulta posterior.

---

## Sugestões de Stack

### Frontend
- **HTML5, CSS3 e JavaScript:**
  - Criação da interface e funcionalidades básicas.
- **Frameworks Opcionais:** 
  - **React.js** ou **Vue.js** para componentes reativos.
  - **Tailwind CSS** ou **Bootstrap** para estilização rápida.

### Armazenamento
- **IndexDB:** 
  - API nativa do navegador para armazenamento local de dados.
- **Alternativa:** LocalStorage (menos recomendado para volumes maiores de dados).

### Publicação
- **GitHub Pages:** Hospedar a aplicação de forma gratuita.
- **Netlify** ou **Vercel:** Opções modernas para deploy.

---

## Especificações de Arquitetura

### Frontend
1. **Páginas Principais:**
   - Cadastro de Participantes.
   - Página de Sorteio.
   - Tela de Resultados.
2. **Interatividade:**
   - Manipulação do DOM para adicionar e exibir participantes.
   - Botão para sortear e exibir resultados.


## Fluxo de Uso
1. **Cadastro de Participantes**
   - Usuário adiciona os nomes e emails de cada participante.
   - Os dados são salvos localmente no IndexDB.
2. **Sorteio**
   - Ao clicar no botão "Sortear", o sistema embaralha os participantes e salva os resultados.
3. **Visualização**
   - Cada participante pode acessar seu resultado individualmente.
4. **(Opcional) Notificação**
   - Resultados são enviados por email automaticamente.

---

## Publicação
1. **Preparação**
   - Configure o repositório no GitHub.
   - Use ferramentas como Webpack ou Vite (opcional) para otimizar o projeto.
2. **Deploy**
   - **GitHub Pages:** Configure o repositório para deploy automático.
   - **Netlify/Vercel:** Faça o upload da aplicação com suporte a builds automáticas.
3. **Domínio Personalizado**
   - Opcionalmente, configure um domínio customizado para a aplicação.

---

## Nível do Desafio
- **Intermediário:** Requer conhecimentos básicos de JavaScript, manipulação de dados e APIs do navegador.
- **Avançado (com diferenciais):** Inclui envio de emails, histórico de sorteios e exportação de dados.

---


Boa sorte com o desafio! 🚀


Desenvolva um sistema de sorteio de Amigo Secreto usando IndexDB para armazenar participantes e resultados.

Rafael Coelho

Opa, tudo certo?

Últimos desafios

#8 Encurtador de Links

#7 Controle de Assinaturas

#6 Amigo Secreto

Posts recentes

Como rodar o DeepSeek Localmente

O que são Observers

Como funciona a internet (Parte 4): DNS e Roteamento: Os Nomes da Internet