Memory places (Web app)

A project aimed at preserving the memory of historical places around the world. The application allows users to collectively create a database of forgotten or undiscovered places so that their cultural heritage is preserved for future generations. The software provides an interactive platform that allows users to add, edit and share information about historical places. Through this shared platform, history enthusiasts, travelers or simply those seeking historical knowledge will together contribute to documenting and preserving cultural heritage.

Functionalities

• Place managamend(add, edit, delete);
• Login and register functionality;
• Map filtering;
• Logout functionality;
• Profile page;
• Google Maps Api connection;
• Navigation panel;
• Memory places marker functionality;
• Google Maps trail functionality;
• Adaptation for disabilities;
• Forum page;
• Admin dashboard(statistics, page control, changes history);
• Theme change;
• Language change;
• Contact support;
• Help section;

Installation

1. Download source code from this repo.
   
2. Open downloaded project in your desired IDE(in this case VSCode);
   

VSCode installation

1. Open terminal and launch command node(if you getting error make sure that you have installed node from webpage link).
   
2. After that enter in command cd .\Frontend and then type npm i to install all required dependecies.
   
3. After installation try to run npm start.
   
4. The frontend can be accessed by default from this url http://localhost:3000
   (If you have any issues at this moment try to run commands for Frontend from Useful Commands -> Fronted section)
   
5. Next create new command line instance for backend matters.
   
6. Make sure that you have installed Python atleast in version 3.10 for proper app functionality and also that you can use command pip
   
7. After that type following commands in Useful Commands -> Backend section.
   
8. After installation try to run python manage.py runserver.
   
9. The backend can be accessed by default from this url http://127.0.0.1:8000/
   

Useful commands

Frontend

PS C:\PATH_TO_YOUR_PROJECT\memory_places\Frontend> npm install -D tailwindcss

PS C:\PATH_TO_YOUR_PROJECT\memory_places\Frontend> npm i @vis.gl/react-google-maps (w CMD)

PS C:\PATH_TO_YOUR_PROJECT\memory_places\Frontend> npm i @googlemaps/jest-mocks

PS C:\PATH_TO_YOUR_PROJECT\memory_places\Frontend> npm install react-redux

PS C:\PATH_TO_YOUR_PROJECT\memory_places\Frontend> npm install @reduxjs/toolkit react-redux

PS C:\PATH_TO_YOUR_PROJECT\memory_places\Frontend> npm install --save react-geocode

PS C:\PATH_TO_YOUR_PROJECT\memory_places\Frontend> npm install jwt-decode

PS C:\PATH_TO_YOUR_PROJECT\memory_places\Frontend> npm install @react-oauth/google@latest

PS C:\PATH_TO_YOUR_PROJECT\memory_places\Frontend> npm i --save @greatsumini/react-facebook-login

PS C:\PATH_TO_YOUR_PROJECT\memory_places\Frontend> npm i react-cookie

PS C:\PATH_TO_YOUR_PROJECT\memory_places\Frontend> npm install react-i18next i18next --save

PS C:\PATH_TO_YOUR_PROJECT\memory_places\Frontend> npm install i18next-http-backend i18next-browser-languagedetector --save

Backend

PS C:\PATH_TO_YOUR_PROJECT\memory_places\Backend> python -m pip install djangorestframework django-cors-headers

PS C:\PATH_TO_YOUR_PROJECT\memory_places\Backend> pip install djangorestframework-simplejwt

PS C:\PATH_TO_YOUR_PROJECT\memory_places\Backend> pip install django-smtp-ssl

PS C:\PATH_TO_YOUR_PROJECT\memory_places\Backend> pip install python-dotenv

PS C:\PATH_TO_YOUR_PROJECT\memory_places\Backend> pip install pillow

PS C:\PATH_TO_YOUR_PROJECT\memory_places\Backend> pip install PyJWT

Used API's / materials

• Google Maps API: https://developers.google.com/maps
• SVG icons: https://tablericons.com
• Shadows: https://manuarora.in/boxshadows

License

Memo_places is published under the Attribution-NonCommercial 4.0 International license.

Authors

• Sebastian Mackiewicz
• Mikołaj Kusiński
• Dariusz Karasiewicz