How petruhertea/quicklink works
QuickLink is a URL-shortening web application. A user submits one or more URLs; the controller validates them, applies tier rules, and asks the URL service to create links. Visitors follow short codes to be redirected, while owners use dashboards and analytics. Separate branches cover OAuth identity, paid subscriptions, QR codes, expiry notices, and ad suppression. Source excerpts show controller-to-service calls and parts of OAuth and notification handling; some implementation details, including analytics persistence and payment wiring, are unsampled, so those links are omitted or marked unverified.
Main entry points: ShortenUrlController.java Shorten and redirect · ShortenedUrlServiceImpl.java Link operations · LinkExpiryNotificationService.java Expiry notices · WebController.java Dashboard and pages
Components 26
Links and analytics
- Shorten and redirect
src/main/java/com/petruth/urlshortener/controller/ShortenUrlController.java - URL safety
src/main/java/com/petruth/urlshortener/service/UrlSafetyService.java - Link operations
src/main/java/com/petruth/urlshortener/service/ShortenedUrlServiceImpl.java - Link records
src/main/java/com/petruth/urlshortener/repository/ShortenedUrlRepository.java - Click analytics
src/main/java/com/petruth/urlshortener/service/AnalyticsService.java - Click records
src/main/java/com/petruth/urlshortener/repository/ClickAnalyticsRepository.java - QR generation
src/main/java/com/petruth/urlshortener/service/QRCodeService.java - Dashboard and pages
src/main/java/com/petruth/urlshortener/controller/WebController.java - Link request models
src/main/java/com/petruth/urlshortener/dto/UrlRequest.java
Accounts and access
- User accounts
src/main/java/com/petruth/urlshortener/service/UserServiceImpl.java - User records
src/main/java/com/petruth/urlshortener/repository/UserRepository.java - OAuth login
src/main/java/com/petruth/urlshortener/service/CustomOAuth2UserService.java - OIDC login
src/main/java/com/petruth/urlshortener/service/CustomOidcUserService.java - Provider links
src/main/java/com/petruth/urlshortener/repository/UserOAuthProviderRepository.java
Premium and ads
- Payment endpoints
src/main/java/com/petruth/urlshortener/controller/PaymentController.java - Subscription service
src/main/java/com/petruth/urlshortener/service/PaymentService.java - Ad suppression
src/main/java/com/petruth/urlshortener/interceptor/AdInterceptor.java
Notifications and tools
- Extension tokens
src/main/java/com/petruth/urlshortener/service/ExtensionTokenService.java - Expiry notices
src/main/java/com/petruth/urlshortener/service/LinkExpiryNotificationService.java - Email delivery
src/main/java/com/petruth/urlshortener/service/BrevoEmailService.java - Notification endpoints
src/main/java/com/petruth/urlshortener/controller/NotificationController.java
Other components
- Visitor
- Link owner
- OAuth providers
- Stripe
- Brevo email
Connections 28
- Link owner → Shorten and redirect: submits links
README.md - Shorten and redirect → Link request models: accepts requests
src/main/java/com/petruth/urlshortener/controller/ShortenUrlController.java - Shorten and redirect → URL safety: checks URLs
src/main/java/com/petruth/urlshortener/controller/ShortenUrlController.java - Shorten and redirect → Link operations: creates links
src/main/java/com/petruth/urlshortener/controller/ShortenUrlController.java - Shorten and redirect → Click analytics: records clicks
src/main/java/com/petruth/urlshortener/controller/ShortenUrlController.java - Shorten and redirect → QR generation: requests QR
src/main/java/com/petruth/urlshortener/controller/ShortenUrlController.java - Visitor → Shorten and redirect: opens short link
README.md - Link operations → Link records: persists links
src/main/java/com/petruth/urlshortener/service/ShortenedUrlServiceImpl.java - Link operations → Click records: persists click data
- Link owner → Dashboard and pages: views reports
README.md - Dashboard and pages → Link operations: lists and searches
src/main/java/com/petruth/urlshortener/controller/WebController.java - Dashboard and pages → Click records: loads click metrics
src/main/java/com/petruth/urlshortener/controller/WebController.java - OAuth providers → OAuth login: authenticates
src/main/java/com/petruth/urlshortener/service/CustomOAuth2UserService.java - OAuth providers → OIDC login: authenticates
src/main/java/com/petruth/urlshortener/service/CustomOidcUserService.java - OAuth login → User accounts: finds and saves users
src/main/java/com/petruth/urlshortener/service/CustomOAuth2UserService.java - OIDC login → User accounts: finds and saves users
src/main/java/com/petruth/urlshortener/service/CustomOidcUserService.java - OAuth login → Provider links: links provider
src/main/java/com/petruth/urlshortener/service/CustomOAuth2UserService.java - OIDC login → Provider links: links provider
src/main/java/com/petruth/urlshortener/service/CustomOidcUserService.java - User accounts → User records: stores accounts
src/main/java/com/petruth/urlshortener/service/UserServiceImpl.java - Link owner → Payment endpoints: manages subscription
README.md - Payment endpoints → Subscription service: handles payments
src/main/java/com/petruth/urlshortener/controller/PaymentController.java - Subscription service → Stripe: creates subscription
- Link owner → Ad suppression: uses free tier
README.md - Expiry notices → Link records: finds expiring links
src/main/java/com/petruth/urlshortener/service/LinkExpiryNotificationService.java - Expiry notices → User records: loads recipients
src/main/java/com/petruth/urlshortener/service/LinkExpiryNotificationService.java - Expiry notices → Email delivery: sends notices
src/main/java/com/petruth/urlshortener/service/LinkExpiryNotificationService.java - Email delivery → Brevo email: delivers email
- Notification endpoints → Extension tokens: issues tokens
src/main/java/com/petruth/urlshortener/controller/NotificationController.java