Julien Froidefond
0c3a54c62c
Some checks failed
Deploy with Docker Compose / deploy (push) Failing after 2s
66 lines
1.9 KiB
Markdown
66 lines
1.9 KiB
Markdown
<!-- Context: project-intelligence/bridge | Priority: medium | Version: 1.0 | Updated: 2026-02-27 -->
|
|
|
|
# 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
|