stripstream/project-intelligence/business-tech-bridge.md

Business-Tech Bridge

Purpose: Map business concepts to technical implementation. Last Updated: 2026-02-27

Quick Reference

• Update When: New features that bridge business and tech
• Audience: Developers, product

---

Business → Technical Mapping

Business Concept	Technical Implementation
Read comics	BookService.getBook(), PhotoswipeReader component
Sync progress	Komga API calls in ReadProgressService
Offline reading	Service Worker + IndexedDB via ClientOfflineBookService
User preferences	MongoDB + PreferencesService
Library management	LibraryService, SeriesService
Authentication	NextAuth v5 + AuthServerService

---

User Flows → API Routes

User Action	API Route	Service
View home	GET /api/komga/home	HomeService
Browse series	GET /api/komga/libraries/:id/series	SeriesService
Read book	GET /api/komga/books/:id	BookService
Update progress	POST /api/komga/books/:id/read-progress	BookService
Download book	GET /api/komga/images/books/:id/pages/:n	ImageService

---

Components → Services

UI Component	Service Layer
HomeContent	HomeService
SeriesGrid	SeriesService
BookCover	BookService
PhotoswipeReader	ImageService
FavoritesButton	FavoriteService
SettingsPanel	PreferencesService

---

Data Flow

User Request → API Route → Service → Komga API / MongoDB → Response
                ↓
            Logger (Pino)

---

Related Files

• technical-domain.md - Tech stack and code patterns
• business-domain.md - Business context
• decisions-log.md - Architecture decisions