Asap 178 accessibility audit local

[lkacenja]

We'd like to be able to use an accessibility checker on the ASAP app. It seems like directly using the Axe tools is more popular than PA11y these days. We should implement this and get a baseline status of the app.

This PR implements a scanner that must be run locally for now. I also added a rake task to help with creating document inference fixture data.

It felt increasingly weird to have the CI tools hanging out on the surface of the python_components directory, so I moved them into a "CI" folder.

Baseline Accessibility Results

Axe currently reports 22 violations. And 3 incomplete items. The incomplete items indicate places where the scanner could not determine results. For example the scanner cannot determine contrast ratio over a gradient background. These are worth considering because they may mask severe problems. I made a really simple hex to make the results more transparent.

Here is the raw JSON.
baseline_accessibility_scan.json

I will fix as many of these as I can in a follow up ticket. This dataset will give us something to compare against.

• What additional steps are required to test this branch locally?

Try running the scanner.

1. Reset the database: rails db:drop ; rails db:migrate ; rails db:setup
2. Make sure the app is running bin/dev
3. Run the shell script: python_components/accessibility_scan/scripts/local_accessibility_scan.sh
4. Enjoy the copious JSON.

• Are there any areas you would like extra review?

Just running the script.

• Are there any rake tasks to run on production?

No

[allisonmorgan]

This looks great and runs well locally! Thank you for making this happen. Just wanted to flag that I think the Hex dashboard is showing 25 violations, but the PR mentions (and when I run this locally), I see only 22 violations. Not a blocker to merging!

An FYI: You can add a total to tables in Hex; click "Totals" and choose the aggregation function for a cell in the new bottom row.

[lkacenja]

As usual, I should have been more clear on my wording. There are 22 violations and 3 incomplete items for a total of 25 items to investigate. The incomplete items are incidences where the scanner could not determine the status of one of its checks. Two of the three are color contrast ratio not being checked due to a gradient background. These still warrant exploration to me.

As far as the Hex goes, I mostly built it for myself to be able to track my progress. It's definitely not very fancy. I will keep working on it though. Thanks!