Skip to content
cnr-isti-vclabPublic

About

No description, website, or topics provided.

Resources

Stars

8 stars

Watchers

1 watching

Forks

Latest commit

 

History

934 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

OCRA

Backend Tests Annotation Schema Checks

OCRA (Online Conservation-Restoration Annotator) is a collaborative full-stack platform for the structured documentation, analysis, and semantic enrichment of two- and three-dimensional representations of tangible cultural heritage assets. It supports 3D mesh representations, 2D images, and relightable/RTI models.

OCRA is developed by the Visual Computing Lab, ISTI-CNR as a Vertical Application of the ECHOES project and is designed to interoperate with the European Collaborative Cloud for Cultural Heritage (ECCCH). It combines collaborative annotation, semantic enrichment, and publication of Heritage Digital Twin data to ECCCH.

Release Status

OCRA is under active development. The current codebase is a pre-release research platform: its architecture, workflows, APIs, and data models may evolve as development and validation activities within ECHOES continue.

Project Repositories and Website

Stable OCRA releases, tags, documentation, and release notes are intended to be made visible through the ECHOES GitHub organization in accordance with the ECHOES Git Repository Management Policy.

Architecture

  • Frontend: React + TypeScript (Vite), Bootstrap UI — dev server on :3001.
  • Backend: Node.js + Express; Prisma + PostgreSQL for application data (users, sessions, projects) — API on :3002.
  • Audit store: MongoDB 7.0 (audit events including login/logout/file uploads stored in Mongo collection). Backend uses Prisma only to enrich audit documents with user info (read-only).
  • Authentication: OpenID Connect Authorization Code + PKCE through EGI Check-in.

Quick Start

  1. Clone and enter the repository:

    git clone https://github.com/cnr-isti-vclab/OCRA.git
    cd OCRA
  2. Create the ignored local EGI configuration and set the client secret issued by the Federation Registry:

    cp .env.egi-demo.example .env.egi-demo
  3. Start services with Docker Compose:

    docker compose --env-file .env.egi-demo up --build -d app
  4. Open the application:

    • Frontend: http://localhost:3001
    • Backend API: http://localhost:3002

Notes:

  • Audit logs (login/logout/file uploads) are stored in MongoDB; all authenticated users can view audit events (filtered by permissions).
  • If you change the Prisma schema, run npx prisma generate in backend/ to regenerate the client.
  • For local development without Docker, use the frontend and backend package.json scripts directly.
  • For production deployment, see DEPLOYMENT_GUIDE.md.

Getty AAT vocabulary

The Vocabularies page includes an experimental Getty Art & Architecture Thesaurus explorer backed by OCRA's provider-neutral vocabulary API. Search is debounced and cached; selected concepts are identified by their canonical Getty URI. This area does not yet modify annotations, and the existing local TTL spike is retained. See Getty AAT external vocabulary.

Documentation

Related Source Code

Maintainers

License

OCRA is released under the MIT License.

Funding Acknowledgement

This work has been developed in the context of the ECHOES project — European Cloud for Heritage OpEn Science, funded by the European Union under Grant Agreement No. 101157364, with the support of UK Research and Innovation (UKRI) under the UK Government’s Horizon Europe funding guarantee No. 10110142 and No. 10110466.

Views and opinions expressed are those of the author(s) only and do not necessarily reflect those of the European Union or the granting authority. Neither the European Union nor the granting authority can be held responsible for them.

About

No description, website, or topics provided.

Resources

Stars

8 stars

Watchers

1 watching

Forks

Releases

Packages

Contributors

Languages