Aplikacja do obsługi kina

Bartłomiej Chwast, Piotr Kowalczyk, Magdalena Królikowska

Charakterystyka aplikacji

Celem naszej aplikacji jest obsługa usług związanych z zarządzaniem kinem. Do głównych funkcjonalności należą: umożliwienie użytkownikom stworzenie kont i na ich podstawie rezerwacji miejsc na określone seanse. Admin może przeglądać użytkowników oraz dodawać, edytować i usuwać filmy, terminy i rezerwacje.

Instrukcja uruchomienia aplikacji

Uruchomienie aplikacji backendowej

cd AGH-BD-Cinema/backend/cinemaBackend
npm install
npm start

Uruchomienie aplikacji frontendowej

cd AGH-BD-Cinema/frontend/cinema
npm install
npm start

Technologie:

• React
• ExpressJS
• MongoDB

Struktura bazy danych

Baza danych zawiera 3 kolekcje:

• movies - zawiera filmy dostępne w programie filmowym kina

  • title - String - tytuł filmu
  • description - String - opis filmu
  • terms - Array - tablica dostępnych terminów deansów dla danego filmu
  • pictures - Array - tablica zdjęć reklamujących dany film

• terms - przechowuje terminy seansów danego filmu

  • date - Date - data seansu
  • totalPlaces - Int32 - całkowita liczba miejsc
  • freePlaces - Int32 - liczba dostępnych do rezerwacji miejsc
  • movie - ObjectId - identyfikator filmu na który dokonywana jest rezerwacja

• users - przechowuje dane o użytkownikach, którzy założyli konto na stronie internetowej kina

  • firstname - String - imię użytkownika
  • lastname - String - nazwisko użytkownika
  • email - String - email
  • password - String - hasło w postaci zaszyfrowanej
  • admin - Boolean - rozstrzyga, czy użytkownik ma uprawnienia administratora
  • reservations - Array - tablica przechowująca obiekty reprezentujące rezerwacje
    • movie - Object - film, na który dokonano rezerwacji
    • customer - identyfikator klienta
    • term - identyfikator terminu
    • numberOfPlaces - Int32 - liczba zarezerwowanych miejsc

Przykładowe dane

• movies

  {
  "_id": {
    "$oid": "628d0e40a10e7e00e8b9baf0"
  },
  "title": "Joker",
  "description": "Genialna produkcja",
  "terms": [
    {
      "$oid": "628d0ed9daa9ee4b79bdf11a"
    },
    {
      "$oid": "628e62fcb130b4b8ba3422f0"
    },
    {
      "$oid": "628f5987c8490d6fc11499f2"
    },
    {
      "$oid": "628f88544e71b8cf21f2998b"
    }
  ],
  "pictures": [
    "https://fwcdn.pl/fpo/01/67/810167/7905225.3.jpg",
    "https://fwcdn.pl/fph/01/67/810167/833479_1.3.jpg"
  ],
  "__v": 3
  } 
  
  

• terms

  {
    "_id": {
      "$oid": "628d0ed9daa9ee4b79bdf11a"
    },
    "date": {
      "$date": {
        "$numberLong": "1656084720000"
      }
    },
    "totalPlaces": 45,
    "__v": 0,
    "freePlaces": 45
  },{
    "_id": {
      "$oid": "628e637eb130b4b8ba3446c9"
    },
    "date": {
      "$date": {
        "$numberLong": "1653316380000"
      }
    },
    "totalPlaces": 50,
    "freePlaces": 50,
    "__v": 0
  }
  
  

