Spearfishing4Life

Link to website:

https://goto.pythonanywhere.com/

"Welcome to Spearfishing4Life application! This page is a worldwide community. We respect each other. So we expect you do the same! Here we are all brothers in our passion and love - Spearfishing and Diving! Here you can find a good resources, stories and much more. And also share your own. We organize a few Tournaments for free every year!"

Features

• User authentication and registration
• Upload photos
• Comment and share
• Create events
• Share stories
• Check weather(Weather API)
• Search/add new destinations(folium & geocoder APIs)
• Band calculator
• Apnea-Trainer(Advertisement)
• Useful resources and videos
• User-friendly interface with a full-responsive design
• Censored-System for comments and stories

Technologies Used

• Django(4.2.2)
• HTML, CSS
• JavaScript
• PostgreSQL
• Unit and Integration Testing
• Folium docs: https://python-visualization.github.io/folium/
• Geocoder docs: https://geocoder.readthedocs.io/
• Open-Weather(API) doc: https://openweathermap.org/current
• Django-embed-videos doc: https://django-embed-video.readthedocs.io/en/latest/

Installation

1. Clone the repository - HTTPS or SSH:
   • git clone https://github.com/GeorgiLukanov87/spearfishing_app
   • git clone git@github.com:GeorgiLukanov87/spearfishing_app.git


2. Install project dependencies:
   • pip install -r requirements.txt


3. Set up environment variables


4. Apply database migrations:
   • python manage.py makemigrations
   • python manage.py migrate


5. Create a superuser(required):
   • python manage.py createsuperuser
   • IMPORTANT: After create an superuser. Accessing admin panel -> "http://localhost:8000/admin/" To work properly - create at least 1 SEARCHS/address-model in LOCATIONS-app.For example: "Varna"


6. Run the development server:
   • python manage.py runserver

License

• MIT License

Video-Demo in YouTube

https://www.youtube.com/watch?v=XNHSm7wJup8

Usage

1. To access the Web-application, go to: http://127.0.0.1:8000/
2. To access the Admin-interface, go to: http://127.0.0.1:8000/admin/
3. To access the Add-photo, go to: http://127.0.0.1:8000/photos/add/
4. To access the Events, go to: http://127.0.0.1:8000/events/
5. To access the Weather, go to: http://127.0.0.1:8000/locations/weather/
6. To access the Locations, go to: http://127.0.0.1:8000/locations/
7. To access the Stories, go to: http://127.0.0.1:8000/stories/
8. To access the Add-story,go to: http://127.0.0.1:8000/stories/create/
9. To access the Band-calculator, go to: http://127.0.0.1:8000/calculator/
10. To access the Apnea-trainer, go to: http://127.0.0.1:8000/apnea-trainer/
11. To access the About-page, go to: http://127.0.0.1:8000/stories/about/

Screenshots

$${\color{orange}Locations \space page:}$$

$${\color{orange}Add-photo \space page:}$$

$${\color{orange}Weather \space page:}$$

$${\color{orange}Calculator \space page:}$$

$${\color{orange}Add-story:}$$

$${\color{orange}Profile-page:}$$

$${\color{orange}Users:}$$