ZekDaniels / AdaptationApp

Final Project for Selcuk University made by Django

Instructions

Project Setup

• Pull the repository

• Create a virtual environment

  • VS Code:

    • Terminal -> New Terminal

      cmd
      py -m venv venv
      venv\scripts\activate
      

  • PyCharm:
    • File -> Settings / Project: intibak / Python Interpreter
    • Click settings icon and select Add...
    • Click OK
    • Close existing terminals and open a new terminal
    • Check if the (venv) word exist at the start of the terminal line (to check if the venv running)

• Install the requirements of the project:

  • Open the terminal:

    pip install -r requirements.txt
    

• Create a duplicate of ".env.example" file with ".env" name in the root directory

• (Optional) You can change the SECRET_KEY (https://stackoverflow.com/a/53144229/14506165)

• Create a duplicate of "development.py.example" file with "development.py" name in the settings directory

• Add your database properties to core/settings/development.py

• Check the project if it is running correctly:

  • Open the terminal:

    python manage.py runserver
    

  • Stop the process and contact with @ZekDaniels if you deal with any problem

• Open the terminal:

  python manage.py makemigrations
  python manage.py migrate
  python manage.py loaddata university faculty science adaptation_class
  python manage.py createsuperuser
  python manage.py runserver
  

• If you encountered any problem during the instructions, please restart from top

• Contact with @ZekDaniels if the problem persists

Database Backup & Restore

• We will use PostgreSQL binaries, thus we need to add them to the system environments:
  • This PC > Properties > Advanced System Settings > Environment Variables:
    • Double-click to the "Path" variable inside the "User variables for ..."
    • Click the "New" button
    • Enter this path "C:\Program Files\PostgreSQL\13\bin" (the "13" depends on the version of the installed PostgreSQL in your system)
    • Close all the windows by clicking the OK buttons on them

Backup

• Let's say you have:

  • The name of the file to extract: backup_file_2022.sql
  • Database username: postgres
  • Source database name: intibak

• Open the terminal:

   pg_dump -h 127.0.0.1 -U postgres -T django_migrations intibak > backup_file_2022.sql
  

• Additionally, you can backup the database with clean parameter:

   pg_dump -h 127.0.0.1 -U postgres -c -T django_migrations intibak > backup_file_2022_clean.sql
  

• Enter your password

• You are done

Restore

WARNING: Be sure you have a full match backup file to the current models of the project!

• Let's say you have:

  • Backup filename: backup_file_2022.sql
  • Database username: postgres
  • Target database name: intibak

• Open the terminal:

   python manage.py makemigrations
   psql -h 127.0.0.1 -U postgres intibak < backup_file_2022.sql
   python manage.py migrate --fake
  

• Enter your password

• You are done

---