This group project was undertaken as part of a university course, with the goal of developing an interactive web application designed to promote an active lifestyle within local communities in Gdańsk, the city where we study. It seeks to enhance local sports participation by offering a comprehensive platform for discovering various sports facilities, including unique options such as outdoor gyms. Users can access detailed information on each complex, including categories, opening hours, contact details, and location. Furthermore, the application fosters community involvement by enabling users to submit new complexes and organize events, pending administrator approval. This feature is intended to encourage sports within local communities by making it easier to organize tournaments and group activities.
- Interactive Map: Displays sports complexes in Gdańsk, highlighting both specialized and niche options.
- Complex Details: Provides comprehensive information, including categories, opening hours, contact numbers, and precise locations.
- User Contributions: Allows users to suggest new sports complexes and events, subject to administrator approval.
- Event Participation: Facilitates user participation in sports events, enhancing community engagement.
- Reviews: Offers a platform for users to share their experiences and feedback on sports complexes.
- Administrator Panel: Enables administrators to approve submissions of sports complexes or events, remove existing complexes, or modify their information.
- User Authentication & Authorization: Ensures secure login for users and restricts access to the admin panel to authorized individuals only.
- Frontend: HTML, CSS, JavaScript, jQuery, Leaflet, OpenStreetMap
- Backend: Spring Boot 3.2, Spring Security, Java 21, Gradle 8.5, JPA, PostgreSQL
- Development: Docker Compose for easy project setup
The project comes with detailed documentation, all part of the course work. You'll find diagrams, pictures, and system requirements in the /docs folder, all in Polish. We put this together to practice how real-world project discussions and planning with a client might go.
Adopting the Scrum methodology, the development process was structured around 2-week sprints. Each sprint review was conducted in front of our tutor, demonstrating our progress and receiving valuable feedback. The Agile board, is accessible in the project's GitHub Projects tab.
To run the project locally:
- Ensure Docker is installed on your system.
- Clone the repository to your local machine.
- Navigate to the project directory and run
docker compose upin your terminal. - Access the application through your web browser at the
http://localhost:80/address.
