Metadata-Version: 2.1
Name: docassemble.InterviewStats
Version: 0.5.0
Summary: A docassemble extension, to view stats from other interviews
Home-page: https://courtformsonline.org/about/
Author: Bryce Willey, Quinten Steenhuis
Author-email: bwilley@suffolk.com
License: The MIT License (MIT)
Description-Content-Type: text/markdown
License-File: LICENSE

# docassemble.InterviewStats

A docassemble interview that lets you view statistics from other saved interview responses. 

## Getting Started

1. Pull this package into your [docassemble playground](https://docassemble.org/docs/playground.html), or install it on your [docassemble server](https://docassemble.org/docs/packages.html).
1. To generate data that this interview can consume, use the [store_variables_snapshot()](https://docassemble.org/docs/functions.html#store_variables_snapshot) function in your interview, i.e.  `store_variables_snapshot(data={'zip': users[0].address.zip})`.
1. Once you have reached the `store_variables_snapshot` point in your target interview, start the stats interview.
  1. If you're in the playground, run the `stats.yml` interview.
  1. If you installed the package, go to the `/start/InterviewStats/stats/` URL to start the interview.
1. Select the target interview in the drop down. 
1. You can export the data in a Excel format by clicking the `Download` link on the stats page.

## Anonymous stats

If you would like to provide login-less access to stats for an interview
in your `dispatch` directive, you can do so as follows:

1. Add a directive in your configuration file, like this: 
```yaml
stats subscriptions:
  - cdc_moratorium: 12345abcedfg17821309
  - 209a: 4859123jkljsafdsf0913132
```

Where the value on the left corresponds to the key of an entry in your
`dispatch` directive, and the value on the right is an arbitrary password you
create. I recommend using something like https://onlinehashtools.com/generate-random-md5-hash
to create a random password to control access.

You can add as many unique passwords as you want for each entry you share.
This means you can distribute multiple links without sharing the password.

Then, someone can access the link to a specific interview's stats by 
visiting this url:

/start/InterviewStats/subscribe/?link=cdc_moratorium&auth=12345abcedfg17821309

They will be directed immediately to download an XlSX file containing the
statistics.

## Example

![Example Pic](static/example_pic.png)


## Roadmap

Currently, we can show simple grouping over all the data points in the interview stats. However, the
special visualization are only shown on based on the `zip` attribute. We're working to expand the
features available here in conjunction with our [EFiling Integration](https://github.com/SuffolkLITLab/EfileProxyServer).

If you have specific feature requests, feel free to open an issue or make a PR!


## Authors

* Quinten Steenhuis
* Bryce Willey

