How davidandr1/url-shortener works
SwiftURL is a full-stack short-link service. A user registers or logs in, submits a long URL, and receives a Base62 link; visitors follow that link to be redirected, while click data is queued for asynchronous persistence. Authenticated users can list their links. The graph includes the documented Redis cache, expiry behavior, and hashed-IP click tracking. Some subsystems are documented but their implementation was not sampled, so those relationships are shown only where the README or excerpts support them.
Main entry points: LinkController.java Link endpoints · App.jsx React app · LinkService.java Cached lookup and expiry · UserRepository.java User repository
Components 20
Web client
- React app
frontend/src/App.jsx
Identity and access
- Auth endpoints
backend/src/main/java/com/davidandriychuk/url_shortener/controller/AuthController.java - User registration
backend/src/main/java/com/davidandriychuk/url_shortener/controller/UserController.java - JWT security
backend/src/main/java/com/davidandriychuk/url_shortener/security/SecurityConfig.java - JWT issue and validation
backend/src/main/java/com/davidandriychuk/url_shortener/security/JWTGenerator.java - JWT request filter
backend/src/main/java/com/davidandriychuk/url_shortener/security/JWTAuthenticationFilter.java - User lookup
backend/src/main/java/com/davidandriychuk/url_shortener/service/CustomUserDetailsService.java - User repository
backend/src/main/java/com/davidandriychuk/url_shortener/repository/UserRepository.java
Link lifecycle
- Link endpoints
backend/src/main/java/com/davidandriychuk/url_shortener/controller/LinkController.java - Cached lookup and expiry
backend/src/main/java/com/davidandriychuk/url_shortener/service/LinkService.java - Link repository
backend/src/main/java/com/davidandriychuk/url_shortener/repository/LinkRepository.java - Link and Base62 code
backend/src/main/java/com/davidandriychuk/url_shortener/entity/Link.java - Redis cache
Click analytics
- RabbitMQ routing config
backend/src/main/java/com/davidandriychuk/url_shortener/config/RabbitConfig.java - RabbitMQ
- Click event consumer
backend/src/main/java/com/davidandriychuk/url_shortener/messaging/ClickEventConsumer.java - Visitor IP hashing
backend/src/main/java/com/davidandriychuk/url_shortener/util/IpHasher.java - Click event repository
backend/src/main/java/com/davidandriychuk/url_shortener/repository/ClickEventRepository.java
Other components
- User
- PostgreSQL
Connections 26
- User → React app: uses
frontend/src/App.jsx - React app → Auth endpoints: logs in
frontend/src/App.jsx - React app → User registration: registers
README.md - React app → Link endpoints: creates and lists
frontend/src/App.jsx - Auth endpoints → JWT issue and validation: issues token
backend/src/main/java/com/davidandriychuk/url_shortener/controller/AuthController.java - JWT security → JWT request filter: registers filter
backend/src/main/java/com/davidandriychuk/url_shortener/security/SecurityConfig.java - JWT request filter → JWT issue and validation: validates token
backend/src/main/java/com/davidandriychuk/url_shortener/security/JWTAuthenticationFilter.java - JWT request filter → User lookup: loads identity
backend/src/main/java/com/davidandriychuk/url_shortener/security/JWTAuthenticationFilter.java - User lookup → User repository: looks up user
backend/src/main/java/com/davidandriychuk/url_shortener/service/CustomUserDetailsService.java - User registration → User repository: persists user
backend/src/main/java/com/davidandriychuk/url_shortener/controller/UserController.java - Link endpoints → User repository: resolves owner
backend/src/main/java/com/davidandriychuk/url_shortener/controller/LinkController.java - Link endpoints → Link repository: saves and lists
backend/src/main/java/com/davidandriychuk/url_shortener/controller/LinkController.java - Link endpoints → Link and Base62 code: encodes code
backend/src/main/java/com/davidandriychuk/url_shortener/controller/LinkController.java - Link endpoints → Cached lookup and expiry: resolves redirect
backend/src/main/java/com/davidandriychuk/url_shortener/controller/LinkController.java - Cached lookup and expiry → Link repository: loads by id
backend/src/main/java/com/davidandriychuk/url_shortener/service/LinkService.java - Cached lookup and expiry → Link and Base62 code: decodes and checks
backend/src/main/java/com/davidandriychuk/url_shortener/service/LinkService.java - Cached lookup and expiry → Redis cache: caches lookup
README.md - Link repository → PostgreSQL: persists links
README.md - User repository → PostgreSQL: persists users
README.md - Link endpoints → RabbitMQ routing config: uses routing
backend/src/main/java/com/davidandriychuk/url_shortener/controller/LinkController.java - Link endpoints → RabbitMQ: publishes click
backend/src/main/java/com/davidandriychuk/url_shortener/controller/LinkController.java - RabbitMQ routing config → RabbitMQ: configures route
- RabbitMQ → Click event consumer: delivers event
README.md - Click event consumer → Visitor IP hashing: hashes visitor IP
backend/src/main/java/com/davidandriychuk/url_shortener/messaging/ClickEventConsumer.java - Click event consumer → Click event repository: saves click
backend/src/main/java/com/davidandriychuk/url_shortener/messaging/ClickEventConsumer.java - Click event repository → PostgreSQL: persists events
README.md