Skip to content

Engagement Project - Sara Cerami #34

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
saracerami wants to merge 1 commit into
base: main
Choose a base branch
from
+17 −16
Open

Engagement Project - Sara Cerami #34

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
33 changes: 17 additions & 16 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,37 +1,38 @@
# Project Name

A brief title and one-line description of your project.
Guess the budget! Estimate how Philadelphia General Fund money is distributed amongst each city department.

## Project Proposal

Complete the following guiding statements to define the purpose and audience for your participation tool:

1. **The specific participants/community I want to engage are...**
<!-- Describe the specific participants or community members you want to invite to participate. Be more specific than "the general public". -->
1. **The specific participants/community I want to engage are Philadelphia voters**

2. **The contributions/input I am inviting them to make are...**
<!-- Describe what data, annotations, suggestions, or reports participants will contribute. -->
2. **I am inviting them to contribute their estimate of how they think the Philadelphia general fund budget is divided**

3. **The participants will benefit from contributing their input by...**
<!-- Explain how the participants themselves benefit from taking part. -->
3. **The participants will benefit from contributing their input by seeing where their estimates were accurate and inaccurate and they will see the aggregated estimates from other Philadelphia voters and how their estimate compares to others.**

4. **The users that will use the collected data are...**
<!-- Identify who will use the resulting data (these could be the same as the contributors, or a different group such as planners, organizers, or dispatchers). -->
4. **The users that will use the collected data are both Philadelphia voters and elected Philadelphia decision makers.**

5. **For voters, it can visualize how the budget is allocated. For decision makers, it can inform them on how well they are doing at clearly communicating the budget process to their constituency**

5. **The collected data will benefit those users by...**
<!-- (Optional, if the users of the data are different from the participants contributing the input) Explain how the data will help those users make decisions or take action. -->

## Overview

<!-- Provide a high-level overview of the application, how it works, and how users interact with the map and interface. -->
The interface will allow the user to input what percent of the general fund budget they think the City spends on each department. It will have a corresponding pie chart that changes each time they input a percentage into the boxes associated with each department. It will calculate the total amount of money in dollars depending on the percent they input.

They will submit their guess and the next page will tell them how correct they were. It will show the actual numbers in three different visuals: a pie chart, a steam graph, and a bar chart. They can toggle between each visualization. In addition to their estimate and the actual budget distribution, it will have category for what the average Philadelphia voter thinks. This will be the data collection element of the assignment. The tool will store all of the data that each voter submits and average it into one data set. It will be displayed next to "your guess" and "actual distribution" as "average Philadelphia voter's guess."

I will qualify this last statement by sharing where the aggregate data comes from.

## Data & Citations

<!-- List all data sources used by your application and include citations. -->
I am planning to use these sources:

* **Reference Data:** <!-- Describe any reference layers (e.g. basemaps, boundaries, transit lines) and cite their sources. -->
* **Participant Contributed Data:** <!-- Describe the schema/structure of the data that participants generate or contribute. -->
*City of Philadelphia, FY2027 Proposed Operating Budget. Data compiled by Aaron Couch, phila-budget-site (acouch, GitHub). https://github.com/acouch/phila-budget-site
*Budget data from OpenDataPhilly http://opendataphilly.org/

## Technical Details

<!-- Document key technical choices (e.g. Vanilla JS or Vue + Vite, Firebase/Firestore configuration, mapping libraries, external APIs, and instructions for running or deploying the project). -->
I plan to just use Vanilla JS, but want to explore Vite. I will not be using mapping libraries because I am not going to map any data as it is irrelevant to the goal of the tool. I will, instead, be using D3 to visualize and compare the various data sets. I'll be pulling data from OpenDataPhilly with an API.