49 lines
2.1 KiB
Markdown
49 lines
2.1 KiB
Markdown
# 📖 Nexus Reader
|
|
|
|
Nexus Reader is a state-of-the-art, cross-platform Blazor .NET 10 immersive e-book reader, powered by **Native AOT**, **Clean Architecture**, **CQRS**, and interactive **D3.js Relationship Graphs** built on vector-based AI semantics.
|
|
|
|
---
|
|
|
|
## ✨ Features & Architecture Highlights
|
|
|
|
### 📁 Ingestion & Description persistence
|
|
- Extracted and persistent **book descriptions** from EPUB package metadata during book ingestion.
|
|
- The `Description` field propagates cleanly from the `Ebook` entity through Mapster to `LastReadBookDto` and `UserProfileDto`.
|
|
|
|
### 🔗 Deep-Link Routing
|
|
- Implemented deep-link route activation: `/reader/{bookId}?chapter=N`.
|
|
- Allows instant resume of reading session coordinates and loads the specific chapter chapter directly via URL query parameters.
|
|
|
|
### 🛡️ Downstream AI Resilience
|
|
- Standard resilience engine in `DependencyInjection.cs` utilizing the **Polly** package (`ai-retry`).
|
|
- Automatically intercepts, handles, and retries on both rate-limits (`429 Too Many Requests`) and downstream capacity overloads (`503 ServiceUnavailable` / `high demand`).
|
|
|
|
### ⚙️ Concurrent Request Deduplication
|
|
- Multi-client InteractiveAuto Blazor circuit synchronization is backed by a thread-safe active task registry in `KnowledgeService` which ensures that identical concurrent requests await a single shared task instance, eliminating redundant LLM queries.
|
|
|
|
---
|
|
|
|
## 🛠️ Build & Verification Gate
|
|
|
|
Ensure the dotnet workload matches the active SDK, and compile the full solution utilizing:
|
|
|
|
```bash
|
|
dotnet build NexusReader.slnx --no-restore
|
|
```
|
|
|
|
Run test suite:
|
|
|
|
```bash
|
|
dotnet test --no-restore
|
|
```
|
|
|
|
## 🗄️ Database Migrations
|
|
|
|
Automatic database migrations at startup (`MigrateAsync()`) have been disabled to ensure compatibility with Native AOT compilation and prevent locking issues in multi-instance environments.
|
|
|
|
To apply database migrations locally, run the EF Core migration command from the solution root:
|
|
|
|
```bash
|
|
dotnet ef database update --project src/NexusReader.Infrastructure --startup-project src/NexusReader.Web
|
|
```
|