Skip to content

gugacyber/hermes-project

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

7 Commits
 
 
 
 
 
 
 
 

Repository files navigation

⚡ Hermes Swiftech Engine

Named after the messenger of the gods, Hermes is a high-performance URL shortener and analytics engine. This project demonstrates a modern Full Stack architecture with high scalability and internationalization (i18n).

Hermes Swiftech Dashboard

🌐 Live Demo

View Project Live

🛠️ Tech Stack

  • Backend: Java 17, Spring Boot 3, Spring Data JPA, Hibernate.
  • Frontend: React, TypeScript, Vite, Tailwind CSS v4, i18next.
  • Database: PostgreSQL (Neon.tech).
  • Icons: Lucide React.

🚀 Key Engineering Features

  • Base62 Custom Encoding: Advanced algorithm to transform database IDs into unique, compact short codes.
  • Root-Level Redirection: Optimized URL structure for the shortest possible paths (e.g., host/b).
  • Global Reach (i18n): Full support for English, Portuguese, and Spanish with automatic language detection.
  • Live Analytics: Real-time click tracking and "Most Traveled Paths" dashboard.
  • Resilient UI: Custom error handling and 404 "Path Lost" redirection for non-existent codes.

📂 Architecture

The system follows a clean separation of concerns:

  1. API Layer: REST Controllers handling HTTP requests and redirections.
  2. Service Layer: Business logic and encoding algorithms.
  3. Data Layer: PostgreSQL persistence with optimized JPA queries.
  4. Client Layer: Reactive UI with state management and context-aware translations.

🔧 Installation & Setup

  1. Clone the repository
    git clone [https://github.com/engguga/hermes-project.git](https://github.com/engguga/hermes-project.git)
    

Developed with ⚡ by Gustavo Viana

About

⚡ Hermes: A swift and scalable URL shortener engine with a modern dashboard and global reach through internationalization.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors