Bernardo Magri f4aebf1150 Add tagging feature with BookDetails view		пре 1 месец
..
Feature-Tagging.md	f4aebf1150 Add tagging feature with BookDetails view	пре 1 месец
README.md	8e553142f6 adding documentation	пре 2 месеци
bibliotheca_window.md	8e553142f6 adding documentation	пре 2 месеци
bookimport.md	8e553142f6 adding documentation	пре 2 месеци
booklist.md	8e553142f6 adding documentation	пре 2 месеци
bookshelf.md	8e553142f6 adding documentation	пре 2 месеци
booktile.md	8e553142f6 adding documentation	пре 2 месеци
database_manager.md	8e553142f6 adding documentation	пре 2 месеци
feature_requests.md	961a70d4b7 adding feature request	пре 2 месеци
main.md	8e553142f6 adding documentation	пре 2 месеци
sha256.md	8e553142f6 adding documentation	пре 2 месеци

Bibliotheca Architecture Overview

GTK 4 / gtkmm: UI toolkit for widgets, signals, and layout.
SQLite3: persistence layer for book metadata.
poppler-glib: PDF metadata/covers.
libzip + tinyxml2: EPUB metadata extraction.
OpenSSL (libcrypto): SHA-256 hashing.

This document links together the module overviews and describes how a book flows through the system.

High-level flow

Import (BookImport, Sha256)
- Compute SHA-256 id for each selected file.
- Extract metadata and cover (EPUB via libzip/tinyxml2, PDF via poppler).
Persistence (DatabaseManager)
- Ensure the SQLite schema exists.
- Insert/update/remove records using prepared statements.
Model (BookList)
- Load books from the database into memory.
- Expose CRUD helpers with signal emission.
- Provide thread-safe enqueue helpers for background imports.
Presentation (BookShelf, BookTile)
- Mirror the model into a Gio::ListStore.
- Render a grid of tiles, expose activation, and filter results.
Application shell (BibliothecaWindow)
- Build the UI chrome (header, search bar, stack pages).
- React to imports, search queries, and user activation.