API v2 is the backend for the Publica.la mobile reading apps (Fenice). It powers authentication, library browsing, content download, reader settings, search, and tenant discovery.

The Content Import system is a browser-based bulk import dashboard that allows tenants to upload spreadsheets (with metadata) and content files (PDF, EPUB, audio) to create products in Farfalla. Users upload files directly to S3 via presigned URLs, provide a metadata spreadsheet that maps each row to a content file, and the system validates, batches, and sends everything to Farfalla's /api/v3/content/bulk endpoint.

Medusa has two content intake systems that share the ContentIntake model as their entry point. Each ContentIntake record has a type enum — either onix or import — which determines which processing pipeline handles its data. Both systems ultimately send content to Farfalla for ingestion.

This section contains documentation for all our engineering projects. Each project has its own dedicated documentation space with technical specifications, implementation details, and operational guidelines.

Introduction

Repository: gitlab.com/publicala/castoro

Repository: gitlab.com/publicala/coniglio

Delfino is a TypeScript RPC bridge library that enables type-safe bidirectional communication between Volpe (an iframe-based reader) and its host applications (Farfalla and Fenice). The library encapsulates all Comlink complexity, providing simple, typed APIs for both sides of the communication.

Repository: gitlab.com/publicala/farfalla

Repository: gitlab.com/publicala/fenice/dev/monorepo

Repository: gitlab.com/publicala/medusa

Repositories: micelio - felini

Repository: gitlab.com/publicala/volpe