How baidd1011/shortlink works
ShortLink is a Spring Cloud short-link platform with separate administration and core services, a gateway, and an optional aggregation mode. The main workflow is user management and link organization in admin, remote calls to project for link creation and management, then public redirects; visits are recorded asynchronously and exposed through analytics. The README documents caching, Bloom filters, distributed locks, and sharding, but the sampled sources do not show their wiring. Dashed, uncited edges mark these documented or otherwise unverified relationships; the frontend is outside the supplied source tree.
Main entry points: UserController.java Admin API · ShortLinkController.java Link API · AggregationServiceApplication.java Aggregation mode · ShortLinkRemoteService.java Admin link operations
Components 21
Administration
- Admin API
admin/src/main/java/com/qcl/shortlink/admin/controller/UserController.java - User service
admin/src/main/java/com/qcl/shortlink/admin/service/UserService.java - Link groups
admin/src/main/java/com/qcl/shortlink/admin/service/GroupService.java - Admin link operations
admin/src/main/java/com/qcl/shortlink/admin/remote/ShortLinkRemoteService.java - Admin analytics access
admin/src/main/java/com/qcl/shortlink/admin/remote/ShortLinkRemoteService.java - Admin recycle bin
admin/src/main/java/com/qcl/shortlink/admin/service/RecycleBinService.java
Short-link core
- Link API
project/src/main/java/com/qcl/shortlink/project/controller/ShortLinkController.java - Link operations
project/src/main/java/com/qcl/shortlink/project/service/ShortLinkService.java - Redirect handling
project/src/main/java/com/qcl/shortlink/project/controller/ShortLinkRedirectController.java - Title lookup
project/src/main/java/com/qcl/shortlink/project/service/UrlTitleService.java - Recycle operations
project/src/main/java/com/qcl/shortlink/project/service/RecycleBinService.java
Visit analytics
- Stats API
project/src/main/java/com/qcl/shortlink/project/controller/ShortLinkStatsController.java - Stats queries
project/src/main/java/com/qcl/shortlink/project/service/ShortLinkStatsService.java - Async stats events
project/src/main/java/com/qcl/shortlink/project/mq/producer/ShortLinkStatsSaveProducer.java - Stats persistence
project/src/main/java/com/qcl/shortlink/project/dao/entity/LinkAccessStatsDO.java
Platform services
- Gateway
gateway/src/main/java/com/qcl/shortlink/gateway/filter/TokenValidateGatewayFilterFactory.java - Aggregation mode
aggregation/src/main/java/com/qcl/shortlink/aggregation/AggregationServiceApplication.java - MySQL
- Redis cache
Other components
- User
- Link visitor
Connections 18
- User → Admin API: manages account
- Admin API → User service: delegates
admin/src/main/java/com/qcl/shortlink/admin/controller/UserController.java - User → Link groups: organizes links
- User → Admin link operations: manages links
- Admin link operations → Link API: calls HTTP
admin/src/main/java/com/qcl/shortlink/admin/remote/ShortLinkRemoteService.java - Admin analytics access → Stats API: requests analytics
admin/src/main/java/com/qcl/shortlink/admin/remote/ShortLinkRemoteService.java - Admin recycle bin → Recycle operations: calls remotely
- Link API → Link operations: delegates
project/src/main/java/com/qcl/shortlink/project/controller/ShortLinkController.java - Link visitor → Redirect handling: requests short URL
- Link visitor → Async stats events: generates visit
- Stats API → Stats queries: delegates
project/src/main/java/com/qcl/shortlink/project/controller/ShortLinkStatsController.java - Async stats events → Stats persistence: persists asynchronously
- Link operations → MySQL: stores links
- Stats persistence → MySQL: uses sharded storage
- Redirect handling → Redis cache: caches lookups
- Gateway → Admin API: routes and authenticates
- Aggregation mode → Admin API: combines services
- Aggregation mode → Link API: combines services