code4hr / cbf-clean

Citizen reporting web app for Clean the Bay Day (CBF.org/clean), Meteor.js, @BretFisher

code4hr.org

The website for the Code for Hampton Roads Brigade

Goals

1. Explain what Code for HR is and the type of work we do.
2. To celebrate our events, projects, and discussions!
3. Encourage current and new members to participate with clear ways to get involved.
4. To have this site be easily reused by other Brigades just starting out.

Tech

Built using Jekyll, Bootstrap, and the CfAPI.

Contributing

Submitting an Issue

We use GitHub Issues to track bugs and features. We've included several of our open GitHub Issues right on our homepage using the Civic Tech Issue Finder.

Running the Site Locally on Your Computer

To run the site locally on your own computer (most helpful for previewing your own changes), you will need Jekyll installed (click here for Jekyll installation instructions.)

Fork and clone the repository, then run the following command in the root directory of the repo:

jekyll serve

or

jekyll serve --watch which will watch for changes to files.

Your computer should now be serving your local copy of the site at:

http://localhost:4000.

Sharing Your Changes Using Jekit

You can use the nifty Jekit app to preview changes you make to this site.

To do this, fork this repo, and commit your changes on a branch to your fork. You can then preview what your changes look like by navigating to:

https://jekit.codeforamerica.org/USERNAME/code4hr/BRANCHNAME/

For a basic example of its usage, if GitHub user @lolname has made changes to the projects page on their fork (on the master branch), they can preview their changes using Jekit by going to:

https://jekit.codeforamerica.org/lolname/code4hr/master/projects

Submitting a Pull Request

1. Fork the project.
2. Create a topic branch.
3. Implement your feature or bug fix.
4. Commit and push your changes.
5. Submit a pull request.

cbf-clean's Issues

Claify Email field purpose?

Email (NOT visible to public/only used if we have questions) *

(just added the part about not being visible to public)

Add links to prior years

When I visit the site I'd like to see previous Clean the Bay Days

• Data
• Summary

Typo in Partner List

Eastern Short should be Eastern Shore

Add partner filter on report page

add Meteor:spiderable package to allow google indexing

http://docs.meteor.com/#spiderable

tweak responsive design for smartphones

not everything works well. tweakage needed.

turn CBF logo into a logo for us, plus favicon

Validate values between 0 and 1

Current validation rule reports values between 0 and 1 as invalid (highlights red). Fractional values are valid in some cases, ex., miles. Today we cleaned .75 miles.

Add Help "How to use this" page

"new way, same as the old way"

contact for help info

Testing Task List

By Users

• Give a few questions to users for UAT: submit a few forms, filter some cities, download and check out .csv. Ask for their response to those questions. (google form, or wufoo, or just email?)

By Dev's

• Add (thousand) records and test page load and csv on mobile and slower pc
• Test on common browsers back to IE 7. Maybe use www.browserstack.com
• Test bad users: back buttons, refresh on form submit, google meteor security

Add optional geolocation

Add an option to collect the user's geocoded location from user's device.

IE 7/8 doesn't work with select form control

possible solution
http://stackoverflow.com/questions/1539032/getting-the-value-of-a-select-box-in-internet-explorer

Test with older IE and warn of old bad browsers

http://theie8countdown.com/join-the-cause

Add CSV export

Add field: "How many clean-up sites are you reporting on?"

(This value would be whole integers only)

This data would be a part of the "More Detail" report. Each year, I really have no way of knowing how many sites we worked. N It will also help clear up any sort of double reporting that occurs.

Cheers,

TC

Reporting filter menu doesn't work

If you go to reporting and use the dropdown menu nothing happens. The view should filter by organization

add animation to new submits

https://github.com/oortcloud/unofficial-meteor-faq#animation

Add visualization

There's interesting data in Clean the Bay Day. Let's look at it!

• Map of zones
• Zone reports linked to map
• Most common item(s)

Dashboard (front page) Stat Ideas

Add ideas here for stats we could show to increase engagement, revisits, potential for social sharing, etc.

