Skip to content

Commit

Permalink
Adding some details
Browse files Browse the repository at this point in the history
  • Loading branch information
villanueval committed Feb 12, 2024
1 parent fdc28c6 commit 5c13ed0
Showing 1 changed file with 26 additions and 3 deletions.
29 changes: 26 additions & 3 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -19,15 +19,26 @@ This repo hosts the code for the dashboard, which presents the progress in each

![Main dashboard](https://user-images.githubusercontent.com/2302171/200641626-1f560bac-6245-447d-9a1f-b72249a47ca9.png)


![Example Project](https://user-images.githubusercontent.com/2302171/200641552-ac89022c-e79e-421d-9ac9-c120cbdb20a5.png)

## File Checks

The [Osprey Worker](https://github.com/Smithsonian/Osprey_Worker/) runs in Linux and updates the dashboard via an API (see below). The Worker can be configured to run one or more of these checks:

* unique_file - Unique file name in the project
* raw_pair - There is a raw file paired in a subfolder (*e.g.* tifs and raws (.eip/.iiq) subfolders)
* jhove - The file is a valid image according to [JHOVE](https://jhove.openpreservation.org/)
* tifpages - The tif files don't contain an embedded thumbnail, or more than one image per file
* magick - The file is a valid image according to [Imagemagick](https://imagemagick.org/)
* tif_compression - The tif file is compressed using LZW to save disk space

Other file checks can be added. Documentation to be added.

## Setup

The app currently expects a Postgres database. Install and populate the database according to the instructions in [database/tables.sql](https://github.com/Smithsonian/Osprey_Misc/tree/main/database).
The app runs in Python using the Flask module and requires a MySQL database. Install and populate the database according to the instructions in [database/tables.sql](https://github.com/Smithsonian/Osprey_Misc/tree/main/database).

To install the required environment and modules to the default location:
To install the required environment and modules to the default location (`/var/www/app`):

```bash
mkdir /var/www/app
Expand Down Expand Up @@ -61,6 +72,18 @@ sudo chown -R apache:apache /var/www/app

Setup apache2/httpd as described in the [web_server](web_server) folder

## API

The application includes an API with these routes:

* `/api/`: Print available routes in JSON
* `/api/files/<file_id>`: Get the details of a file by its `file_id`
* `/api/folders/<folder_id>`: Get the details of a folder and the list of files
* `/api/folders/qc/<folder_id>`: Get the details of a folder and the list of files from QC
* `/api/projects/`: Get the list of projects in the system
* `/api/projects/<project_alias>`: Get the details of a project by specifying the project_alias
* `/api/reports/<report_id>/`: Get the data from a project report

## Components

The system has two related repos:
Expand Down

0 comments on commit 5c13ed0

Please sign in to comment.