Skip to content

ziqing26/confused-pwa

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Confused

Real Time Student Feedback Progressive Web App

AY22/23 CS3216 Assignment 3

Give it a try now!

Table of Contents

  1. Overview
  2. Team Members
  3. Submission
  4. User Guide
  5. Development Guide

Overview

Confused is a Progressive Web App (PWA) designed to help students give instructors real time feedback. It is traditionally uneasy for shy students to raise concerns in the public in big classrooms, so Confused is here to help reduce the mental barriers for students to say "I'm confused" during lessons.

On our app, instructors could create, start and share sessions using session code or QR code. They could easily keep track of students' reactions and questions in a session.

Whenever students feel confused during a session, they could simply tap the reaction "I'm confused" to give instructors instantaneously feedback. They are also encouraged to send questions to give instructors more hints of what they are confused about!

Feel free to give it a try at: https://confusedsession.vercel.app

Team Members

Members of CS3216 Assignment 3 Group 6:

Name Contribution
Ne Zhijian, Didymus Full Stack Developer
Duan Yu Hang Frontend Developer
Hong Ai Ling Frontend Developer
Toh Kar Wi Backend Developer
Zhang Ziqing Frontend Developer

Submission

The following files are in submission folder:

User Guide

Choose to join as instructor or student upon landing at this page:

Instructor

  1. Sign Up or Log in as an instructor using email

  2. View Session and Create a Session

Upon logging in, you can view the list of sessions and edit them. If you want to create a new session, click on the "+" button at the bottom right corner

  1. Start a Session

Press the "START" button to start a session. Now you can share the session for your students to join!

  1. In a Session

Your page color will trun yellow then red as more students become confused. Meanwhlie if fewer students are confused, the screen will return to green eventually. Press "RESET" to reset reaction counts on the screen.

  1. End Session

Press "End Session" to end the session and return to dashboard.

Student

  1. Join Session

Join a session by clicking a shared link, keying in the session code or scanning QR code shared by instructors. Add a nickname to continue. Rest assured that your activities will be kept anonymous to everyone.

  1. In a Session

When you are confused, do not hesitate to press "I'm confused" so that your instructor will know immediately. You can also unselect "I'm confused" or press "I'm OK". You can also ask a specific question if you feel a single reaction is not enough.

  1. Leave Session

Click on "Leave Session" on the top left bar to leave the session.

Development Guide

To run this application locally, first clone this repository.

git clone https://github.com/cs3216/2022-a3-2022-a3-group-6.git

Then follow the instructions for backend and frontend:

Backend

The backend is built using Python, Django and PostgreSQL: Backend Development Guide

Frontend

The frontend is built using Ionic, React and TypeScript: Frontend Development Guide

About

A progressive web app built for CS3216 Assignment 3. Confused helps students give instructors real time feedback.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • HTML 41.9%
  • TypeScript 32.6%
  • Python 16.7%
  • CSS 5.1%
  • SCSS 3.7%
  • Shell 0.0%