HR Compliance Automation, weekly snapshot demo

Rendered from synthetic data by src/render_demo.py; the production version writes the same layout to Google Sheets weekly.

Source on GitHub · Case study · two venues, one code path, per-venue YAML config

11
Active employees
36%
Complete
3
Expiring in 30 days
2
Lapsed
7
Missing docs

Employees sheet, 2026-09-03 (14 columns, 7 Dropbox folders scanned)

Rows in red are what the Apps Script highlights: Days Until Expiry reads "<30", which covers expiring and lapsed certs. Complete is the evaluated sheet formula.

Employee NameDocs Present (folders)Docs MissingTABC ExpirationDays Until ExpiryTax FormID on FileSSN on FileComp Agreement SignedCompleteNeeds ReviewDate ScannedActiveNotes
Avery BlackwoodW4,TABC,ID,SSN,COMP,DD04/12/2028>30W-4YesYesYesYes2026-09-03
Dashiell PembertonTABCID, Tax (W-4/W-9)11/03/2025<30NoNoNoNoNoTABC EXPIRED 11/03/20252026-09-03
Ines FalconerW4,TABC,ID,COMP,DD10/04/2026>30W-4YesNoYesYes2026-09-03
Kai ThornburyW4,TABC,ID,SSN,COMP,DD10/03/2026<30W-4YesYesYesYes2026-09-03
Lucia MarchettiID,SSNTABC, Tax (W-4/W-9)Not FoundNoYesYesNoNo2026-09-03
Marisol ArriagaW4,TABC,ID,SSN09/18/2026<30W-4YesYesNoYes2026-09-03
Nadia OkonkwoW4,ID,SSN,DDTABCNot FoundW-4YesYesNoNo2026-09-03Cert renewal scheduled
Nico CastellanosW4,TABC,DDID09/25/2026<30W-4NoNoNoNo2026-09-03
Rowan WhitlockW4,TABCIDREVIEWW-4NoNoNoNoTABC scan is blurry; expiration unreadable2026-09-03
Simone DelacroixW4,DDTABC, IDNot FoundW-4NoNoNoNo2026-09-03
Theo VanderbiltW4,TABC,DDID07/10/2026<30W-4NoNoNoNoTABC EXPIRED 07/10/20262026-09-03
-- INACTIVE (Active=No) --
Ezra HollowayNoLeft in July

Run Log

Run DateFolders ScannedRows WrittenException CountRoster ChangesCompletion Status
2026-09-037 (W4, W9, TABC, ID, SSN, COMP, DD)14 (11 employees + 3 contractors)5BaselineComplete

Exceptions (5)

Employee / FolderIssue TypeDetailSource FileRun Date
Dashiell PembertonExpired documentTABC certificate expired 11/03/2025; no tax form or ID on fileTABC/pemberton_dashiell TABC.jpg2026-09-03
Theo VanderbiltExpired documentTABC certificate expired 07/10/2026TABC/theo vanderbilt tabc.png2026-09-03
Marisol ArriagaName variantW-4 filed as 'Marisol Arriaga-Reyes'; TABC cert prints 'Marisol Arriaga'. Treated as one person.W4/Arriaga-Reyes_Marisol W4.pdf + TABC/MARISOL ARRIAGA TABC.pdf2026-09-03
Rowan WhitlockSource qualityTABC is a low-resolution phone photo; expiration not legibleTABC/rowan tabc.jpeg2026-09-03
Moonlight Sound Co.Business entityW-9 filed under a business entity, not an individualW9/moonlight sound co w9.png2026-09-03

Contractors sheet

Contractor / EntityTypeW-9 on FileDocs Present (folders)Needs ReviewDate ScannedLast VerifiedNotes
Bram WinterbourneIndividualYesW92026-09-03
Moonlight Sound Co. (Felix Abernathy)Business entityYesW9W-9 filed under a business entity; verify vendor classification2026-09-03
Ophelia StarlingIndividualYesW9,DD2026-09-03

TABC alert drafts

urgent tier
Subject: URGENT: TABC certification(s) expired/expiring, immediate action required (Venue A)
Venue A TABC compliance check, run date 2026-09-03.

The following certifications are expired or expire within 15 days:

  - Dashiell Pemberton: EXPIRED 11/03/2025 (304 days ago)
  - Theo Vanderbilt: EXPIRED 07/10/2026 (55 days ago)
  - Marisol Arriaga: expires 09/18/2026 (15 days remaining)

A staff member may not serve alcohol on a lapsed TABC certification. Anyone listed as EXPIRED cannot serve until renewed.

This draft was prepared automatically from the weekly compliance snapshot. Review before sending.
warning tier
Subject: TABC expiration warning: certification(s) expiring within 30 days (Venue A)
Venue A TABC compliance check, run date 2026-09-03.

The following certifications expire within 30 days:

  - Nico Castellanos: expires 09/25/2026 (22 days remaining)
  - Kai Thornbury: expires 10/03/2026 (30 days remaining)

A staff member may not serve alcohol on a lapsed TABC certification. Anyone listed as EXPIRED cannot serve until renewed.

This draft was prepared automatically from the weekly compliance snapshot. Review before sending.

