How aditisingh-05/historia-backend works
Historia is a Spring Boot backend API for a multi-app story-reading product. The principal reader journey is account authentication, app-scoped catalogue access, entitlement checks, and reading; the backend also supports content authoring/import, purchases, ratings, annotations, support, and administration. The graph emphasizes documented capabilities and sampled service relationships. Some controller wiring and several feature implementations were not sampled, so uncertain links are omitted rather than inferred.
Main entry points: AuthService.java Reader Auth · ContentWorkflowService.java Content Workflow · BillingService.java Purchase Verification · AuthController.java Auth API
Components 29
Identity & Platform
- Auth API
src/main/java/com/bitverse/historia/auth/api/AuthController.java - Reader Auth
src/main/java/com/bitverse/historia/auth/application/AuthService.java - OTP Service
src/main/java/com/bitverse/historia/auth/application/OtpService.java - Refresh Sessions
src/main/java/com/bitverse/historia/auth/application/RefreshTokenService.java - JWT Tokens
src/main/java/com/bitverse/historia/auth/security/TokenService.java - User Accounts
src/main/java/com/bitverse/historia/auth/persistence/UserEntity.java - App Identity & Config
src/main/java/com/bitverse/historia/appconfig/api/AppRequestContext.java
Story Content
- Public Catalogue
src/main/java/com/bitverse/historia/content/application/CatalogueService.java - Content Workflow
src/main/java/com/bitverse/historia/content/application/ContentWorkflowService.java - Story Metadata
src/main/java/com/bitverse/historia/content/persistence/StoryRepository.java - Chapter Metadata
src/main/java/com/bitverse/historia/content/persistence/ChapterRepository.java - Story & Chapter Documents
src/main/java/com/bitverse/historia/content/persistence/mongo - Story Import
src/main/java/com/bitverse/historia/content/importing/application/StoryImportService.java
Access & Billing
- Access Decisions
src/main/java/com/bitverse/historia/entitlement/application/AccessDecisionService.java - Entitlements
src/main/java/com/bitverse/historia/entitlement/persistence/EntitlementEntity.java - Purchase Verification
src/main/java/com/bitverse/historia/billing/application/BillingService.java - Purchases
src/main/java/com/bitverse/historia/billing/persistence/PurchaseEntity.java
Reader Features
- Reading & Annotations
src/main/java/com/bitverse/historia/reading/api/ReadingStateController.java - Ratings & Reviews
src/main/java/com/bitverse/historia/rating/application/RatingService.java - Ratings
src/main/java/com/bitverse/historia/rating/persistence/RatingEntity.java - Reader Support
src/main/java/com/bitverse/historia/support/application/SupportService.java - Offline Manifests
src/main/java/com/bitverse/historia/offline/api/OfflineManifestController.java
Administration
- Admin Authentication
src/main/java/com/bitverse/historia/admin/application/AdminAuthService.java - Admin APIs
src/main/java/com/bitverse/historia/admin/api/AdminOperationsController.java - Audit Logging
src/main/java/com/bitverse/historia/admin/audit/AuditService.java - Usage Events
src/main/java/com/bitverse/historia/analytics/api/EventController.java
Other components
- Reader
- Administrator
- Google Play
Connections 28
- Reader → Auth API: authenticates
README.md - Auth API → Reader Auth: handles auth
- Reader Auth → User Accounts: reads/writes
src/main/java/com/bitverse/historia/auth/application/AuthService.java - Reader Auth → OTP Service: verifies OTP
src/main/java/com/bitverse/historia/auth/application/AuthService.java - Reader Auth → Refresh Sessions: issues sessions
src/main/java/com/bitverse/historia/auth/application/AuthService.java - Reader Auth → JWT Tokens: creates tokens
src/main/java/com/bitverse/historia/auth/application/AuthService.java - Administrator → Admin APIs: operates
README.md - Admin APIs → Admin Authentication: authenticates
- Reader → Public Catalogue: browses stories
README.md - Public Catalogue → Story Metadata: reads stories
- Administrator → Content Workflow: manages stories
- Content Workflow → Story Metadata: writes metadata
src/main/java/com/bitverse/historia/content/application/ContentWorkflowService.java - Content Workflow → Chapter Metadata: writes metadata
src/main/java/com/bitverse/historia/content/application/ContentWorkflowService.java - Content Workflow → Story & Chapter Documents: stores content
src/main/java/com/bitverse/historia/content/application/ContentWorkflowService.java - Story Import → Content Workflow: delegates content
src/main/java/com/bitverse/historia/content/importing/application/StoryImportService.java - Reader → Access Decisions: requests access
- Access Decisions → Entitlements: checks grants
src/main/java/com/bitverse/historia/entitlement/application/AccessDecisionService.java - Reader → Purchase Verification: verifies purchase
- Purchase Verification → Purchases: records purchase
src/main/java/com/bitverse/historia/billing/application/BillingService.java - Purchase Verification → Google Play: verifies purchase
src/main/java/com/bitverse/historia/billing/application/BillingService.java - Purchase Verification → Entitlements: grants access
src/main/java/com/bitverse/historia/billing/application/BillingService.java - Reader → Reading & Annotations: tracks reading
- Reader → Ratings & Reviews: rates stories
- Ratings & Reviews → Ratings: reads/writes
src/main/java/com/bitverse/historia/rating/application/RatingService.java - Reader → Reader Support: requests support
- Reader → Usage Events: sends events
- Reader → Offline Manifests: requests manifest
- Administrator → Audit Logging: audited actions