Library & Catalog Management Architecture
Modul Library bertanggung jawab atas manajemen siklus hidup katalog kitab (kategori, pengarang, kitab), pengunduhan berkas .sqlite per-kitab, integrasi ke dalam arsip majemuk (1-20.sqlite), pembaruan versi kitab (book updates), serta koordinasi navigasi katalog lintas platform macOS dan iOS.
1. Diagram Arsitektur Komponen
flowchart TD
MAC["LibraryVC (macOS)"] --> LVM["LibraryViewModel (@Observable)"]
IOS["iOSLibraryView (iOS)"] --> LVM
LVM ~~~ Core
subgraph Core ["Core Engine & Database"]
DM["LibraryDataManager (Mutex Protected)"]
BDM["BookDownloadManager (SingleFlight)"]
BAI["BookArchiveIntegrator (Actor)"]
end
LVM -->|"Query / Cache"| DM
LVM -->|"Download Book"| BDM
LVM -->|"Integrate Archive"| BAI
DM --> SQLite[("main.sqlite (Katalog)")]
BDM <-->|"Fetch zstd"| GitHub["GitHub Releases"]
classDef ui fill:#e040fb26,stroke:#c026d3,stroke-width:2px;
classDef vm fill:#3b82f626,stroke:#2563eb,stroke-width:2px;
classDef store fill:#22c55e26,stroke:#16a34a,stroke-width:2px;
classDef db fill:#f9731626,stroke:#ea580c,stroke-width:2px;
classDef event fill:#be185d26,stroke:#9d174d,stroke-width:2px,color:#9d174d;
class MAC,IOS ui;
class LVM vm;
class DM,BDM,BAI,GitHub store;
class SQLite db;
2. Struktur Sub-Dokumentasi
Modul Library disusun secara modular ke dalam beberapa sub-dokumen teknis:
- Data Models: Model katalog inti (
BooksData,CategoryData,Muallif), entitas pembaruan (BookUpdateModels), dan enum filter antarmuka pengguna. - Database & Core Persistence: Integrasi
LibraryDataManagerdenganDatabaseManagerdan arsitektur caching in-memory berbasisMutex. - Download & Archive Integration: Mekanisme
BookDownloadManager, deduplikasi HTTPSingleFlight, dan integrasi arsipBookArchiveIntegratorberbasis Actor. - FTS Indexing & Stemming: Proses pembuatan indeks FTS5, dekompresi Zstandard (zstd), normalisasi teks Arab, dan migrasi FTS.
- iOS Implementation: Implementasi SwiftUI (
iOSLibraryView), jembatan UIKit (LibraryViewControllerWrapper), mode toolbar, dan impor luring (offline import). - macOS Implementation: Implementasi AppKit (
LibraryVC), manajemen struktur hierarki multi-kolom (LibraryViewManager), dan batch diffing. - Protocols & Delegation: Kontrak
LibraryDelegate,LibraryViewDelegate, danSearchableLibrarySidebar. - ViewModel, State & Combine: Arsitektur
@Observable LibraryViewModel, pengelolaan state katalog, pagination, mode filter, dan observasi Combine/NotificationCenter.