🌍 myWorld Travel API - Backend

A production-ready RESTful API with HATEOAS support for personalized travel experiences. Discover attractions, get recommendations, navigate, and experience the world with myWorld.

---

📁 About

This repository contains the Backend API for the "MyWorld" project, developed for the Software Engineering II course (2025–2026) at the Aristotle University of Thessaloniki (ECE, AUTh).

---

🚀 Quick Start

Prerequisites

• Node.js v18 or higher
• Bash terminal (Git Bash on Windows)
• MongoDB (optional) - Setup Guide

Setup & Run

# Clone and navigate
git clone https://github.com/fraidakis/software-engineering-2-backend.git
cd software-engineering-2-backend

# Run start script (installs dependencies, configures env, starts server)
bash start.sh

Access the API:

• API: http://localhost:3001
• Docs: http://localhost:3001/api-docs
• Health: http://localhost:3001/health

---

📚 Documentation

Comprehensive documentation has been organized for easy navigation:

• Getting Started Guide - Detailed setup, configuration, and troubleshooting
• Architecture Overview - Design patterns, project structure, and tech stack
• API Reference - Complete endpoint documentation
• Database Setup Guide - MongoDB configuration (for production use)
• Testing Guide - Test conventions and best practices
• CI/CD Documentation - Pipeline details

---

🌿 Branching Strategy

• main: Stable, production-ready code
• [student-username]: Individual development branches

---

👥 Project Team

• Chalvatzis Ioannis - Ichalvatz
• Fraidakis Ioannis - fraidakis
• Gkolias Dimitrios - MimisGkolias
• Zeri Eleana - eleanazeri

---

🧑‍🏫 Instructors & TAs

• Professor: Andreas L. Symeonidis (asymeon)
• Post-Doc Researcher: Thomas Karanikiotis (karanikio)
• PhD Candidate: Demosthenis Natsos (dcnatsos)
• PhD Candidate: Georgios Siachamis (GSiach13)

---

🔗 Related Repositories

• Frontend Repository: github.com/fraidakis/software-engineering-2-frontend

---