Recipients are not configured for this venue, so the scheduled task renders these but does not create Gmail drafts until they are.

11
Active employees
36%
Complete
3
Expiring in 30 days
2
Lapsed
8
Missing docs

Employees sheet, 2026-09-03 (15 columns, 8 Dropbox folders scanned)

Rows in red are what the Apps Script highlights: Days Until Expiry reads "<30", which covers expiring and lapsed certs. Complete is the evaluated sheet formula.

Employee NameDocs Present (folders)Docs MissingTABC ExpirationDays Until ExpiryTax FormID on FileSSN on W-4Handbook SignedPayment Terms SignedCompleteNeeds ReviewDate ScannedActiveNotes
Avery BlackwoodID,TABC,W4,DD,HANDBOOK,PAYTERMS04/12/2028>30W-4YesYesYesYesYes2026-09-03
Dashiell PembertonTABCID, Tax (W-4/W-9), DD11/03/2025<30NoNoNoNoNoNoTABC EXPIRED 11/03/20252026-09-03
Ines FalconerID,TABC,W4,DD,PAYTERMS10/04/2026>30W-4YesYesNoYesYes2026-09-03
Kai ThornburyID,TABC,W4,DD,HANDBOOK,PAYTERMS10/03/2026<30W-4YesYesYesYesYes2026-09-03
Lucia MarchettiIDTABC, Tax (W-4/W-9), DDNot FoundNoYesNoNoNoNo2026-09-03
Marisol ArriagaID,TABC,W4DD09/18/2026<30W-4YesYesNoNoYes2026-09-03
Nadia OkonkwoID,W4,DDTABCNot FoundW-4YesYesNoNoNo2026-09-03Cert renewal scheduled
Nico CastellanosTABC,W4,DDID09/25/2026<30W-4NoYesNoNoNo2026-09-03
Rowan WhitlockTABC,W4ID, DDREVIEWW-4NoYesNoNoNoTABC scan is blurry; expiration unreadable2026-09-03
Simone DelacroixW4,DD,HANDBOOKTABC, IDNot FoundW-4NoYesYesNoNo2026-09-03
Theo VanderbiltTABC,W4,DD,HANDBOOKID07/10/2026<30W-4NoYesYesNoNoTABC EXPIRED 07/10/20262026-09-03
-- INACTIVE (Active=No) --
Ezra HollowayNoLeft in July

Run Log

Run DateFolders ScannedRows WrittenException CountRoster ChangesCompletion Status
2026-09-038 (ID, TABC, W4, W9, DD, PAYCHECKS, HANDBOOK, PAYTERMS)14 (11 employees + 3 contractors)5BaselineComplete

Exceptions (5)

Employee / FolderIssue TypeDetailSource FileRun Date
Dashiell PembertonExpired documentTABC certificate expired 11/03/2025; no tax form or ID on fileTABC/pemberton_dashiell TABC.jpg2026-09-03
Theo VanderbiltExpired documentTABC certificate expired 07/10/2026TABC/theo vanderbilt tabc.png2026-09-03
Marisol ArriagaName variantW-4 filed as 'Marisol Arriaga-Reyes'; TABC cert prints 'Marisol Arriaga'. Treated as one person.W4/Arriaga-Reyes_Marisol W4.pdf + TABC/MARISOL ARRIAGA TABC.pdf2026-09-03
Rowan WhitlockSource qualityTABC is a low-resolution phone photo; expiration not legibleTABC/rowan tabc.jpeg2026-09-03
Moonlight Sound Co.Business entityW-9 filed under a business entity, not an individualW9/moonlight sound co w9.png2026-09-03

Contractors sheet

Contractor / EntityTypeW-9 on FileDocs Present (folders)Needs ReviewDate ScannedLast VerifiedNotes
Bram WinterbourneIndividualYesW92026-09-03
Moonlight Sound Co. (Felix Abernathy)Business entityYesW9W-9 filed under a business entity; verify vendor classification2026-09-03
Ophelia StarlingIndividualYesW9,DD2026-09-03

TABC alert drafts

urgent tier
Subject: URGENT: TABC certification(s) expired/expiring, immediate action required (Venue B)
Venue B TABC compliance check, run date 2026-09-03.

The following certifications are expired or expire within 15 days:

  - Dashiell Pemberton: EXPIRED 11/03/2025 (304 days ago)
  - Theo Vanderbilt: EXPIRED 07/10/2026 (55 days ago)
  - Marisol Arriaga: expires 09/18/2026 (15 days remaining)

A staff member may not serve alcohol on a lapsed TABC certification. Anyone listed as EXPIRED cannot serve until renewed.

This draft was prepared automatically from the weekly compliance snapshot. Review before sending.
warning tier
Subject: TABC expiration warning: certification(s) expiring within 30 days (Venue B)
Venue B TABC compliance check, run date 2026-09-03.

The following certifications expire within 30 days:

  - Nico Castellanos: expires 09/25/2026 (22 days remaining)
  - Kai Thornbury: expires 10/03/2026 (30 days remaining)

A staff member may not serve alcohol on a lapsed TABC certification. Anyone listed as EXPIRED cannot serve until renewed.

This draft was prepared automatically from the weekly compliance snapshot. Review before sending.