2 Commits

Include renames

Author	SHA1	Message	Date
john-okeefe	f7001dac4b	docs: add Calibre metadata.opf implementation plan ... Add comprehensive implementation plan for Calibre metadata.opf sidecar file support in the media scanner. Key features: - Sidecar-first approach: Calibre metadata.opf takes precedence over embedded metadata - Complete database schema mapping (no schema changes required - all fields exist) - Dublin Core and Calibre-specific field support - Simplified implementation: modify existing extractMetadata() instead of wrapper pattern - Works for all library types and file types - Comprehensive testing strategy Implementation details: - ~150 lines of new code (2 new functions + 1 modification) - No call site changes required - Graceful degradation on malformed XML - Performance target: <5% scan time increase This plan reflects simplified approach based on user feedback to directly modify extractMetadata() rather than creating wrapper functions. Related: User guide and developer docs added in separate commits	2026-03-26 10:41:58 -04:00
john-okeefe	22fd28c7db	docs: add comprehensive Calibre integration documentation ... This commit adds complete documentation for the planned Calibre metadata.opf sidecar file support feature. ## New Documentation ### Implementation Planning - CALIBRE_OPF_IMPLEMENTATION.md: Detailed implementation plan with requirements, architecture, database mapping, and step-by-step implementation guide for adding Calibre metadata.opf support ### Technical Documentation - docs/development/calibre-opf-implementation.md: Technical implementation details including: - Scanner pipeline architecture with sidecar-first approach - Data structures (CalibreOPFMetadata, MediaMetadata) - Function signatures and logic for parseCalibreMetadataOPF() - Database schema mapping (no changes required) - Testing strategy (unit and integration tests) - Error handling and performance considerations - Code examples and benchmarking approach ### User Documentation - docs/user/calibre-integration.md: Comprehensive user guide covering: - What is Calibre and how Bookhoard integrates with it - Automatic metadata import from metadata.opf sidecar files - Supported metadata fields (Dublin Core + Calibre-specific) - Setup instructions for Calibre libraries - Workflow examples (fresh library, mixed library, updating metadata) - Troubleshooting common issues - Best practices for Calibre + Bookhoard workflow - FAQ and resources ## Updated Documentation - README.md: Added Calibre integration feature to media management section - docs/user/user-guide.md: Added link to Calibre integration guide - docs/developer/development.md: Added link to Calibre implementation guide ## Feature Summary The Calibre integration feature will allow Bookhoard to automatically import curated metadata from Calibre's metadata.opf sidecar files, including titles, authors, series, tags, descriptions, publishers, identifiers (ISBN/ASIN), and contributors. Uses sidecar-first approach: metadata.opf → embedded metadata → folder structure → filename. All database fields already exist; no schema changes required.	2026-03-26 10:34:15 -04:00