• users

  "_id": {
    "$oid": "628d0ffa0a91d6f19c7403e6"
  },
  "firstname": "Jakub",
  "lastname": "Maziarz",
  "email": "mazik@gazik.com",
  "password": "$2a$10$b/2flNNIFDtxRsZq709cA.z2zvKemgWpZjt1T6jn8Ej4ezSKd/Sfq",
  "admin": true,
  "reservations": [
    {
      "movie": {
        "title": "Joker",
        "movieRef": {
          "$oid": "628d0e40a10e7e00e8b9baf0"
        }
      },
      "customer": {
        "$oid": "628d0ffa0a91d6f19c7403e6"
      },
      "term": {
        "$oid": "628f88544e71b8cf21f2998b"
      },
      "numberOfPlaces": 13,
      "_id": {
        "$oid": "628f9d235b83d529a02fd1a4"
      }
    }
        
  

Frontend

• admin-page - widok dla administratora wyświetlający jego rolę, imię i nazwisko, jego rezerwacje oraz użytkowników wraz z ich rezerwacjami oraz możliwością edycji oraz usunięcia rezerwacji danej osoby
• error-page - widok podczas wystąpienia błędu 404
• home - widok startowy aplikacji
• login-page - widok logowania
• movie-add - widok dodania nowego filmu do bazy danych, dostępny tylko dla administratora
• movie-delete - widok usunięcia filmu z bazy danych, dostępny tylko dla administratora
• movie-edit - widok edycji filmu, , dostępny tylko dla administratora
• movie-page - widok podglądu danego filmu wraz z dostępnymi terminami seansów
• movie-picture - slideshow dla plakatów reklamujących film
• movie-tile - widok danego filmu wraz ze szczegółami
• movies-container - galeria filmów
• nav-bar - responsywne menu opcjami wyboru zależnymi od rangi użytkownika (admin/klient)
• reservation-add - widok dodania nowej rezerwacji
• reservation-delete - widok usunięcia rezerwacji
• reservation-edit - widok edycji rezerwacji
• reservation-tile - "wizytówka" rezerwacji wraz z ilością miejsc oraz odnośnikiem do filmu, na który jest złożona
• signup-page - widok rejestracji
• term-add - widok dodawnia noewgo terminu seansu dla danego filmu
• term-delete - widok i obsługa usunięcia terminu seansu
• term-edit - widok edycji terminu seansu
• user-page - widok strony użytkownika, wyświetla jego rolę, imię i nazwisko oraz jego rezerwacje

Backend

Modele

• Movie.js

  const mongoose = require('mongoose');
  
    const MovieSchema = mongoose.Schema({
        title: {
            type: String,
            required: true
        },
        description: {
            type: String,
            required: true
        },
        terms: [{
            type: mongoose.Schema.Types.ObjectId,
            ref: 'Terms'
        }],
        pictures: [{
            type: String,
            required: false
        }]
    });
  
    module.exports = mongoose.model('Movies', MovieSchema);
  

• Term.js

  const mongoose = require('mongoose');
  
  const TermSchema = mongoose.Schema({
      date: {
          type: Date,
          required: true
      },
      totalPlaces: {
          type: Number,
          required: true
      },
      freePlaces: {
          type: Number
      },
      movie: {
          type: mongoose.Schema.Types.ObjectId,
          ref: 'Movies',
          required: true
      }
  });
  
  module.exports = mongoose.model('Terms', TermSchema);
  

• User.js

  const mongoose = require('mongoose');
  
  const ReservationSchema = mongoose.Schema({
      movie: {
          title: {
              type: String,
              required: true
          },
          movieRef: {
              type: mongoose.Schema.Types.ObjectId,
              ref: 'Movies',
              required: true
          }
      },
      customer: {
          type: mongoose.Schema.Types.ObjectId,
          ref: 'Users',
          required: true
      },
      term: {
          type: mongoose.Schema.Types.ObjectId,
          ref: 'Terms',
          required: true
      },
      numberOfPlaces: {
          type: Number,
          required: true
      }
  });
  
  const UserSchema = mongoose.Schema({
      firstname: {
          type: String,
          required: true
      },
      lastname: {
          type: String,
          required: true
      },
      email: {
          type: String,
          required: true
      },
      password: {
          type: String,
          required: true,
          min: 8,
          max: 1024
      },
      admin: {
          type: Boolean,
          default: false
      },
      reservations: {
          type: [ReservationSchema],
          default: []
      }
  });
  
  module.exports = mongoose.model('Users', UserSchema);
  

API

• auth.js

  • POST: /register - rejestracja nowego użytkownika
  • POST: /login - logowanie użytkownika
  • POST: /logout - wylogowanie użytkownika

• movies.js

  • GET: / - wyświetlanie dostępnych filmów
  • POST: / - dodawanie nowego filmu
  • GET: /:id - wyszukiwanie filmu
  • DELETE: /:id - usuwanie filmu
  • PUT: /:id - aktualizacja filmu
  • GET: /:id/terms - wyświetlanie terminów seansów danego filmu
  • POST: /:id/addterm - dodawanie nowego terminu seansu

• terms.js

  • GET: / - wyświetla wszystkie terminy dla wszystkich filmów
  • POST: / - dodawanie nowego terminu seansu
  • GET: /:id - wyszukiwanie danego terminu seansu
  • PUT: /:id - aktualizacja terminu seansu
  • DELETE: /:id - usunięcie terminu seansu

• users.js

  • GET: /:id/reservations - wyświetla rezerwacje danego użytkownika
  • POST: /:id/reservations - dodawanie nowej rezerwacji
  • PUT: /:user_id/reservations/:reservation_id - aktualizacja ilości miejsc w rezerwacji
  • DELETE: /:user_id/reservations/:reservation_id - usuwanie rezerwacji
  • GET: /:id - wyszukiwanie użytkownika po id
  • GET: / - wyszukiwanie wszystkich użytkowników