Skip to content

Latest commit

 

History

History
145 lines (131 loc) · 6.69 KB

README.md

File metadata and controls

145 lines (131 loc) · 6.69 KB

Abra Cadabra - A Questions and Answers Web App

Table of contents

About the Project

This project is in collaboration with Fontys and Phillips. It's a school project, about making an "ethical" web application, with a question and answers in different subjects. When an user has a question, they can visit our website, create an account and ask their question. Alternatively, they could use the tools we provided to search and filter the questions already asked, in order to find an answer to their question, if it was laready asked.

Additionally, users can become experts on a subject, if they provide credentials to prove their knowledge. Administrators, manage the approval process through an admin panel, where they can also review flagged questions and answers to determine if they are inappropriate and should be deleted, manage users, subjects and get graphical representation based on statistics of what's popular around the website.

Features

Landingpage

Landing page

List of all subjects

Subject list example

Subject page

Subject page

Filter questions in a subject

Filters example

Accounts

Accounts example

Apply for expert

Apply for expert example

Answer a question as an expert

Answer question expert example

Answer a question as a user

Answer question example

Ask questions in different subjects

Ask question example

Reporting

Reporting example

Tags

Tags example Tags on question

Up and down voting

Voting example

Admin dashboard

Admin dashboard page

Admin ban a user

Banning example

Admin verify expert requests

Expert request example

Admin check out reports

Reports example

Admin manage subjects

Subject management example

How to run it Locally

  1. Clone this git repository

  2. Create a aspnet cert in the cert folder

cd Abracadabra
cd certs
dotnet dev-certs https -ep aspnetapp.pfx -p password
  1. Run the docker compose file
cd ..
docker-compose build
docker-compose -f docker-compose.yml up -d
  1. When the docker-compose is up.

Admin dashboard: http://localhost:3001 Website: http://localhost:3000 API URL: https://localhost:5000

Dev / test accounts

Admin

Email: [email protected] Password: Password@1

Expert

Email: [email protected] Password: Password@2

Users

Email: [email protected] Password: Password@0

Session

If you restart the back-end you should delete your browers local storage since the back-end uses a in memory database for Dev purposes.

Development

This section is about how to set up the project locally to be ready for development

Prerequisites

  • An IDE (Recommended Visual Studio and Visual Studio Code)

Set Up for developement

  1. Clone the repository
git clone https://github.com/philips-labs/fontys-2020-team-abra-cadabra
  1. Install dependencies for the Web App and run it
cd Abracadabra/abracadabra_web_app
npm install
npm run dev
  1. Install dependencies for the Admin Panel and run it
cd Abracadabra/abracadabra_admin_panel
npm install
npm run dev
  1. Run the API
cd Abracadabra/AbracadabraAPI/AbracadabraAPI
dotnet run
  1. Create a file named .env.local with the following content (replace "http://localhost:5000" with the address your api is running on)
# API
NEXT_PUBLIC_API_URL=http://localhost:5000

look at the localhost port presented during the start-up to find the API url