Plan: Typst Document Generation Architecture

rulesets/{jurisdiction}/notices/
  manifest.toml                    # Template registry
  fonts/                           # Montserrat TTFs
  assets/                          # SVG logos
  components/                      # Shared Typst components
    orchard.typ                    # Design system constants
    letterhead.typ                 # Agency header with logo
    footer.typ                     # Form number + revision + page count
    hearing-rights.typ             # Fair hearing rights (parameterized)
    civil-rights.typ               # USDA nondiscrimination statement
    language-access.typ            # Language accessibility
    disability-access.typ          # ADA accommodation
    signature-block.typ            # Official signature area
    checkbox-grid.typ              # Yes/no and program selection
    data-table.typ                 # Repeating row tables
    field-row.typ                  # Label + blank fill-in line
  snap/                            # SNAP templates
    noa-approval.typ
    noa-denial.typ
    noa-termination.typ
    ...
  tanf/                            # TANF (future)
  medicaid/                        # Medicaid (future)

// snap/noa-approval.typ
#import "../components/orchard.typ": *
#import "../components/letterhead.typ": letterhead
#import "../components/hearing-rights.typ": hearing-rights
#import "../components/civil-rights.typ": civil-rights-statement
#import "../components/footer.typ": page-footer

#set text(font: body-font, fill: body-color, size: 11pt)
#set page(footer: page-footer(form-number, template-version))

#letterhead(agency-name, agency-address, agency-phone, notice-date,
            case-number, recipient-name, recipient-address)

#heading(level: 1)[NOTICE OF ACTION — SNAP BENEFITS APPROVED]

Your application for SNAP benefits has been approved.

#table(
  columns: (auto, auto),
  [*Monthly Benefit Amount:*], [$ #benefit-amount],
  [*Effective Date:*], [#effective-date],
  [*Certification Period:*], [#cert-start to #cert-end],
)

#hearing-rights(hearing-phone, hearing-address, 90, false, none, none)
#civil-rights-statement()

#let primary = rgb("#1e5146")
#let secondary = rgb("#2d7060")
#let accent = rgb("#ecbf44")
#let body-color = rgb("#38424b")
#let heading-color = rgb("#031018")
#let muted = rgb("#5f766b")
#let light-bg = rgb("#f3f7f5")
#let border-color = rgb("#c8d9cf")

#let body-font = "Montserrat"
#let heading-size = 16pt
#let body-size = 11pt
#let small-size = 9pt

[meta]
jurisdiction = "georgia"
schema_version = 1

[templates.snap.noa-approval]
version = "2026.1"
file = "snap/noa-approval.typ"
form_number = "DHS-297-A"
effective_date = 2026-04-01

// crates/canopy-typst/src/context.rs

pub struct TemplateRef {
    pub jurisdiction: String,
    pub program: Program,
    pub template_key: String,
    pub version: String,
    pub form_number: Option<String>,
}

pub struct NoticeContext {
    pub agency_name: String,
    pub agency_address: String,
    pub agency_phone: String,
    pub recipient_name: String,
    pub recipient_address: Address,
    pub case_number: String,
    pub notice_date: NaiveDate,
    pub form_number: String,
    pub template_version: String,
    pub locale: String,
    pub program_data: serde_json::Value,  // per-notice-type fields
    pub hearing_phone: String,
    pub hearing_address: Option<String>,
    pub appeal_deadline_days: i32,
    pub effective_date: Option<NaiveDate>,
    pub continued_benefits_available: bool,
    pub continued_benefits_deadline: Option<NaiveDate>,
}

pub struct RenderedNotice {
    pub pdf_bytes: Vec<u8>,
    pub template_ref: TemplateRef,
    pub page_count: u32,
}

// crates/canopy-typst/src/engine.rs

pub struct TypstEngine {
    render_tx: mpsc::Sender<RenderRequest>,
}

impl TypstEngine {
    pub fn new(rulesets_root: PathBuf, font_paths: Vec<PathBuf>) -> Self;
    pub async fn render(&self, template_ref: &TemplateRef,
                        context: &NoticeContext) -> Result<RenderedNotice, RenderError>;
}

CREATE TABLE notices (
    id UUID PRIMARY KEY,
    household_id UUID NOT NULL,
    recipient_person_id UUID NOT NULL,
    notice_type TEXT NOT NULL,
    program TEXT,
    application_id UUID,
    determination_id UUID,
    subject TEXT NOT NULL,
    template_key TEXT NOT NULL,
    template_version TEXT NOT NULL,
    form_number TEXT,
    locale TEXT NOT NULL DEFAULT 'en-US',
    regulatory_basis TEXT NOT NULL,
    effective_date DATE,
    notice_date DATE NOT NULL,
    advance_notice_days INTEGER,
    advance_notice_adjusted BOOLEAN NOT NULL DEFAULT false,
    pdf_storage_path TEXT,
    pdf_size_bytes BIGINT,
    page_count INTEGER,
    delivery_status TEXT NOT NULL DEFAULT 'pending',
    delivered_at TIMESTAMPTZ,
    delivery_channel TEXT DEFAULT 'test',
    created_at TIMESTAMPTZ NOT NULL DEFAULT now(),
    active BOOLEAN NOT NULL DEFAULT true
);

CREATE TABLE notice_appeals_rights (
    id UUID PRIMARY KEY,
    notice_id UUID NOT NULL REFERENCES notices(id),
    hearing_request_deadline DATE NOT NULL,
    continued_benefits_available BOOLEAN NOT NULL DEFAULT false,
    continued_benefits_request_deadline DATE,
    hearing_phone TEXT NOT NULL,
    hearing_address TEXT,
    created_at TIMESTAMPTZ NOT NULL DEFAULT now()
);

[notices]
hearing_phone = "1-877-423-4746"
hearing_address = "Office of State Administrative Hearings, 225 Peachtree Street NE, Suite 400, Atlanta, GA 30303"
appeal_deadline_days = 90
advance_notice_days = 14
agency_name = "Georgia Department of Human Services"
agency_address = "2 Peachtree Street NW, Suite 29-250, Atlanta, GA 30303"
agency_phone = "1-877-423-4746"
default_locale = "en-US"