Inclusive Classrooms Skills Wheel

This is a @dwyl project being taken on by @danwhy & @jbarget. We will be making a digital form of the Teaching Assistant's (TA) skills wheel created by Inclusive Classrooms. Our workflow will be represented in the issues we create/close and the labels we use.

There are 3 parts to the project:

1. Main Page

• inputs for child information
• questions for TA to answer as a form

2. Skills Wheel

• representing the TA's answers in the skills wheel

3. Data Collection

• storing the data in Redis
• sending the data to a google spreadsheet

We also hope to be able to integrate our work with the current Inclusive Classrooms website

Testing

Frontend Tests are written with Qunit, and are being run on PhantomJS for continuous integration with Circle-CI. Backend tests are written with Tape. Code coverage is currently provided by blanketjs. We're working on getting this integrated with Circle.

To see the coverage report for the frontend code, host a simple server in: python -m SimpleHTTPServer and go to localhost:8000/test/test.html Make sure the 'Enable Coverage' box is ticked.

The form

The form is structured from normal html and jquery and styled using plain css and bootstrap. All fields are required to be filled out before submitting.

The Wheel

The Skills Wheel has been created using D3. All code for this is in public/wheel.js and is commented for clarity. The wheel and the accompanying details can be downloaded and saved as a pdf, which is generated on the server using html-pdf.

Data

When the form is submitted, the data is sent to a Google Spreadsheet and a Redis database.

Redis

The redis database is structured as follows:

School: {
  TA: {
    Group: {
      Student: {
        Date: [{question, answer}...]
      }
    }
  }
}

This may need to be restructured in future sprints when the exact use of the data is finalised. It may turn out that a relational database such as postgresql is more suitable.

Hosting

The actual webapp itself is hosted on heroku at https://inclusive-classrooms.herokuapp.com, and can also be accessed at http://www.inclusiveclassrooms.co.uk/skillswheel. The heroku instance is synced with the master branch on github, so every push/merge with master will update the app on heroku.

File Structure

|-README.md
|-package.json
|-circle.yml
|
|-assets
|
|-lib
| |-handler.js
| |-server.js
|
|-public
| |-index.html
| |-index.js
| |-wheel.js
| |-collapse.js
| |-style.css
|
|-test
  |-fixtures
  |
  |-blanket.js
  |-index.test.js
  |-server.test.js
  |-test.html