How hirongbao/servicehub works
ServiceHub is a Spring Boot service hub exposing administrator APIs and separate file, short-link, and personal-site capabilities. A typical API-client workflow authenticates a Service Token, invokes a capability endpoint, and records usage; administrators also manage tokens and inspect usage. File uploads are validated and deduplicated before COS storage, while short links support redirects and visit analytics. The graph follows README capabilities and sampled service/controller calls; unsampled subsystem wiring is left conservative.
Main entry points: ServiceTokenService.java Token Service · HirongbaoHubController.java Public Site API · ShortLinkService.java Short Link Logic · PublicFileHubController.java File Endpoints
Components 28
Admin and Auth
- Application Entry
servicehub-admin/src/main/java/com/shirongbao/admin/ServiceHubApplication.java - Admin Auth API
servicehub-admin/src/main/java/com/shirongbao/admin/controller/AdminController.java - Token API
servicehub-admin/src/main/java/com/shirongbao/admin/controller/TokenController.java - Usage API
servicehub-admin/src/main/java/com/shirongbao/admin/controller/UsageController.java - Overview API
servicehub-admin/src/main/java/com/shirongbao/admin/controller/OverviewController.java - Access Logs
servicehub-admin/src/main/java/com/shirongbao/admin/controller/LogController.java - Token Service
servicehub-authhub/src/main/java/com/shirongbao/authhub/service/ServiceTokenService.java - Token and Usage Data
servicehub-authhub/src/main/java/com/shirongbao/authhub/mapper/ServiceTokenMapper.java - Access Log Data
servicehub-admin/src/main/java/com/shirongbao/admin/controller/LogController.java
FileHub
- File Endpoints
servicehub-filehub/src/main/java/com/shirongbao/filehub/controller/PublicFileHubController.java - File Records
servicehub-filehub/src/main/java/com/shirongbao/filehub/service/FileRecordService.java - File Metadata
servicehub-filehub/src/main/java/com/shirongbao/filehub/mapper/FileRecordMapper.java - COS Storage
servicehub-filehub/src/main/java/com/shirongbao/filehub/service/CosStorageService.java
LinkHub
- Public Link API
servicehub-linkhub/src/main/java/com/shirongbao/linkhub/controller/PublicLinkController.java - Short Link Logic
servicehub-linkhub/src/main/java/com/shirongbao/linkhub/service/ShortLinkService.java - Links and Visits
servicehub-linkhub/src/main/java/com/shirongbao/linkhub/mapper/ShortLinkMapper.java - Redirect API
servicehub-linkhub/src/main/java/com/shirongbao/linkhub/controller/RedirectController.java
Personal Site
- Public Site API
servicehub-hirongbaohub/src/main/java/com/shirongbao/hirongbaohub/controller/HirongbaoHubController.java - Posts and Activity
servicehub-hirongbaohub/src/main/java/com/shirongbao/hirongbaohub/service/SitePostService.java - Profile and Social
servicehub-hirongbaohub/src/main/java/com/shirongbao/hirongbaohub/service/SiteProfileService.java - Comments
servicehub-hirongbaohub/src/main/java/com/shirongbao/hirongbaohub/service/SiteCommentService.java - Site Content Data
servicehub-hirongbaohub/src/main/java/com/shirongbao/hirongbaohub/mapper/SitePostMapper.java - Email Notices
servicehub-noticehub/src/main/java/com/shirongbao/noticehub/service/NoticeService.java
Other components
- Administrator
- API Client
- Site Visitor
- Tencent COS
- SMTP Service
Connections 33
- Administrator → Admin Auth API: signs in
- Administrator → Token API: manages tokens
- Administrator → Usage API: reviews usage
- Administrator → Overview API: views overview
- Administrator → Access Logs: inspects traffic
- Admin Auth API → Token Service: authenticates
- Token API → Token Service: manages
- Usage API → Token Service: queries usage
- Overview API → Token Service: reads counts
- Token Service → Token and Usage Data: reads and writes
- Access Logs → Access Log Data: queries logs
- API Client → File Endpoints: uploads files
- File Endpoints → Token Service: validates token
- File Endpoints → File Records: uploads or deletes
- File Records → File Metadata: reads and writes
- File Records → COS Storage: stores objects
- COS Storage → Tencent COS: uploads and deletes
- API Client → Public Link API: creates links
- Public Link API → Token Service: validates and logs
- Public Link API → Short Link Logic: creates or queries
- Short Link Logic → Links and Visits: reads and writes
- Site Visitor → Public Site API: requests content
- Public Site API → Posts and Activity: queries posts
- Public Site API → Profile and Social: queries profile
- Public Site API → Comments: handles comments
- Posts and Activity → Site Content Data: reads and writes
- Profile and Social → Site Content Data: reads profile data
- Comments → Site Content Data: reads and writes
- Comments → Email Notices: sends notification
- Email Notices → SMTP Service: sends email
- Site Visitor → Redirect API: follows short link
- Redirect API → Short Link Logic: resolves code
- Short Link Logic → Links and Visits: records visits