Welcome to the first official release of LinkForge, an advanced URL shortening and link management platform. This release marks the transition from MVP to a professional-grade, state-of-the-art system.
Core Features
- Deterministic Shortening: Uses TSID (Time-Sorted Unique Identifier) with Base62 encoding for secure, collision-free short links.
- Advanced Analytics: Detailed visualization of link performance, including Geolocation (Country/City), Device Detection, Referrer Tracking, and Time-series Trends.
- Multilingual Support (i18n): Fully localized interface and API in English and Vietnamese with automatic locale detection.
- VIP Subscription Flow: Integrated VNPay payment gateway for automated account upgrades and expiration management.
- Admin Management: Comprehensive administrative dashboard to manage users, links, and system-wide analytics.
- Ad Interstitials: Monetization layer with secure 5-second countdown verification for non-VIP users.
- QR Code Generation: Built-in server-side QR code generation for VIP users and administrators using ZXing.
Architecture & Performance
- Modular Monolith: Clean, maintainable structure with a clear separation between Domain, Application, and Infrastructure layers (Clean Architecture).
- Hybrid Caching (L1/L2): High-speed redirection using Caffeine (In-memory) + Redis (Standalone) for sub-millisecond lookups.
- Database Partitioning: Native PostgreSQL monthly table partitioning for the short_links table, ensuring high performance even with millions of records.
- IP-Based Rate Limiting: Advanced protection against abuse and brute-force attacks using Redis Lua scripts.
- Security & Auth: JWT-based authentication with Refresh Token rotation, BCrypt password hashing, and Role-Based Access Control (RBAC).
- Observability: Structured JSON logging, Spring Actuator health monitoring, and Prometheus metrics integration.
Technology Stack
- Backend: Java 21, Spring Boot 3.5.x, Spring Data JPA, Hibernate, Flyway, TSID, Lettuce (Redis), Micrometer Prometheus, MapStruct, Lombok.
- Frontend: React 19, Vite 7, TypeScript, Tailwind CSS 4, Zustand, React Router 7, Recharts, Lucide Icons, react-hot-toast.
- API Documentation: Fully interactive API docs provided by SpringDoc OpenAPI (Swagger UI).
- Containerization: Multi-stage Docker builds and Docker Compose for one-command deployment of the entire infrastructure.
Created by Truong Le Anh Vu.