codeforsanjose / sjpl-mealtally

Web app to help San Jose public libraries coordinate free community meals.

Running the web app locally

0. Read Code of Conduct (https://github.com/codeforsanjose/codeofconduct) and CONTRIBUTING.md!!!

1. In your terminal, cd into your project folder and clone this repo and navigate to correct branch:

$ git clone https://github.com/codeforsanjose/SJPL-MealTally

2. cd into SJPL-MealTally and run npm install

3. Run the command npm run build

4. Setup MongoDB local db instance node config/setup_local_db.js or talk to project team for instructions to get test data

5. Copy example.projectInfoData.json to projectInfoData.json and edit it so that localURL points to your local MongoDB (usually mongodb://127.0.0.1:27017)

6. Start the web app in another tab: node server.js

7. Open localhost:8080 to enter from the web app's Home page.

Background

The San Jose Public Library runs a summer program where they provide three meals a day + snacks to children at seven of their branches. The meals come from the YMCA, and left over meals can be served to adults, but the library must pay the YMCA for any meals that don't go to a child.

Because of the above restriction, the library must keep diligent documentation of each meal, and the coordinator sends a weekly report for each library. For the past two summers, a volunteer was needed just for the task of filling out the paperwork at each library at every meal - keeping track of how many new meals were received, left over, how many went to kids, etc. Not only does this mean that the volunteer can't help with other tasks, but it is also creates over 8,000 pages of paperwork per month. Keeping up on the paperwork is a grueling task.

State of the app

Last October, some friends and I hacked together a software solution during a 30-hour hackathon. We have since delivered the mobile and web app to the library, but since this was a quick hack, there are still some tasks that need to be taken care of before the meal program starts back up in May. I am currently the only developer still working with them on the web portion of the project, and my time is limited, plus this seems like a great project for CfSJ to be involved in as it benefits our public libraries. See open issues for a list of current tasks.

Dashboard

1. Work in progress The dashboard allows the meal coordinator to keep an eye on meal trends at each library. (NOTE: Not yet connected with the current database schema)

Mobile Web App

This is the current UI to add meals, record logs and generate pdf reports.

Meal Tally App

1. The volunteer selects the library name and the meal type (e.g. Lunch) on the Meal Info card. Date is also customizable; default value is current time in timezone -07:00.
2. The total received meals is logged on the Inventory card.
3. As program attendees enter the meal line, increments are made for each person on the Categories card.
4. After the meal line stops in its entirety, the leftover meals are input on the Inventory card.
5. A signature such as one's full name is input on the User Info card; the meal tallies can then be pushed to the database by clicking "ADD MEAL".
6. Click the "RESET COUNTS" button to clear all categories tallies (NOTE: Careful not to accidentally press this instead of "ADD MEAL" #32)

Profile

1. Editing the volunteer's profile

Report

1. The start and date range can be selected (NOTE: End range is exclusive, so to get today increase the date end by one day #29).
2. Click "GET MEAL REPORT" to preview a list of cards each with a unique:

• library name
• meal type
• category totals

3. A new card appears at the bottom of the Report tab. Type an output PDF file name and click "SAVE PDF" to download the report.

See the live Heroku demo; read this wiki article for development details.

sjpl-mealtally's Issues

Migrate web app from Heroku and mLab to AWS.

Update selectedDate to show local US/Pacific time.

Original TODO comments

• home.ts#L25
• log.ts#L27

Additional date instances to convert to local time

• report.ts#L40-L41

ERROR TypeError: reports[i]._id.library is undefined

Appeared in Web Console when trying to generate a pdf report from June 1st, 2017 to July 26, 2017.

Requirements

• fix these lines to match the current Report class

Project Description

Make web design more user friendly

The android app had a nice interface that was mobile friendly. We should implement that in the webapp.

Context API integration

Need daily reports with weekly

When exporting weekly reports, need report for each day of that week attached

Add master-detail table view of all meal entries.

This will allow users to view previous meal entries.

Research: Talk to YMCA about their end of the process

Add login page.

Requirements

• Add input for user's name
• Add input for some code all librarians use for simple human verficiation (e.g. b4nanaMuff!nCrumbs)

Consider recording video footage from end of line for backup tally measurements.

I discussed this with Tomkia Price as a backup measurement in case the assigned volunteer should lose focus from the tallying task. However, she hinted there might be conflicts with library policy or ymca event restrictions.

This would be ideal though to possibly collect training data for a neural network that classifies images of people as meal categories (e.g. Adult, Children, Staff, etc.)

Edits are not/can not be saved

Edit saved report (change library and meal)
Click done
Only edit/close is available
Close
Edit not saved

Make library name list dynamic

Add a new table to the db with library names, fetch from this table for the front end. Maybe add a way for library person to add and remove libraries from the dashboard.

Display total meals served that day on home page.

Web app does not resize when keyboard input opens; cannot see comment box on log page.

Make database access go through a .env file

Make database access run through a .env file and supply an example.env file.

We should also set up a dummy database for people to develop on.

This will make it easier for people to deploy locally.

Tally inputs are only one digit wide.

Seen across mobile browsers in portrait mode on a Samsung Galaxy S6. Although the browser iterates through each digit, it's cumbersome to wait when the end user would most likely prefer seeing the full count in one glance. Meanwhile, the full count can still be seen in landscape mode.

Requirements:

• Extend column width for ion-input directives

User Research: Interview with library volunteer

Update README and make sure steps work for onboarding devs

Requirements:

• List dependencies (e.g. Ionic CLI, Typescript, etc.)
• Add step in "Running the web app locally" to set MONGODB_URI in Node (like in a .env file or in the current case on Heroku); replace confusing $ MONGODB_URI=∆ node server.js junk with $ node server.js

React frontend rebuild

rebuild the frontend using React. Using other repo (https://github.com/Opportunity-Hack-San-Jose-2017/Team3).

After I enter Tully Library's numbers, zeroes show up under Reports

Admin profile dashboard

This is only for organizers/admins

Add better error handling of Angular services for production environment.

User profile logs tab

Need to figure out if this tab is for all Volunteer and admin users.

tabs css will be different just need component

Educational Park and Biblioteca Branch not an option under "Location"

Online Article from Code for San Jose perspective

Implement @screenspan's marvel app ui.

Description

• Marvel prototype: 25g0e5j

Requirements

• Update src/pages
• Check for human presence as a login
  • Name: Justin Hester
  • Code: BananaMuffinCrumbs

PDF report generation

PDF generator using templates for easier PDF generation.

User Profile reports tab

Need to figure out if this tab is for all Volunteer and admin users.

Tabs will also be different for now just need the component.

Loading `cordova.js` causes a 404

Manually enter meal entries since June 2nd, 2017.

Requirements:

• Create meal documents for each meal at each active library via mongo shell
• Save backup pdf report

Local mongo db setup

Clicking "export" goes to "error" page

goes here:
https://mealtally-server.herokuapp.com/report/undefined

Refactor function callback for API endpoint `/api/meals/:start/:end` to return docs

Mobile interface tool

Need something other than Ionic/Cordova

Identify whether pdf should be generated by jsPDF server-side or client-side.

Remove accidental submission snack for lunch at HB

2017-06-26

Data visualization: Summer 2017

Add a send pdfs button to the dashboard

Add a button to call cronTask from the dashboard. Might want to change the function name to something more fitting since it's not longer using cron. Maybe uninstall the cron module from the server as well.

Update alert windows' title and subtitle messages.

Start and end date range for reports should be inclusive.

Observed after alpha test at Edenvale Library on June 2nd, 2017

Requirements:

• Refactor mongodb $match stage in API endpoint "/api/meals/:start/:end"? (Already uses greater than or equal though)

Remove Android code

Volunteer/Organizer application tabs

There are three tabs along the bottom screen:

Home - meal tally - in progerss
Log -
Report -

Add 'wasted meals' to weekly PDF report

Implement @screenspan's stellar UI

Invalid Operation on home page

The profile page on startup checks for a user id in the url. When none is available the promise api for getUser fails with a JSON.parse error:

Invalid operation SyntaxError: JSON.parse: unexpected character at line 1 column 1 of the JSON data

its in api.js
line 69

Use Mailgun rather than Gmail?

Up for discussion, but I usually like using Mailgun rather than Gmail SMTP for sending emails out.

It's a bit easier for folks to set up compared to SMTP, and there's better analytics on the messages that are sent out.

@RoBeau What do you think?

Comments not saved/exposed in reports

Comments are not saved or exposed in reports (on reports page or exported excel docs)

Design home page to avoid accidental presses of "Reset Counts" button.

Tomika recommended the button be moved above the library and meal selections.

@clarle also suggested:

1. The browser syncs up after every call to the increaseCount() and decreaseCount() methods in HomePage component.
2. The user is prompted with a confirmation window when selecting "Reset Counts" (i.e. Are you sure you'd like to reset counts (y/n)?

In addition, Ionic's Storage class could locally store current tallies in case the meal tally app is closed before they're recorded in the database.

reformat the Angularjs app.js file

I believe it is necessary to reconstruct the app.js file. it have like 20,000 lines of code. when you try to change something, it is lagging so much. basically can not add more code onto that file. Please reformat so we can add more features and maitenance.