Skip to content

Parthenope University Project Exam: Web Tecnologies

License

Notifications You must be signed in to change notification settings

Luruu/NotMiss

 
 

Repository files navigation

NotMiss

~What is NotMiss?

NotMiss is a PWA(Progressive Web App) conceived by Renato Esposito and Luca Rubino.
It is a project of Web Technologies(TW6) (course of the Parthenope University of Naples).



Idea

  • The idea is to create a platform that allows the management and organization of user events.

features implemented

The NotMiss PWA offers the possibily:

  • to create events with customizations.

  • to make the events private in a bulletin board visible to all NotMiss users.

  • to make the events public in a bulletin board visible to all.

PWA home page in desktop frame and in smartphone frame

notmiss.mp4

Guide

~How to set up NotMiss?

  1. Create virtual environment folder(by terminal): $ python3 -m venv venv
  2. activate the corresponding environment: $ . venv/bin/activate
  3. Go to project folder and install requirements by requirements.txt file: $ pip install -r requirements.txt
  4. Make sure the python interpreter is configured correctly.
  5. If you don't have mongoDB, follow this guide to install it.
  6. (linux only) you can start mongoDB with the command: $ sudo systemctl start mongod
    If that doesn't work, run the following commands:
    1. $ sudo chown mongodb:mongodb /tmp/mongodb-27017.sock
    2. $ sudo systemctl restart mongod

~How to run NotMiss?

  1. run mongoDB(the instructions depend on your OS).
  2. In the project folder there is the "NotMissDB" folder. if you want to have a ready NotMissDB, then execute the procedure "how to import the testing db?"
  3. N.B: The flask command is installed by Flask, not your application; it must be told where to find your application in order to use it. The FLASK_APP environment variable is used to specify how to load the application so export your FLASK_APP environment variable: $ export FLASK_APP=app
  4. Run flask: $ flask run (you can use command $ flask run -h 0.0.0.0 to make NotMiss accessible to everyone).
  5. If you want and if you already want a populated database, you can follow the procedure "how to import the testing DB".

~How to import the testing DB? (Linux only)

  1. If your operating system is not linux, search on google "how to import a db in mongodb in X" (X = your OS)
  2. Else: run the command: $ sudo mongorestore -d NotMissDB < NotmissDB_path >
  3. Now you can test NotMiss with sample data.
  4. (If you need to export NotMissDB (for some reason): $ sudo mongodump --host localhost --port 27017 --db NotMissDB)

~How to use NotMiss?

  1. $ flask run and $ flask run -h 0.0.0.0 commands return the IP address and port to connect to access the PWA.
  2. From the main interface you can access the login / registration page.
  3. Once you have registered and logged in, you will be redirected to the main page where you can create your own events, attend other users' events and view event information.


Google Drive link of the project presentation [Italian versions]:

Releases

No releases published

Packages

No packages published

Languages

  • HTML 44.0%
  • JavaScript 33.2%
  • CSS 12.5%
  • Python 10.3%