John O'Keefe
f42720ac64
PROJECT_GUIDELINES.md had drifted out of reality (podman-only rule while the stack runs docker; verifier scripts wired to Makefile targets nobody runs). Trashed it, its two verifier scripts, and the Makefile targets; the rules that still matched reality (docker runtime, schema in place until release, server binary only via Docker, services layer, integration-test pool rules) are absorbed into the new AGENTS.md. The library-visibility family-lens rule now has a real home: - AGENTS.md: the standing rule agents auto-discover (new media endpoints MUST thread the visible-library set; 403, never silently pass; history of the 2026-10-13 leak). - docs/developer/library-visibility.md: the full explanation (helpers, SQL pattern, per-item content gates, series per-library), linked from the developer docs index. Stale doc links updated (docs index, contributing, development).
96 lines
2.9 KiB
Markdown
96 lines
2.9 KiB
Markdown
# Developer Documentation
|
|
|
|
Welcome to the Bookhoard developer documentation. This section contains API references, protocol specifications, and technical documentation for integrating with Bookhoard.
|
|
|
|
## 📚 API Documentation
|
|
|
|
### Complete API Reference
|
|
|
|
- **[API Reference](api-reference.md)** - Complete REST API reference
|
|
- Authentication
|
|
- User management
|
|
- Libraries
|
|
- Media items
|
|
- Reading progress
|
|
- Notes & highlights
|
|
- Analytics
|
|
- Book matching
|
|
- OPDS
|
|
- Sync protocols (KOReader, Kobo)
|
|
- WebSocket
|
|
|
|
### Split Endpoint Documentation
|
|
|
|
Browse individual endpoint documentation with interactive API Explorer:
|
|
|
|
- **[API Documentation](api/api-reference.md)** - Split endpoint docs
|
|
- [Authentication](api/authentication/) - Register, login, tokens
|
|
- [Users](api/users/) - Profile management
|
|
- [Libraries](api/libraries/) - Library operations
|
|
- [Media Items](api/media-items/) - Book/ebook management
|
|
- [Progress](api/progress/) - Reading progress tracking
|
|
- [Notes](api/notes/) - User notes
|
|
- [Highlights](api/highlights/) - Book highlights
|
|
- [Ratings](api/ratings/) - Book ratings
|
|
- [Devices](api/devices/) - Device management
|
|
- [Analytics](api/analytics/) - Usage statistics
|
|
- [Book Matching](api/book-matching/) - Search and link books
|
|
- [Collections](api/collections/) - Collection management
|
|
- [OPDS](api/opds/) - Open Publication Distribution
|
|
- [Sync Protocols](api/sync/) - KOReader and Kobo sync
|
|
- [WebSocket](api/websocket/) - Real-time events
|
|
|
|
### Collections API
|
|
|
|
- **[Collections API](collections-api.md)** - Complete collections API reference
|
|
- Create and manage collections
|
|
- Auto-assign rules
|
|
- Test rules
|
|
- Bulk operations
|
|
- Device shelf mappings
|
|
|
|
## 🔌 Protocol Specifications
|
|
|
|
### Sync Protocols
|
|
|
|
- **[Kobo Sync Protocol](api/sync/kobo-protocol.md)** - Kobo device sync protocol
|
|
- Kobo markup sync
|
|
- Library fetch
|
|
- Authentication
|
|
|
|
- **[KOReader Sync Protocol](api/sync/koreader-protocol.md)** - KOReader sync protocol
|
|
- Progress sync
|
|
- Metadata fetch
|
|
- Conflict handling
|
|
|
|
### WebSocket Protocol
|
|
|
|
- **[WebSocket API](websocket-api.md)** - Real-time sync and events
|
|
- Connection flow
|
|
- Message format
|
|
- Event types
|
|
- Authentication
|
|
|
|
## 🛠 Implementation Guides
|
|
|
|
### Library Visibility
|
|
|
|
- **[Library Visibility](library-visibility.md)** - Per-user library
|
|
visibility: the family-lens rule. New media endpoints MUST thread the
|
|
visible-library set (helpers, SQL pattern, series per-library).
|
|
|
|
### Calibre Integration
|
|
|
|
- **[Calibre OPF Implementation](../development/calibre-opf-implementation.md)** - Technical implementation details
|
|
- Architecture and design
|
|
- Data structures and functions
|
|
- Database schema mapping
|
|
- Testing strategy
|
|
- Error handling
|
|
- Performance considerations
|
|
|
|
---
|
|
|
|
**Looking for user documentation?** See the [User Portal](../user/user-guide.md)
|
|
**Need to deploy?** See the [Operations Portal](../operations/operations.md)
|