#QrLinkki

#Plataforma Moderna de Geração de QR Codes e Encurtador de URLs

QrLinkki é uma plataforma full-stack para criar, gerenciar e rastrear QR codes e URLs encurtadas, com foco em uma experiência nativa para Android. Construída com princípios de Domain-Driven Design.

Funcionalidades • Como Rodar • Stack

---

#Funcionalidades

#Funcionalidades Principais

• Geração de QR Codes — Crie QR codes dinâmicos a partir de qualquer URL ou texto
• Encurtamento de URLs — Gere links curtos e memoráveis com códigos personalizados
• Contagem de Cliques — Visualize quantos acessos seus links tiveram
• Gerenciamento de Usuários — Autenticação segura com tokens JWT
• Redirecionamentos Públicos — Redirecionamento transparente a partir de URLs curtas

#Aplicativo

• Android Nativo — Desenvolvido e otimizado especificamente para o ecossistema Android
• Scanner de QR — Scanner de câmera integrado para QR codes
• Dashboard — Gerencie todos os seus links em um só lugar
• Design Moderno — Interface visualmente agradável
• Cache — Cache local para melhor performance

[!NOTE] Compatibilidade: Este projeto foi desenvolvido e testado exclusivamente em dispositivos Android. Embora utilize React Native, o funcionamento em iOS ou Web não foi verificado e pode exigir adaptações.

#Segurança

• Autenticação JWT — Autenticação segura baseada em tokens
• Acesso Exclusivo do Proprietário — Apenas donos dos links podem modificar seu conteúdo
• Proteção de Dados — Armazenamento seguro de credenciais

---

#Showcase

Algumas telas e exemplos do projeto:

---

#🏗️ Arquitetura

QrLinkki segue os princípios de Clean Architecture e Domain-Driven Design:

┌─────────────────────────────────────────────────────────┐
│                    QrLinkki.Api                         │
│            (Camada de Apresentação / REST API)          │
│          Controllers • Swagger • Autenticação           │
└────────────────────┬────────────────────────────────────┘
                     │
┌────────────────────▼────────────────────────────────────┐
│               QrLinkki.Application                      │
│          (Camada de Aplicação / Casos de Uso)           │
│        Services • DTOs • Orquestração de Negócios       │
└────────────────────┬────────────────────────────────────┘
                     │
┌────────────────────▼────────────────────────────────────┐
│                QrLinkki.Domain                          │
│           (Camada de Domínio / Lógica Central)          │
│         Entidades • Interfaces • Regras de Negócio      │
└────────────────────┬────────────────────────────────────┘
                     │
┌────────────────────▼────────────────────────────────────┐
│             QrLinkki.Infrastructure                     │
│         (Camada de Infraestrutura / Acesso a Dados)     │
│    EF Core • SQLite • Repositories • Migrations         │
└─────────────────────────────────────────────────────────┘

#Arquitetura Frontend

QrLinkki.Web/
├── app/                    # Páginas do Expo Router
│   ├── (auth)/            # Telas de autenticação
│   ├── (tabs)/            # Telas de navegação em abas
│   └── links/             # Telas de gerenciamento de links
├── components/            # Componentes UI reutilizáveis
├── lib/                   # Cliente API e utilitários
├── hooks/                 # Hooks personalizados do React
└── constants/             # Tokens de tema e configurações

---

#Stack

#Backend

#Frontend

#Como Rodar o Projeto

Este projeto utiliza scripts PowerShell para facilitar o build e desenvolvimento Android.

#Pré-requisitos

• Node.js
• JDK 17 ou 21
• Android Studio (para emulador/SDK)

#Instalação

cd QrLinkki.Web
npm install

#Desenvolvimento (Hot Reload)

Para iniciar o servidor de desenvolvimento:

npm run dev:android

Se for a primeira vez rodando, ou se adicionou novas bibliotecas nativas, gere o cliente de desenvolvimento:

npm run build:android:dev

#Staging (Pré-Produção)

Para gerar um APK de staging (instalável ao lado da versão de produção):

npm run build:android:staging

#Produção

Para gerar o APK final:

