UCT MEC4128Z Project Browser

A lightweight web application intended to serve project offerings for the MEC4128Z Final-Year Project course. This web app is served by GitHub Pages and consumes project data as a JSON array served from a Google Apps Script API backend.

---

Overview

This web app provides students with an interactive interface to explore project options, currently the web app supports:

• Full-text searching
• Multi-select filtering
• Client-side caching of project list

---

JSON Format

The following is the expected format of the JSON array ingested by the browser:

[
  {
    "id": "001",
    "title": "Project Title",
    "supervisor": "Dr Foo Bar",
    "co_supervisor": {
      "exists": true,
      "name": "Prof John Doe"
    },
    "project": {
      "brief": "Short description...",
      "capacity": 2,
      "assigned_student": "Alice Brown",
      "keywords": ["calibration", "algorithms"],
      "prerequisites": ["MEC4124W"],
      "field": "Control, Robotics & Mechatronics"
    }
  }
]

The id field must be a zero padded string, while keywords and prerequisites should be arrays. Empty values may be "" or []. If the Google Apps Script could not access form response sheet the following response is expected:

{ "error": "Could not collect form responses." }

---

Supported Features

1. Project Filter through the use of drop down filters:
   • Primary Field Filter
   • Keywords
   • Supervisor
2. Text based searching through the following fields:
   • Project title
   • Supervisor name
   • Project description
   • Keywords
3. Client Side Caching