🔗 Linktreell

Aplicação estilo Linktree desenvolvida em Javascript com Node.js, com foco em Análise e Visualização de Dados.

📌 Sumário

1. Sobre o Projeto
2. Objetivos
3. Tecnologias
4. Funcionalidades
5. Pré-requisitos
6. Instalação
7. Como utilizar
8. Estrutura do Projeto
9. Contribuição
10. Licença
11. Contato
12. Recursos Adicionais

💻 Sobre o Projeto

O Linktrell é uma aplicação pessoal que replica as funcionalidades do Linktree, mas com um diferencial: o foco em Análise e Visualização de Dados utilizando Javascript e Node.js.

• Motivação: Aprimorar habilidades de desenvolvimento web, pensamento crítico e principalmente análise de dados.
• Público-alvo: Estudantes de programação, desenvolvedores iniciantes e analistas.

🎯 Objetivos

🛠️ Técnicos

• Implementar corretamente lógica de BFF (Back-end For Front-end)
• Garantir uma segurança mínima com Express, variáveis de ambiente, middleware de conexão e guarda de sessão.
• Gerar dashboards para analisar métricas e dados de forma visual e intuitiva.

🚀 Tecnologias

Núcleo do Sistema

• Javascript
• Node.js
• Express

✨ Funcionalidades

• ✅ Tela inicial (index): A visualização pública do seu Linktree.
• ✅ Tela de login: Acesse rota de administração.
  • Senha: admin123 (para fins de demonstração).
• ✅ Tela de Insights: Visualize e avalie todas as métricas e painéis para análise de dados.
• ✅ Design descomplicado: Interface descomplicada e fácil de usar.

⚙️ Pré-requisitos

• Node.js (Necessário que esteja instalado corretamente.)
• 2GB+ RAM (4GB recomendado)
• Conexão estável à internet

🛠️ Instalação

1. Clone o repositório:

git clone https://github.com/lucasgleria/linktrell.git

2. Navegue até o back-end:

cd backend

3. Construa o projeto:

npm init -y

4. Instale as dependencias do projeto:

npm install geoip-lite express-session dotenv cors express

5. Crie um arquivo ".env" na pasta backend:

# Cole ou faça o seu
PORT=3000
PASSWORD_HASH = 240be518fabd2724ddb6f04eeb1da5967448d7e831c08c8fa822809f74c720a9
SESSION_SECRET = 'sua_senha_secreta_aqui'

Ps: O hash da senha (PASSWORD_HASH) está exposto porque a senha de acesso (admin123) já foi informada e esta aplicação não está em deploy.

❗ Como Utilizar

1. Navegue até o backend:

cd backend

2. Inicie o backend:

node index.js

3. Acesse no seu navegador:

• Página Principal: http://localhost:3000/index.html
• Página de Login: http://localhost:3000/login.html

▶️ Demonstração

(Gif meramente ilustrativo)

📂 Estrutura do Projeto

├── backend/                    # Pasta de serviço backend  
├── css/                        # Pasta de estilização
├── img/                        # Pasta de mídia
├── js/                         # Pasta de lógica Javascript
│   ├── auth/                   # Pasta de segurança
│   ├── core/                   # Pasta delógica principal
│   ├── metrics/                # Pasta de lógica de métricas
│   |   |   ├── charts/         # Pasta de Lógica de Gráficos (Em construção) 
│   |   |   ├── data-analysis/  # Pasta de Lógica de Análise de dados
│   ├── utils/                  # Pasta de Funções utilitárias
├── index.html                  # Página principal
├── insights.html               # Página de análise de dados
├── login.html                  # Página de login   
├── LICENSE                     # Licença MIT  
└── README.md                   # Este arquivo

🤝 Contribuição

Contribuições são bem-vindas! Siga estas etapas:

1. Reporte bugs: Abra uma issue no GitHub.
2. Sugira melhorias: Envie ideias ou pull requests com novas funcionalidades.
3. Desenvolva:
   • Faça um fork do projeto.
   • Crie uma branch (git checkout -b feature/nova-funcionalidade).
   • Envie um Pull Request.

📜 Licença

MIT License - Veja LICENSE para detalhes.

📞 Contato & Evidências

• Autor: Lucas Leria
• LinkedIn: lucasgleria

🔍 Recursos Adicionais

• Linktree - Referência inicial
• Node.js - Documentação oficial
• Express - Documentação oficial
• Geoip-lite - Como instalar