• this years stats vs. last year, or last three years
• current users on site
• this years totals like total volunteers, miles, pounds
• mini map showing where people are reporting in from (need geoloc for each partner or zone).
• pounds of trash in interesting stats, like we've filled XX grocery carts worth of trash or how much it would cost municipal cleaning to do the same job
• Stats about our watershed that help them feel the impact: how much Bay has improved since we started, etc.
• Get the kind of impact stats that CBF gives to their board, and share on dashboard, maybe create infographic if we want to display lots of history and help with media exposure.

form validation

prevent letters where numbers belong, require zone captain, zone, partner

add user IP to csv so we can detect dupe data

hide trash/picnic if not VB

Authentication

Good to know who is reporting. Also don't want a troll to submit a bunch of bogus results.

add thank you hero-unit after form submit

give them warm fuzy

fix checkbox submissions

form checkboxes aren't getting into mongo correctly.

preserve partner selection on form and reports

form cancel button doesn't work

Content is not URL addressable

All links direct to the root domain. It is not possible, for example, to point directly the reporting page. It is often useful to link directly to pages and even down to page elements.

CBF-Clean needs the ability for pages & elements to be URL addressable.

test in IE 7 and 8

Add sharing buttons

Let Zone captains share their efforts via FB and Twitter.

Change formatting for fixed width iframe?

http://www.cbf.org/bb_testfolder/clean-the-bay-day-reporting

marketing of this app

once we're at a MVP, maybe we can update CfVB.org, setup a demo, pick a license (MIT?), and offer to other brigades as a basic "web form collection app that's not wufoo or gapps".

add uservoice feedback button or link for feedback

https://ctbd.uservoice.com

Clean out test data

This record is legitimate:

Kevin Curry City of Virginia Beach King's Grant 4 40 0.8

improve timestamp with ejson

I'd like us to have timestamps on report submits for easier ordering and detailed analysis. doc_id's are GUID's so can't use those for sorting.

http://docs.meteor.com/#ejson

Invalid form submits

Newly installed jsBootstrapValidation highlights invalid data & but fails to prevent submit button on invalid.

Add Authentication

If the site is to remain active longer than the reporting period for Clean the Bay Day then user authentication may be required to prevent misuse such as false reporting.

• OAuth compliant
• Off-the-shelf social network/mail client library
  ++ Twitter, Facebook, LinkedIn, Google
• Avoid the password anti-pattern i.e., avoid implementing username & password scheme

add form popups for calculations

ESTIMATED WEIGHTS for DEBRIS COLLECTED Automobile parts – 25 lbs. Metal container – 50 lbs. Bag of litter – 15 to 25 lbs Wooden pallet – 30 lbs. Bag of clothes – 30 lbs. Refrigerator – 500 lbs. Bicycle - 25 lbs. Shopping cart – 50-60 lbs. Chair – 25 lbs. Sofa – 80 lbs. Dishwasher – 75 lbs. TV/Computer – 15 lbs. Dresser – 50 lbs. Tire – 25-50 lbs. Mattress – 25 lbs.

Estimating Distance to be Cleaned Record the “Distance to be Cleaned” in miles. Estimate the longest linear length (i.e., from point A to point B along the beach/shore) to be cleaned by the volunteers. Do not report area measurements, such as square feet, square miles, square kilometers, or acres. Use the following method to convert area measurements to linear distances: Number of square feet cleaned divided by 10 ft.* divided by 5280 ft. (1 mile) = linear miles cleaned *10 feet represents an average linear path cleaned by a volunteer (5 feet on each side of the person) Example 1: You plan to clean a 1-acre area. 1 acre = 43,560 ft2 43,560 ÷ 10 ÷ 5280 = 0.825 miles cleaned Example 2: You plan to clean 5000 ft2 . 5000 ÷ 10 ÷ 5280 = 0.094 miles

Change label on Partner form item

Label says "City/County", tip says "Choose...Partner", choices are partner.

Change label to "Partner"

Create Production Environment

• Determine where to host production app, ex., Heroku, Nodejitsu
• Setup up master repo to auto-deploy to production
• Point cleanthebayday.net to production instance

Can we add Google maps drawing tools?

https://developers.google.com/maps/documentation/javascript/examples/drawing-tools

It's helpful to draw routes, areas and drop place marks.

I used to use explorer.arcgis.com but it's no longer reliable: Silverlight and buggy.

This looks like it's as simple as hosting this page somewhere on cleanthebayday.net