- What are Integrated Library Systems (ILS)?
- Online demo version
- About this project
- Entity Relationship Diagram
- Technologies used
- Application set up
- Ideas for further project development
Integrated Library System is a software used for a library to track items owned, orders made and patrons who have borrowed. An ILS usually is constituted of a relational database and software to interact with database. Such system are usually separated into two parts: one for patrons and one for staff. Usually such systems offer online catalog (OPAC) with the help of patreons can search through library resources and place orders. It also allows staff to have control over item circulation and perform CRUD (Create, Retrieve, Update, Delete) operations on library database such as: new patreons registering, editing personal data of existing ones, adding new items to catalog and editing bibliographic descriptions of items existing in database.
Live demo version hosted on pythonanywhere.com is available over here.
Note: Hosted version is missing email notification.
For the purpose of the demostration two account were made:
Account with patreon's permission:
- e-mail: [email protected]
- password: alamakota
Account with worker's permissions:
- e-mail: [email protected]
- password: akotmaale
Use given login credentials to sign in to hosted web app.
The web-app described here was part of my bachelor thesis. The goal was to create an application similar to Integrated Library Systems like KOHA or EverGreen. I've decided to make it as web application with Django framework and name it "Online Library Catalog". The project is meant to be used both by patreons and workers. The features implemented are described in work context diagram below: Patreons and staff members have restricted access to some of parts of applications and features e.g.:
- patreons and guest users don't have access to websites for staff members;
- staff members cannot order items;
- personal website containing personal informations and orders status does not exist for staff members since workers cannot order and borrow items;
All relations to be included in database are illustrated with ERD below:
- HTML, CSS, SASS;
- JavaScript;
- Python and Django framework;
- PostgreSQL;
Application can be dockerized using Dockerfile and docker-compose.yml files prepared in repo.
Repo contains also gulpfile.js in order to use browsersync and SASS compiler as a part of Gulp.js.
Note: The following instructions were performed on Ubuntu OS.
Make sure that both Python and pip are installed on your local machine (at least 3.8 for Python and 20 for pip versions recommended).
Run:
pip3 install -r requirements.txt
to install all Python libraries needed for this project and then:
sudo apt install postgresql postgresql-contrib
to install PostgreSQL server.
Note: It's not necessary to use PostgreSQL. Django is compatible with most of RDBMSs on the market, so it's up to you which database server you are going to use. You can also use SQLite, which is default RDBMS and comes with Django framework. For more informations check documentation.
Update settings.py file according to you database and SMTP server choise. For database setup and SMTP setup visit Django documentation.
To apply create relations in database run:
python3 manage.py makemigrations
and then:
python3 manage.py migrate
You can fill database with illustrative data. The example_covers.zip contains exemplary covers for books, movies and sound recordings. Extract the .zip file to media catalog. Then run:
python3 manage.py shell
and then paste the following lines of code:
from examplary_data.database_filling import fill_database
fill_database()
to fill database with data prepared.
Along with that two accounts will be created. Both the same as those in online demo version section.
It's the easiest way to set this app for working.
If you have Docker with Docker Compose installed on your machine just simply run:
docker-compose up
in project directory.
To fill application with prepared examples run:
docker exec -it online-library-catalog /bin/bash
and then follow the same steps with data filling procedure described earlier.
Regardless of deployment choice, once set up is completed, application should be available at localhost:8000 in your browser.
- This application is missing some cyclic operations like sending emails to patreons with reminder about return dates. It can be done with Celery (Distributed Task Queue) and Flower(Celery monitoring tool);