rubyforgood / rubyforgood/casa
Bug: court report .docx download is blocked with a "virus detected" warning in Edge on Windows
Nobody has claimed this yet.
- Dominant language
- Ruby
- Stars
- 381
- Forks
- 542
- Avg merge
- 3d 15h
- Merged PRs (30d)
- 47
Description
Reported by Voices for Children Montgomery in the 2026-08-07 stakeholder sync. Distinct from #7093 — see "Not the same bug as #7093" below.
Impacted User Types
- volunteers, case supervisors, and org staff at the reporting org — multiple people, not one machine
Environment
prod. Microsoft Edge on Windows. Downloading a generated court report .docx.
Current Behavior
Generating a court report succeeds, but the browser download is blocked with a "virus detected" warning. The user has to go into their antivirus software and tell it to ignore the detection to download anyway.
Stakeholder's words, from the sync:
Every time I download a report and other people download a report, it says viruses are detected. And then I have to go into like the virus detection software to say to ignore the virus and download anyway … which is kind of obnoxious and that's been happening for a while [approximately six months].
[!NOTE]
Screenshot pending. A redacted screenshot of the Edge warning was captured during the sync and will be attached to this issue.
Expected Behavior
The generated .docx downloads without any antivirus or SmartScreen warning.
Not the same bug as #7093
#7093 was "the file isn't in the correct format" when opening the report in Word, root-caused to zip64 (#7098, shipped 2026-08-06). This one fires earlier — at download time, in the browser, before Word is involved — and the stakeholder dates it to roughly six months, whereas the zip64 regression only started when the caxlsx bump floated us to rubyzip 3.x in April 2026.
That said, #7098 shipped the day before this was reported, so step one is re-testing: a structurally odd zip (version-needed 45, 0xFFFFFFFF size placeholders) is exactly the sort of thing antivirus heuristics dislike, so the fix may have taken this with it.
Leads, cheapest first
1. The download has no explicit filename — see #7099. CaseCourtReportsController#show (app/controllers/case_court_reports_controller.rb:22):
@casa_case.latest_court_report.open do |file|
# TODO test this .read being present, we've broken it twice now
send_data File.read(file.path), type: :docx, disposition: "attachment", status: :ok
end
There is no filename:, so the browser derives the download name from the URL path. #7093 produced a file named _C-15-JV-24-191.docx — leading underscore, not in the case number. A binary attachment with a browser-derived name, served from a Heroku app domain with no SmartScreen reputation, is a good match for the heuristic profile. Fixing #7099 (File.binread + explicit filename:) is the cheapest thing to try and is worth doing regardless.
2. Field codes left in the generated document. The org templates are full of Word MERGEFIELD … \* MERGEFORMAT field instructions — visible in the raw XML of default_report_template.docx, and heavily throughout montgomery_report_template.docx (the reporting org's own template). Sablon substitutes the «…» text but the surrounding field-code machinery stays in the package. A .docx carrying field codes is a classic malware-delivery shape (DDEAUTO / INCLUDEPICTURE), and Defender is aggressive about it. Hypothesis, not verified — worth checking whether the generated output retains field-code remnants, and whether a template stripped of MERGEFIELD instructions downloads cleanly.
3. Ruled out. Content-Type is registered correctly — config/initializers/mime_types.rb maps :docx to application/vnd.openxmlformats-officedocument.wordprocessingml.document, so this is not a mismatched-type warning. Byte-exactness was verified during #7093/#7099 (Content-Length correct, download byte-identical to the stored blob), so it is not truncation in transit.
Info still needed from the stakeholder
- Does it still happen now that #7098 has shipped (2026-08-06)?
- Which antivirus is producing the warning — Windows Defender, or a third-party product?
- Does Chrome or Firefox on the same machine warn too? (Separates the Edge/SmartScreen path from the AV engine itself.)
- Does it happen for every org template, or only Montgomery's?
How to Replicate
Not reproducible on macOS or Linux — needs Windows + Edge, and ideally the org's real template rather than the default one (real templates from #6601's comments: prince_george_report_template.docx, montgomery_report_template.docx).
- Sign in as
volunteer1@example.com/12345678on a Windows machine using Edge. - Open a case with at least one case contact → Generate court report → pick a date range → Generate report.
- Click the resulting download link.
- Observe the "virus detected" warning instead of a clean download.
How to access the QA site
Login Details:
Link to QA site
Login Emails:
- volunteer1@example.com view site as a volunteer
- supervisor1@example.com view site as a supervisor
- casa_admin1@example.com view site as an admin
- all_casa_admin1@example.com view site as an all casa admin
- go to
/all_casa_admins/sign_in
- go to
password for all users: 12345678
Questions? Join Slack!
We highly recommend that you join us in slack #casa channel to ask questions quickly. And discord for office hours (currently Tuesday 5-7pm Pacific), stakeholder news, and upcoming new issues.
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Research direction
Start by re-testing the generated court report after #7098 shipped, using Windows and Edge, then inspect app/controllers/case_court_reports_controller.rb:22 and the #7099 lead. Compare downloads from the default and Montgomery templates, checking whether field-code remnants remain. Done means the .docx downloads without an antivirus or SmartScreen warning and the responsible condition is identified.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- rails, ruby
- Domain
- backend
- Issue type
- Bug
- Difficulty
- 4/5
- Estimated time
- 3-5 days
- Activity status
- Quiet
- Clarity
- Mostly clear
- Newbie friendliness
- 45/100