/Asgard

This is a web application that allows you to be in the loop about everything happening in your neighbourhood. From contact information of different handyman to meeting announcements or even alerts.

Primary LanguageHTMLMIT LicenseMIT

Asgard

Built By Neal Waga

Description

This is a web application that allows users to sign-up or log-in then create their own profile in order create new neighbourhoods, join a neighbourhood, post something as well as add a business on a particular neighbourhood's page and search for a business in a particular neighbourhood. Users can communicate to other members in the hoods they join.

Users must log in with credible emails


User Stories

These are the behaviors/features that the application implements for use by a user. Users would like to:

  • Sign in with the application to start using.
  • Set up a profile about me and a general location and my neighbourhood name.
  • Find a list of different businesses in my neighbourhood.
  • Find contact information for the health department and police authorities near my neighbourhood.
  • Create posts that will be visible to everyone in my neighbourhood.
  • Change my neighbourhood when I decide to move out.
  • Only view details of a single neighbourhood.

Admin Abilities

These are the behaviours/features that the application implements for use by the admin. Admin should:

  • Sign in to the application
  • Add, Edit and Delete users, neighbourhoods, posts and businesses
  • Manage the application.

SetUp / Installation Requirements

Cloning

  • In your terminal:

    $ git clone https://github.com/nealwaga/Asgard $ cd Asgard


Installations

  • The following command installs all the application requirements:

    pip freeze -r requirements.txt


Running the Application

After extracting the files,

  1. Navigate to the project folder

cd name_of_folder

  1. Creating a virtual environment

virtualenv virtual

  1. Activating the virtual environment

source virtual/bin/activate

  1. Running the application

python3 manage.py runserver

  1. Running tests

python3 manage.py test.


Technologies Used

  • Python3
  • Django
  • Postgres
  • HTML5
  • CSS3
  • JavaScript
  • Bootstrap 3

Known Bugs

None.


MIT License © 2022 Neal Waga


Collaborate

For any collaborations, reach me on waganeal@gmail.com