Todos os projetos
Projeto pessoalAplicação / fevereiro 2025

ESTUDO DE CASO · ykminiurl

YKMiniURL.

Aplicação fullstack gratuita para encurtar, proteger e acompanhar links. Permite criar URLs curtas para compartilhar com facilidade, proteger links com senha e consultar estatísticas de acesso. O projeto também oferece uma API própria, com documentação interativa e acesso gratuito para que outros desenvolvedores possam integrar o serviço às suas aplicações.

Conheça o processo
Imagem do projeto YKMiniURL
Imagem mobile do projeto YKMiniURL

Categoria

Pessoal

Período

fevereiro 2025

Duração

1 semana

StackNext.jsTypeScriptTailwindCSSNode.jsExpress.jsMongoDBBcryptCORSSwaggerFigmaPhotoshop

01 / Visão geral

Um problema real. Uma solução pensada.

Desenvolver uma aplicação para encurtamento de URLs, com gerenciamento de links, proteção por senha e acompanhamento de acessos. Além da plataforma, construí uma API independente para disponibilizar os recursos do serviço a outros desenvolvedores, com documentação para consulta e integração.

O objetivo de YKMiniURL

02 / Estrutura

Como foi construído

As peças que formam a experiência, da interface à camada de dados.

01 / 02

Frontend

Desenvolvi a interface com Next.js, TypeScript e TailwindCSS, seguindo o planejamento visual realizado previamente no Figma. Implementei os fluxos de criação e gerenciamento de links, consulta de estatísticas e acesso aos links protegidos. Também desenvolvi a página de documentação da API, permitindo que os usuários conheçam e explorem os recursos disponíveis no serviço.

02 / 02

Backend & dados

Construí uma API própria com Node.js, Express e MongoDB, separada do frontend e organizada em controllers e middlewares. Implementei a criação de URLs curtas, o redirecionamento para os endereços originais e o registro de informações de acesso. Para os links protegidos, utilizei Bcrypt para gerar hashes das senhas, exigindo sua validação tanto para consultar informações do link quanto para acessar seu destino. A API também foi documentada com Swagger e disponibilizada para utilização externa.

02 / Processo de construção

Da primeira ideia ao produto

Etapa 0101

Planejamento e prototipação

Antes de iniciar a implementação, desenvolvi o protótipo da interface no Figma, definindo a organização das telas, os componentes e os principais fluxos de utilização. Também trabalhei nos elementos visuais do projeto antes de transformar o planejamento em código.

Etapa 0202

Desenvolvimento da interface

Implementei a aplicação com Next.js, TypeScript e TailwindCSS, desenvolvendo as telas de criação e gerenciamento de links, consulta de informações e estatísticas. Também construí a experiência de acesso aos links protegidos e a página dedicada à documentação da API.

Etapa 0303

Construção da API e integração

Desenvolvi o backend de forma independente utilizando Node.js e Express, conectado ao MongoDB. Organizei a aplicação em controllers e middlewares, implementando os recursos necessários para criar URLs curtas, recuperar informações dos links, registrar acessos e realizar redirecionamentos. Depois, integrei a API ao frontend.

Etapa 0404

Implementação da proteção por senha

Implementei um mecanismo de proteção para links privados utilizando Bcrypt para gerar hashes das senhas. A validação é exigida tanto na consulta dos detalhes de um link protegido quanto no momento de acessar o endereço original, impedindo o acesso sem a senha correta.

Etapa 0505

Documentação e disponibilização da API

Documentei os endpoints utilizando Swagger e disponibilizei uma página para que outros desenvolvedores possam consultar e testar as funcionalidades da API. Também mantive o backend hospedado e acessível externamente, permitindo que o serviço seja integrado a outras aplicações.

05 ETAPAS

03 / Decisões técnicas

Não foi sobre usar tudo.Foi sobre escolher bem.

Cada tecnologia entrou para atender uma necessidade real e melhorar a forma como o projeto funciona.

NecessidadeEscolhaImpacto
  1. 01

    Figma

    Por que entrou

    Utilizado para prototipar a interface antes da implementação, definir a organização das telas e planejar os principais fluxos de navegação.

  2. 02

    Next.js + TypeScript

    Por que entrou

    Utilizados na construção do frontend, permitindo organizar a aplicação em componentes e páginas, com tipagem para estruturar os dados e as funcionalidades.

  3. 03

    Node.js + Express

    Por que entrou

    Escolhidos para desenvolver uma API independente do frontend, separando as responsabilidades entre controllers e middlewares e permitindo disponibilizar os recursos para integrações externas.

  4. 04

    MongoDB

    Por que entrou

    Utilizado para armazenar os links cadastrados, suas configurações de proteção e as informações necessárias para acompanhar os acessos.

  5. 05

    Bcrypt

    Por que entrou

    Utilizado para gerar hashes das senhas associadas aos links protegidos, evitando armazená-las diretamente no banco de dados e permitindo validar as tentativas de acesso.

  6. 06

    CORS

    Por que entrou

    Utilizado para configurar as permissões de acesso à API entre origens diferentes, permitindo a comunicação com o frontend hospedado separadamente.

  7. 07

    Swagger

    Por que entrou

    Utilizado para documentar os endpoints e disponibilizar uma interface interativa para consulta e testes da API, facilitando sua utilização por outros desenvolvedores.

Decisões guiadas pelo contexto07 escolhas

04 / O que você encontra

Cada recurso tem seu espaço.

Explore uma função por vez e veja como cada parte contribui para a experiência.

Recurso 01

Encurtamento de URLs.

Crie links curtos a partir de endereços longos e utilize os novos links para compartilhar conteúdos com mais facilidade.

01 / 08

Selecione um tema ou deslize para explorar

Próximo capítulo

Caminho Digital da Bíblia

Plataforma de estudo bíblico que desenvolvi para minha mãe utilizar na igreja. O projeto reúne leitura e busca de passagens bíblicas, consulta ao significado de palavras diretamente no texto, leitura em voz alta e um blog onde os usuários podem publicar conteúdos e interagir. Utilizei React e Firebase para construir a aplicação e integrar autenticação, banco de dados e funcionalidades interativas.

Explorar próximo projeto
YKMiniURL | app : personal | Daniel Rocha