npm run build:android:release

---

#📡 Endpoints da API

#Autenticação e Usuários

POST   /api/users              # Registrar novo usuário
GET    /api/users              # Listar todos os usuários (autenticado)
GET    /api/users/{id}         # Obter usuário por ID
PUT    /api/users/{id}         # Atualizar usuário
DELETE /api/users/{id}         # Deletar usuário

#Links e QR Codes

POST   /api/links              # Criar link curto com QR code
GET    /api/links              # Obter todos os links do usuário autenticado
GET    /api/links/{code}       # Obter detalhes do link
PUT    /api/links/{code}       # Atualizar link
DELETE /api/links/{code}       # Deletar link
GET    /r/{code}               # Redirecionamento público (rastreia cliques)

#📚 Documentação Completa da API

Quando a API estiver rodando, visite http://localhost:5000/swagger para documentação interativa da API.

---

#Funcionalidades do Frontend

#Fluxo de Autenticação

• Login/registro seguro com JWT
• Atualização automática de token
• Persistência de sessão com armazenamento seguro
• Auto-logout em respostas 401

#Dashboard

• Visão geral visual dos links com estatísticas
• Ações rápidas: copiar, compartilhar, editar, deletar
• Rastreamento de cliques em tempo real
• Layout em grid responsivo

#Gerenciamento de Links

• Criar códigos curtos personalizados
• Gerar QR codes automaticamente
• Definir datas de expiração
• Habilitar/desabilitar links

#Scanner de QR

• Integração nativa com câmera
• Detecção de QR code em tempo real
• Redirecionamento automático ao escanear

---

#🛠️ Desenvolvimento

#Estrutura do Projeto

QrLinkki/
├── QrLinkki.Api/              # Camada de API REST
├── QrLinkki.Application/      # Camada de lógica de negócios
├── QrLinkki.Domain/           # Entidades de domínio e interfaces
├── QrLinkki.Infrastructure/   # Acesso a dados e serviços externos
├── QrLinkki.Web/              # Aplicativo frontend Expo
├── data/                      # Banco de dados SQLite
├── api-storage/               # Uploads de arquivos e QR codes
└── docker-compose.*.yml       # Configurações do Docker

#Executando Testes

# Testes do backend
dotnet test

# Testes do frontend (se configurado)
cd QrLinkki.Web
npm test

#Build para Produção

# Backend
dotnet publish -c Release -o ./publish

# Frontend (Android - usa Gradle)
cd QrLinkki.Web
npm run build:android:release

---

#🐛 Solução de Problemas

#Problemas Comuns

Backend não inicia:

• Certifique-se de que a porta 5000 não está em uso
• Verifique se o .NET 8.0 SDK está instalado
• Verifique as permissões do banco de dados na pasta data/

Frontend não conecta à API:

• Verifique se a API está rodando em http://localhost:5000
• Verifique a configuração de CORS no backend
• Em dispositivos móveis, certifique-se de que PC e celular estão na mesma rede

Problemas de conexão com Expo Go:

• Certifique-se de que os dispositivos estão na mesma rede WiFi
• Verifique as configurações do firewall
• Tente reiniciar o Metro bundler

---

#Notas de Segurança

Importante: O endpoint público de redirecionamento /r/{code} é intencionalmente público para permitir que QR codes sejam escaneados por qualquer pessoa. Se você precisa de links privados, será necessário implementar autenticação neste endpoint (nota: isso quebrará a funcionalidade pública dos QR codes).

• Todas as operações de gerenciamento de links requerem autenticação
• Usuários só podem modificar seus próprios links e perfil
• Tokens JWT são armazenados de forma segura usando Expo SecureStore
• Rastreamento de cliques registra endereços IP para análise

---

#👨‍💻 Contribuidores

QrLinkki é desenvolvido e mantido por:

---

#Suporte

Se você achar este projeto útil, considere dar uma ⭐️ no GitHub!

Para dúvidas ou suporte, por favor abra uma issue.

---

#📄 Licença

Este projeto está licenciado sob a Licença MIT - veja o arquivo LICENSE para detalhes.

---