Skip to content

Latest commit

 

History

History
57 lines (30 loc) · 2.14 KB

README.md

File metadata and controls

57 lines (30 loc) · 2.14 KB

aquila

An application to store, calculate, and assign PREMIS rights statements.

Getting Started

Install git and clone the repository

$ git clone https://github.com/RockefellerArchiveCenter/aquila.git

Install Docker and run docker-compose from the root directory

$ cd aquila
$ docker-compose up

A default user with username test and password testpassword is created on setup. Once the application starts successfully, you should be able to access the application in your browser at http://localhost:8009.

When you're done, shut down docker-compose

$ docker-compose down

Or, if you want to remove all data

$ docker-compose down -v

Default Superuser

When you start the container for the first time, a superuser will be created. Make sure you change the password for this user (the easiest way is through the Django shell). E.g.,

python manage.py changepassword <SUPERUSER_USERNAME>

Usage

Aquila includes a front-end interface to create rights statements and groupings, as well as an API to assemble rights statements.

Groupings are groups of content that have similar rights. They may correspond to record types, collections, or projects.

The rights statements contain date rules that are calculated by the Rights Assembler API. Many rights statements can be attached to many groupings.

API

Aquila contains a Rights Assembler API (available at api/rights-assemble/), which uses a start date, an end date, and IDs of rights statements to create rights JSON.

Requirements

Using this repo requires having Docker installed.

Development

This repository contains a configuration file for git pre-commit hooks which help ensure that code is linted before it is checked into version control. It is strongly recommended that you install these hooks locally by installing pre-commit and running pre-commit install.

License

Code is released under an MIT License, as all your code should be. See LICENSE for details.