Roman Martyrology API

A companion API to the Liturgical Calendar API, serving the eulogies (elogia) of the Roman Martyrology for any given liturgical day — a project of the Catholic Digital Commons Foundation, curated by a CDCF Project Committee. (The canonicalized identifiers and data standards this API builds on — CRMEDR, CLBDR, CECDR, CICLSALDR — are curated separately by the Catholic Engineering Task Force.)

The copyright problem, and the architecture that solves it

Unlike the Liturgical Calendar API, which serves no copyrighted texts, a Martyrology API must serve eulogy texts — and the current texts are copyrighted (the Latin editio typica altera 2004 by the Dicastery for Divine Worship, the Italian edition by the CEI). This repository is therefore public and contains no copyrighted texts; the texts live in a private data repository (CatholicOS/martyrology-texts) that is attached only at deployment time.

What makes the split workable:

1. Canonical IDs are the contract. The API's data model is keyed by the public canonical IDs of the CRMEDR (mr:MMDD-slug). Everything except the text itself — placement, entry numbers, asterisks, countries, unnumbered-header status — is public registry data.
2. Public-domain editions as open sample data. Older editions of the Roman Martyrology are out of copyright — the 1914 editio typica (Latin), the 1749 Benedict XIV edition, and the old English translations. Digitized under the same data contract, they let anyone clone, run and develop the API with real data, and can even be served publicly as historical editions. Only the 2004-family texts require the private repository.
3. The frontend and curation tools stay public. A curation website (review of draft IDs, cross-edition comparison, proper-eulogy management) contains no texts at rest; it displays what the API serves to authenticated curators. Authentication can reuse the CDCF shared infrastructure (Zitadel / OpenFGA, see cdcf-infra).

See docs/architecture.md for the data contract, the deployment pattern for the private data, and the API surface sketch.

Status

Design phase. The data layer exists (CRMEDR registry public; texts extracted and keyed privately); the API surface and implementation stack are being defined. Contributions and discussion are welcome on the issues.

Licensing

The code in this repository is licensed under Apache-2.0. The eulogy texts of the 2004 editions are not part of this repository and are not redistributable; should an agreement with the rights holders be reached, texts could be served publicly without changing this architecture.