How mai-kun/tsundoku works
MediaTracker is a personal media-tracking application: users maintain a library of books, manga, films, shows, and games, update progress, and explore metadata, history, recommendations, and statistics. The principal flow is the UI issuing API requests to server features, which apply domain rules and persist library state; optional external providers enrich titles. The graph preserves major UI and server capabilities visible in the tree. Several UI-to-API routes and server endpoint dispatches were not shown, so those links are marked unverified rather than inferred.
Main entry points: Media Library and progress handlers · App.svelte App shell and views · api.ts API client · Program.cs HTTP host and registration
Components 20
User interface
- App shell and views
mediatracker-ui/src/app/App.svelte - Library and media cards
mediatracker-ui/src/widgets/media-card - Media detail
mediatracker-ui/src/views/MediaDetailView.svelte - Create, progress, settings
mediatracker-ui/src/features - API client
mediatracker-ui/src/shared/api/api.ts
API and features
- HTTP host and registration
MediaTracker.Server/Program.cs - HTTP endpoints
MediaTracker.Server/Common/Endpoints - Library and progress handlers
MediaTracker.Server/Features/Media - Seasons and history
MediaTracker.Server/Features/Seasons - External media features
MediaTracker.Server/Features/External - Statistics and recommendations
MediaTracker.Server/Features/Media/GetMediaStats/AdvancedStatsCalculator.cs - Settings and jobs
MediaTracker.Server/Features/Jobs
Media domain
- Media entities and rules
MediaTracker.Server/Domain/Entities - Result and error values
MediaTracker.Server/Domain/Common/Result.cs
External integrations
- Metadata aggregation
MediaTracker.Server/Infrastructure/ExternalApis/MetadataAggregatorService.cs - Metadata providers
MediaTracker.Server/Infrastructure/ExternalApis
Persistence and services
- Application database
MediaTracker.Server/Infrastructure/Persistence/AppDbContext.cs - Cover image storage
MediaTracker.Server/Infrastructure/Storage/ImageStorageService.cs - Background job manager
MediaTracker.Server/Infrastructure/Jobs/JobManager.cs
Other components
- Media tracker user
Connections 23
- Media tracker user → App shell and views: uses
- App shell and views → Library and media cards: renders
- App shell and views → Media detail: opens
- App shell and views → Create, progress, settings: hosts
- Library and media cards → API client: requests data
- Media detail → API client: requests details
- Create, progress, settings → API client: sends updates
- API client → HTTP endpoints: calls
- HTTP host and registration → HTTP endpoints: imports endpoints
MediaTracker.Server/Program.cs - HTTP endpoints → Library and progress handlers: dispatches
- Library and progress handlers → Application database: queries and saves
MediaTracker.Server/Features/Media/GetMediaList/MediaListQuery.cs - Library and progress handlers → Media entities and rules: updates
MediaTracker.Server/Features/Media/GetMediaList/MediaListQuery.cs - Seasons and history → Application database: updates seasons
MediaTracker.Server/Features/Seasons/UpdateSeasonProgress/UpdateSeasonProgressHandler.cs - Seasons and history → Statistics and recommendations: uses calculator
MediaTracker.Server/Features/Seasons/UpdateSeasonProgress/UpdateSeasonProgressHandler.cs - Library and progress handlers → Statistics and recommendations: computes statistics
MediaTracker.Server/Features/Media/GetMediaStats/AdvancedStatsCalculator.cs - External media features → Metadata aggregation: searches metadata
MediaTracker.Server/Features/External/SearchExternal/SearchExternalHandler.cs - Metadata aggregation → Metadata providers: resolves providers
MediaTracker.Server/Infrastructure/ExternalApis/MetadataAggregatorService.cs - External media features → Metadata providers: loads relations
MediaTracker.Server/Features/External/GetExternalRelations/GetExternalRelationsHandler.cs - Library and progress handlers → Cover image storage: stores covers
- Settings and jobs → Background job manager: manages jobs
MediaTracker.Server/Infrastructure/Jobs/JobManager.cs - HTTP host and registration → Application database: configures services
MediaTracker.Server/Program.cs - HTTP host and registration → Background job manager: registers services
- Library and progress handlers → Result and error values: returns outcomes
MediaTracker.Server/Features/Media/GetRecommendations/GetRecommendationsHandler.cs