Federal Requirements Mapping

On this page

Overview

This document maps federal regulatory requirements to specific Canopy services and code locations. It serves as a traceability matrix for compliance audits and as a reference during implementation of new program rules.

All eligibility logic is implemented in JDM rulesets and jurisdiction.toml per ADR-003 — no federal regulation values are hardcoded in Rust code.

SNAP — 7 CFR Part 273

Eligibility Determination

Citation Requirement Implementation Service

7 CFR 273.2(i)

Expedited service: qualifying households processed within 7 calendar days

canopy-applications computes expedited screening (gross income < $150 AND assets ≤ $100 — the regulation’s asymmetric edges, #1150 — OR combined < rent, OR migrant with assets ≤ $100). Deadline date stored on application.

canopy-applications

7 CFR 273.8

Asset test: countable resources below $2,750 ($4,250 elderly/disabled)

Rules engine: snap-eligibility.json evaluates asset limits. Thresholds in rulesets/federal/snap-income-limits.json.

canopy-snap, canopy-rules

7 CFR 273.9

Income deductions: standard, 20% earned income, dependent care, medical (elderly/disabled), excess shelter/SUA

canopy-snap/determine.rs calls rules engine for each deduction category. SUA loaded from jurisdiction.toml [snap.deductions.sua].

canopy-snap, canopy-rules

7 CFR 273.10(a)(1)

Benefit proration for mid-month applications

canopy-enrollment computes (monthly_amount / days_in_month) * remaining_days.

canopy-enrollment

7 CFR 273.10(e)

Benefit allotment: max allotment minus 30% of net income

Rules engine: snap-allotment.json. Max allotment by household size in rulesets/federal/snap-allotments.json.

canopy-snap, canopy-rules

7 CFR 273.10(f)

Certification periods: 12 months standard, 24 months elderly/disabled

canopy-renewals stores certification type and computes end dates. Values in jurisdiction.toml [snap.certification].

canopy-renewals

Income Tests

Citation Requirement Implementation Service

7 CFR 273.9(a)

Gross income test: 130% FPL

Rules engine evaluates gross_monthly_income ⇐ fpl_130_percent. FPL thresholds in rulesets/federal/snap-income-limits.json.

canopy-snap, canopy-rules

7 CFR 273.9(b)

Net income test: 100% FPL (after deductions)

Rules engine evaluates net_monthly_income ⇐ fpl_100_percent. Elderly/disabled households exempt from gross test.

canopy-snap, canopy-rules

Verification and Reporting

Citation Requirement Implementation Service

7 USC §2025(e)

IEVS mandatory income verification against federal/state databases

canopy-verification IEVS adapter queries 4 sources (GA DOL SWR, GA DOL UI, SSA SDX, SSA BENDEX). Results stored in canopy-snap.ievs_match_results only (ADR-004).

canopy-verification, canopy-snap

7 CFR 272.11

FNS-388 monthly participation and issuance report

canopy-reporting/fns388.rs assembles from upstream services (persons, applications, enrollment, renewals, snap).

canopy-reporting

7 CFR Part 275

QC universe for FNS-7176 sampling

canopy-reporting/qc_universe.rs generates 24-column snapshot. CSV export at /v1/reporting/snap/qc-universe/{date}/csv.

canopy-reporting

Change Reporting and Renewals

Citation Requirement Implementation Service

7 CFR 273.12

Change reporting during certification period

canopy-renewals change report endpoint. If reported income exceeds 130% FPL gross limit (from rules engine), flags for redetermination.

canopy-renewals

7 CFR 273.12(a)(1)(ii)

Interim contact at certification midpoint

canopy-renewals computes interim contact due date. Background scheduler publishes interim_contact.due events.

canopy-renewals

7 CFR 273.14

Recertification process

canopy-renewals tracks certification end dates, publishes certification.renewal_due events, provides renewal queue.

canopy-renewals

Appeals and IPV

Citation Requirement Implementation Service

7 CFR 273.15

Fair hearing right within 90 days

canopy-appeals tracks 90-day deadline. trigger_clock_check() identifies approaching/overdue hearings.

canopy-appeals

7 CFR 273.15(k)

Continued benefits if appeal filed within 14 days of adverse action

Auto-granted at filing time. canopy-appeals compares filing date to adverse action date.

canopy-appeals

7 CFR 273.16

IPV disqualification process

Full IPV lifecycle: referral, ADH scheduling, notice, decision, waiver, disqualification. Penalty schedule: 12/24/permanent months.

canopy-appeals

7 CFR 273.16(b)

30-day advance notice before ADH hearing

The send_notice endpoint (PUT /v1/ipv/cases/{id}/send-notice) refuses to send (400) when the hearing is under [appeals].adh_notice_advance_days legal days away (jurisdiction timezone, #1485).

canopy-appeals

ABAWD and Special Situations

Citation Requirement Implementation Service

7 CFR 273.24

ABAWD work requirements: 80 hours/month, 3-month limit in 36-month window

canopy-snap/abawd_handler.rs records activity, checks threshold from jurisdiction.toml [snap.abawd.qualifying_hours_per_month]. Publishes warning at months 1-2, time_limit_reached at month 3.

canopy-snap

7 CFR 273.4

Alien eligibility: qualified aliens, 5-year bar exceptions, humanitarian categories

Rules engine: snap-alien-eligibility.json (12-rule decision table for 7 alien categories).

canopy-snap, canopy-rules

Benefit Issuance

Citation Requirement Implementation Service

7 USC §2016(h)(9)

Benefit expungement after 12 months of non-use

canopy-enrollment tracks issuance status. Expungement status tracked per issuance record.

canopy-enrollment

TANF — 45 CFR Part 261

Planned — see TANF Eligibility Plan. Issues #158-#167.

canopy-tanf is currently a stub service with FTI audit log migration only.

Medicaid/CHIP — 42 CFR Part 431

Planned — see Medicaid Eligibility Plan. Issues #175-#188.

canopy-medicaid is currently a stub service. MAGI and non-MAGI determination pathways, EE15 hierarchy, and CHIP determination are specified in the plan.

CAPS — 45 CFR Part 98

Planned — see CAPS Eligibility Plan. Issues #203-#210.

canopy-caps is currently a stub service.

WIC — 7 CFR Part 246

Planned — see WIC Eligibility Plan. Issues #211-#218.

canopy-wic is currently a stub service.

Cross-Program — Federal Data Protection

Citation Requirement Implementation Service

IRS Pub 1075

FTI protection: authorized access, audit trail, 7-year audit retention (Pub 1075 AU-11), encryption

FTI isolated to canopy-tanf/medicaid (ADR-004). fti_audit_log table. Event bus blocks 27 restricted fields. See ATO Readiness.

canopy-tanf, canopy-medicaid, canopy-mq

45 CFR §164.530(j)

HIPAA PHI audit log retention (6 years)

canopy-security archive management with configurable retention per data type.

canopy-security

ACA §1413

Single streamlined application for all programs

canopy-applications accepts multi-program applications in a single request.

canopy-applications

Edit this page · default