Moving Forward is a website to allow users to donate, buy locally produced or sourced items with the the profits from these purchases being re-invested into the local commumities and charity groups in the Cape Town area of the Western Province.

• As a First Time Visitor, I want to easily find a items I want to buy.
• As a First Time Visitor, I want to be able to easily navigate throughout the site to find content.
• As a First Time Visitor, I want to be able to easily to set up an account.

• As a Returning Visitor, I would like to review previous purchases in my profile.
• As a Returning Visitor, I would like to continue to support the causes with donations.
• As a Returning Visitor, I would like to see items and offers.

• As a user I want to be able to purchase items that I like.
• As a user I want to be able to shop with confidence and pay with my card directly not through a third party site.

• As a user I want to be able to add products easily.
• As a user I want to ensure an authenticated user can access all required information correctly.
• As a user I want to include options for the admin to quickly edit the site.

• As a user I want to ensure the user can't break the flow of the site with correct defensive design choices.
• As a user I want to ensure an authenticated user can access all required information correctly.
• As a user I want to include options for the admin to quickly edit the site.

I wanted to select a minimal range of colours not to overwhelm but to compliment the selected background image selecting #ADD8E6 produced the desired effect without compromising the website.

The Lato font was selected for its clean and business like style for the website.

A range of locallly sourced goods and donations that the profit from goes to these groups, purchasing is a seamless process within the website.

Clients that register, their details are recorded and can be updated and are used to prefill where required for new orders. Previous purchases are listed in their profile page.

• Clients to be able to add a profile picture.
• Add additional information such as hobbies and skills, and when selected by the client this information would be available on a community skills bank page. To exchange social or commercial assisatnace to other memebers and to the groups supported by the website.
• To be able to contact the local groups and store these messages.
• Facetime or similiar app these groups.
• This greater interaction will allow those customers who have skills or time to offer additional help to these groups.

Develop greater links to the individual charities and local groups to the customer to create greater bonds.

• HTML
• CSS
• Javascript
• Python

• Django
• Bootstrap

• Jquery
• Stripe

• Amazon S3
• Heruko
• Github
• Postgres

• Problem : The home page option is missing from the drop-down menu in the tablet mode.

• Cause : The styling padding was causing the top of the list to be obscured.

• Resolution : The padding was adjusted.

• Problem : Fails to load.

• Cause : Removed surplus apps cause a process error.

• Resolution : Removing links/migrations to previous apps.

• Items can be increased beyond the 99 limit in the shopping bag, this would have to additional code before going live.
• When Donations are purchased and the total shopping bag is less then £50 a delivery is added, this too would require further coding before going live.
• When DEBUG is set to False media fails to load - media remains from cached from a previous True. Further investigation and coding is required to resolve this.

The site can be deployed locally using VsCode IDE, deployed on Heroku using Amazon W3 for the the hosting of static and media files. The site will automatically update with commits to the main branch, the code will contiue to run locally. A temporary issue has arised with automatic deployment from commits due a breach with heroku this is currently being investigated and be resolved.

• GitPod with VsCode - Local development tool
• Python Documentation is based on Python v3.8
• [PIP3] PIP package installer
• Stripe Payment infrastructure
• Amazon S3 Media Storage
• Heruko Cloud Platform

1. In the repository click on the "use this template" it will open in a new window with you being required to give the new repository a name. Select public or private and then the create button.
2. When the new repository has been created select Gitpod to open.
3. When this completes you will be required to import the requirememts using the following;

   pip3 install -r requirements.txt

5. Within the root dir called env.py, in this file add the following lines to set up the environmental variables.

   import os

   os.environ["SECRET_KEY"] = "[Your Secret Key]"

   os.environ["DEV"] = "1"

   os.environ["HOSTNAME"] = "0.0.0.0"

   os.environ["STRIPE_PUBLIC_KEY"] = "[Your Stripe Key]"

   os.environ["STRIPE_SECRET_KEY"] = "[Your Stripe Secret Key]"

   os.environ["DATABASE_URL"] = "[Your DB URL]"

1. To set up your database you will first need to run the following command.

   python3 manage.py migrate

3. To create a super user to allow you to access the admin panel run the following command in your terminal and complete the required information as prompted.

   python3 manage.py createsuperuser

4. From there you should now be able to run the server using the following command.

   python3 manage.py runserver

5. Next close the server in your terminal using ctrl+c (cmd+c on mac) and run the following commands to populate the database.

   python3 manage.py loaddata store/fixtures/categories.json

To run this application in an online environment you will need to deploy the code to Heroku. Before moving on to this section please ensure you have followed the instructions for local deployment and this has been successful

1. Either create an account at Heruko or log in to your account.
2. Set up a new app under a unique name.
3. In the resources section, in the addons field type the below command and select the free cost option.

4. in the settings tab select Reveal Config Vars and copy the pre populated DATABASE_URL into your settings.py file in your project.
5. in the Config Vars in Heroku you will need to populate with the following keys.

6. Now this has been configured you will now migrate the local database to the cloud database using the migrate command as below.

7. Next you will need to create a super user and populate the database as described in the database set up section.
8. From here, select the Github option and connect the repository from GitHub and select the branch (Master) to deploy from, the migrations and data has been loaded, in your Heroku dashboard select the Deploy tab.
9. It is advised to select automatic deployment to ensure for each push to Github the hosted version is up to date(Currently the manual process is being used as Heroku is experiencing security issues)*.
10. When this has deployed select open app from the top bar of the Heroku App.

Heroku Manual Process (the automatic had been set up before the issue)

IF YOU ARE CREATING A NEW DEPLOYMENT/APP

• Run the command heroku login -i and login when prompted. Then run the command heroku create your_app_name_here to create a new app, replacing your_app_name_here with the name you want to give your app. This will create a new Heroku app and link it to your Gitpod terminal. You can then access the app via the Heroku dashboard and set up your config vars.

IF YOU ALREADY HAVE AN APP CREATED WHICH USES AUTOMATIC DEPLOYS

• Run the command heroku login -i and login when prompted. Then run the following command: heroku git:remote -a your_app_name_here and replace your_app_name_here with the name of your Heroku app. This will link the app to your Gitpod terminal.
• Followed by git push heroku main

Images have been sourced from PEXEL or from the developer.

• Richard Wells for his continuing inspirational support, guidance and input.

All images & content used for this site are for educational purposes only, and have been sourced from pexel or the developers own library.