LinkCM

LinkCM e um encurtador de URLs full stack feito com ASP.NET Core, Entity Framework Core, SQL Server e React. A aplicacao permite transformar uma URL longa em um link curto, persistir esse link no banco e redirecionar acessos futuros para a URL original contabilizando cliques.

Visao Geral

• Frontend em React com Vite para inserir a URL, enviar a requisicao e copiar o link gerado.
• API em ASP.NET Core para validar URLs, gerar codigos curtos e redirecionar acessos.
• Persistencia com SQL Server e Entity Framework Core.
• Migrations aplicadas automaticamente na inicializacao da API.
• Suporte a codigo personalizado com exatamente 6 caracteres alfanumericos.
• Expiracao de links, status ativo e contagem de acessos.
• Ambiente containerizado com Docker Compose.
• Testes unitarios para geracao de codigos e validacao de URLs.

Fluxo da Aplicacao

flowchart TD
    A[Usuario acessa o frontend React] --> B[Informa uma URL longa]
    B --> C[Frontend envia POST /api/urls]
    C --> D{API valida a URL}
    D -- Invalida --> E[Retorna 400 Bad Request]
    D -- Valida --> F{Existe codigo personalizado?}
    F -- Sim --> G[Valida codigo de 6 caracteres alfanumericos]
    G -- Ja usado --> H[Retorna 409 Conflict]
    G -- Disponivel --> I[Cria entidade URLCurta]
    F -- Nao --> J[Gera codigo curto aleatorio]
    J --> K{Codigo colidiu?}
    K -- Sim --> L[Tenta gerar novamente ate 5 vezes]
    L --> J
    K -- Nao --> I
    I --> M[Salva no SQL Server via EF Core]
    M --> N[Retorna 201 Created com URL curta]
    N --> O[Frontend exibe link e opcao de copiar]
    O --> P[Usuario acessa /shortCode]
    P --> Q{Link existe, esta ativo e nao expirou?}
    Q -- Nao --> R[Retorna 404 Not Found]
    Q -- Sim --> S[Incrementa cliques e atualiza ultimo acesso]
    S --> T[Redireciona para a URL original]

Loading

Arquitetura

LinkCM
+-- LINKCM.API
|   +-- Controllers       # Endpoints HTTP
|   +-- Data              # DbContext
|   +-- DTOs              # Contratos de entrada e saida
|   +-- Models            # Entidade URLCurta
|   +-- Services          # Gerador de codigos curtos
|   +-- Migrations        # Historico EF Core
|   +-- Tests             # Testes xUnit
+-- LINKCM.Frontend
|   +-- src               # Aplicacao React/Vite
+-- docker-compose.yml    # API, frontend e SQL Server

Tecnologias

• .NET 10
• ASP.NET Core
• Entity Framework Core
• SQL Server 2022
• React
• Vite
• Docker e Docker Compose
• xUnit

Como Executar com Docker

Crie um arquivo .env na raiz do projeto:

SA_PASSWORD=SuaSenhaForte!123

Suba os containers:

docker compose up --build

Servicos disponiveis:

• Frontend: http://localhost:5173
• API: http://localhost:8080
• SQL Server: localhost:1433

Na primeira inicializacao, a API aplica automaticamente as migrations do Entity Framework e cria o banco LinkCM.

Para parar:

docker compose down

Para parar e remover tambem o volume do banco:

docker compose down -v

Como Executar Localmente

API

Entre na pasta da API:

cd LINKCM.API
dotnet restore
dotnet run

A API sobe em:

http://localhost:8080

Frontend

Entre na pasta do frontend:

cd LINKCM.Frontend
npm install
npm run dev

Configure a URL da API no ambiente do Vite, quando necessario:

VITE_API_URL=http://localhost:8080

Endpoints

Criar URL curta

POST /api/urls
Content-Type: application/json

Corpo minimo:

{
  "url": "https://exemplo.com/minha-url-muito-longa"
}

Corpo com codigo personalizado e expiracao:

{
  "url": "https://exemplo.com/minha-url-muito-longa",
  "customCode": "Abc123",
  "dataExpira": "2026-12-31T23:59:59"
}

Resposta de sucesso:

{
  "id": 1,
  "urlCurta": "http://localhost:8080/Abc123",
  "urlOriginal": "https://exemplo.com/minha-url-muito-longa",
  "shortCode": "Abc123",
  "dataCriacao": "2026-07-28T10:00:00",
  "dataExpira": "2026-12-31T23:59:59",
  "contasAcessadas": 0
}

Possiveis retornos:

• 201 Created: URL curta criada.
• 400 Bad Request: URL invalida, codigo invalido ou data de expiracao no passado.
• 409 Conflict: codigo personalizado ja esta em uso.
• 503 Service Unavailable: nao foi possivel gerar um codigo unico apos as tentativas.

Redirecionar URL curta

GET /{shortCode}

Se o link existir, estiver ativo e nao estiver expirado, a API incrementa a contagem de cliques, atualiza o ultimo acesso e redireciona para a URL original.

Testes

Execute os testes da API:

dotnet test LINKCM.API/Tests/LinkCM.Tests.csproj

Os testes cobrem:

• tamanho padrao do codigo curto;
• validacao de codigos personalizados;
• validacao de URLs com http e https.

Regras de Negocio

• URLs aceitas precisam comecar com http ou https.
• Codigo personalizado precisa ter exatamente 6 caracteres alfanumericos.
• Codigos curtos sao unicos no banco.
• Links sem data de expiracao informada expiram em 1 ano.
• Links expirados, inativos ou inexistentes retornam 404.
• Cada redirecionamento valido incrementa QuantidadeCliques.

Conteudo para LinkedIn

O arquivo LINKEDIN_POST.md contem um diagrama Mermaid e um texto pronto para publicacao sobre o projeto.