SC2002 Object-Oriented Project — MOBLIMA

A console-based Movie Booking and Listing Management application.

• Demo
• Documentation

---

🛠️ Installation and Set Up

• Clone repository

  git clone https://github.com/Ry3nG/MOBLIMA.git
  

• Run build executable

  • Customer mode

    java -jar build/moblima.jar
    

  • Staff mode

    java -jar build/moblima.jar --staff
    

  • Debug mode

    java -jar build/moblima.jar --debug
    

---

📂 Project Structure

📦moblima
 ┣ 📂data
 ┃ ┣ 📜movies.csv
 ┃ ┗ 📜README.md
 ┣ 📂build
 ┃ ┣ 📦moblima.jar
 ┣ 📂diagram
 ┣ 📂docs
 ┣ 📂lib
 ┣ 📂datasource
 ┣ 📂src
 ┣ 📂test
 ┣ 📜README.md

/build - contains the compiled executable of the project
/data - stores all the serialized data to be utilized
/diagram - contains project UML documentation
/docs - contains the Javadoc
/lib - contains the project dependencies
/datasource - internal module to fetch real-world data from various APIs
/src - contains the project source files
/test - contains the unit test cases

---

📑 Data Sources

A working set of serialized data is readily available in the /data folder.

🧬 Retrieval and Re-Generation

OPTION #1

To re-generate a clean data set, run the build executable with

java -jar build/moblima.jar --generate --debug

OPTION #2

⚠️ This option requires an TMDB_API_KEY from The Movie Database (TMDB)

1. Duplicate the .env.example and save as .env.
   
2. Store your API KEY as TMDB_API_KEY=<YOUR API KEY>
   
3. Run App.java to start the application
   

• Movie Data - The Movie Database (TMDB)
• Public Holiday Data - Ministry of Manpower (MOM) / API

---

🧰 Languages & Tools

• Languages
  

• Tools, IDE
  

---

Contributors ✨

Crystal Cheong

Ryan Gong

Min Min

Clara Heng

Han Wen

---

This repository is submitted as a project work for Nanyang Technological University's SC2002 - Object-Oriented Design & Programming course.