ga-covid.thederf.com/README.md

# About

This site exists to provide a simplified, targeted view into information provided by the [Georgia Department of Health (DPH)](https://dph.georgia.gov/covid-19-daily-status-report) on the COVID-19 pandemic.

While the DPH provides an excellent range of datasets and visualizations, how to understand their utility and interpret them is left as an exercise to the reader.<br/>
Here I've attempted to provide explanations of the utility of certain statistics as well as provide some new visualizations not currently provided by the Department of Health dashboard.

## Disclaimer

The data provided on this site is based on information made available by the Georgia Department of Health at the time of reporting.
It may at times lack accuracy due to unreported, delayed, or improperly processed information.
Reporting time and quality for certain statistics may vary depending on the processes of individual organizations and jurisdictions.

This site is manually built from daily DPH reports. I will attempt to have new data incorporated by 5:00 PM on weekdays. Updates may be delayed due to personal circumstances.

**For case reports**, at-home rapid tests are not accounted for. Case numbers may be much higher than reported if [test positivity](https://ga-covid.thederf.com/overall/testing) is unusually high.

## The following additional reports are planned

- **What is the overall trend in vaccinations?** - [Data available here](https://experience.arcgis.com/experience/3d8eea39f5c1443db1743a4cb8948a9c) as XLSX, pending processing.
- **Who is most at risk by ethnicity and sex?** - Data available in daily reports, pending processing.
- **Who is most at risk by vaccination status?** - Weekly reports on breakthrough cases and deaths [are available here](https://dph.georgia.gov/covid-19-breakthrough-reports), but challenging to process.
- **How many hospital resources are available?** - [Data available here](https://www.arcgis.com/apps/opsdashboard/index.html#/47c1cee4d02542bea35bc3324d6cf5e3) but requires querying ArcGIS directly.
- **How many hospital patients have COVID?** - [Data available here](https://www.arcgis.com/apps/opsdashboard/index.html#/e40c39564f724af7bfe8fd5d88deadb6) but requires querying ArcGIS directly.

**Please note:** *This is a citizen science project and is not affiliated with or endorsed in any way by the State of Georgia.*

## Data Sources

- Georgia Department of Health, COVID-19 Daily Status Report - [https://ga-covid19.ondemand.sas.com/docs/ga_covid_data.zip](https://ga-covid19.ondemand.sas.com/docs/ga_covid_data.zip)
  - **Update Frequency** - The dataset above is updated each working day around 2:50 PM. I load it onto this site and rebuild shortly thereafter.
  - **Additional Data** - Some reports on this site may derive additional time-based information by comparing totals from multiple daily reports.
- David Eldersveld, TopoJSON Collection, Georgia Counties TopoJSON - [https://github.com/deldersveld/topojson/blob/master/countries/us-states/GA-13-georgia-counties.json](https://github.com/deldersveld/topojson/blob/master/countries/us-states/GA-13-georgia-counties.json)
  - Tweaked and used for rendering county maps.

## Developing

Feel free to build it yourself, take a look around, validate the reports, and [suggest improvements](#contact).<br/>
*Note, the code is still very much in the "make it work" stage, and has much room for being simplified, abstracted, and cleaned up. Ignore the fact that I'm using TypeScript as if it were un-typed JavaScript.*

### Stack

- [îles](https://iles-docs.netlify.app/) - Generates static pages from MDX files and Vue components, with optional component-level client-side hydration.
  - Excellent for getting a site built with a modern tech stack and minimal extraneous config. Still in beta with some rough edges, but I greatly enjoyed working with it.
- [Vue 3](https://v3.vuejs.org/) - Used for layout and client-side components such as charts.
- [JSCharting](https://jscharting.com/) - Used for charts. Straightforward to get up and running with, but provides a vast array of data visualization options.
- [TailwindCSS](https://tailwindcss.com/) - Because people keep telling me to try it. I get the appeal. It made style tweaking incredibly fast and fluid, but it definitely results in messy markup.

### Building & Running

1. Clone repository using [git](https://git-scm.com/)
  ```bash
  $ git clone https://git.thederf.com/thederf/ga-covid.thederf.com.git
  ```
2. Install dependencies using [npm](https://www.npmjs.com/) or your preferred [node.js](https://nodejs.org) package manager of choice.
  ```bash
  $ cd ga-covid.thederf.com/
  $ npm install
  ```
3. (Optional) Rebuild the data json files.
  ```bash
  npm run process:data
  ```
4. Run a local server for development
  ```bash
  npm run dev
  ```
5. Build static site
  ```bash
  npm run build
  ```

### File Tree

```txt
data/ - Scripts for comverting the raw CSV source files into browser-friendly JSON, removing extraneous data points, and segmenting data into separate files.
  - parser.js - Data parser entrypoint.
  parser/... - Scripts for producing json files for specific reports.
  raw/
    - YYYY-MM-DD.zip - Raw Georgia DPH datasets from the link above, by date downloaded.
      Including historical datasets allows for building time-series reports for data provided exclusively in daily counts.
  ...
public/ - Static assets.
  maps/ - GeoJSON map files for rendering maps.
  data/ - Generated JSON files prepared for browser loading by the parser above.
  ...
src/
  assets/ - CSS & Image assets processed by Vite
  components/ - Vue components for rendering client-interactive parts of the website.
    charts/ - Components that handle chart & chip rendering.
  layouts/ - Vue components for laying out the site. Primarily server-rendered.
  pages/ - MDX files for site pages.
  ...
...
```