Skip to content

Odzen/university-grades

Repository files navigation

University Grade Management System API

Table of Contents

Introduction

This project is a backend system for managing university grades using Django Rest Framework. The API supports both student, professor roles and administrator roles with features for course registration, grade tracking, and performance monitoring.

Database Schema

db_diagram

Features

List the main features of your project:

  • JWT Authentication: Secure access using token-based authentication, with support for user registration and login, role-based permissions and access/refresh tokens.
  • Student and Professor Management: Professors can manage courses, assign grades and enroll students to courses they manage. Admins can manage all users, subjects, and courses.
  • Comprehensive API Documentation: Clear descriptions of database structure, endpoints, and usage examples to simplify integration and testing.

Installation

Provide step-by-step instructions on how to set up the project locally.

  1. Clone the repository:
    git clone [email protected]:Odzen/university-grades.git
  2. Navigate to the project directory:
    cd unversity-grades
  3. Create a virtual environment:
    python3 -m venv env
  4. Activate the virtual environment:
    source env/bin/activate
  5. Install the dependencies:
    pip install -r requirements.txt
  6. Make and apply the migrations:
    python manage.py makemigrations
    python manage.py migrate
  7. Run the development server:
    python manage.py runserver

Usage

If you use the production server and want to try the API, sign in with the following credentials (/auth/login/):

Documentation

The API documentation is available at /docs/ at the root of the project. https://university-grades-460c6e848672.herokuapp.com/docs/

Contact