Puter

A shopping website for computer parts. Built with the Django Framework.

REQUIRED TOOLS:

1. Installation of Python 3.7.2 or later. (should include sqlite3 and pip)
   
2. Installation of Pip (likely installed with Python, if pip -V returns error run standalone installer)
   
3. Installation of Pipenv (run pip install pipenv)
   
4. Run pipenv shell before any pipenv install (else you won't install to the virtual environment)
   
5. Installation of Django 2.1.5 or later. (run pipenv install django)
   
6. Installation of PostgreSQL 11.2 or later. (use the enterpriseDB installer, will save a lot of setup headaches)
   
7. Installation of pgAdmin4 (recommended and included in enterpriseDB installer)
   
8. Installation of psycopg2 package (run pipenv install psycopg2)
   
9. Installation of Python library for Argon2 (run pipenv install django[argon2])
   
10. Installation of Stripe API (run pipenv install stripe)
    
11. Installation of Pillow (run pipenv install pillow)
    

DEVELOPMENT SETUP:

1. Clone the repository to the computer. (need to install pipenv in repository directory)
   
2. Installation of all above tools (recommended to follow above order)
   
3. pipenv shell to initialize virtual environment within project folder. Removes need to type python in front of manage.py and helps ensure no conflicts between python versions (if multiple installed).
   
4. pgAdmin4 to check contents of database from GUI
   
5. Make sure that all commands are run after initializing virtual environment with pipenv shell or will throw issues when you runserver.
   
6. After installing PostgreSQL, run pgAdmin4 and login (password setup during install). Create new superuser datadmin for development purposes (preset authentication with this user in settings.py). IF YOU DO NOT DO THIS, THERE WILL BE CONSEQUENCES!
   
7. Create new database pUsers and give datadmin priviliges to use it if not already.
   
8. Setup development server by running python manage.py makemigrations and python manage.py migrate
   
9. Test app view by running python manage.py runserver
   
10. Update development server by running python manage.py make migrations and python manage.py migrate