HrContract Docs

Introduction

HrContract developer kit overview

HrContract is a portable extract of the contract engine, Hovita Emzagar e-sign flow, and signature QR watermarks from performance-web — adapted for HR (per-person modal price/dates, no tariff variables).

What you get

  • Abstract VariableRegistry + pluggable providers
  • Template authoring with TinyMCE (create / edit)
  • Emzagar outbound + inbound routes (mock mode supported)
  • Post-sign QR watermarks on a rebuildable overlay PDF (signed-pdf-with-qr/)

Storage rule

Unsigned PDFs are ephemeral: generate from frozen contentHtml on download / Emzagar pull — no unsigned/ folder. Canonical signed/ is what Hovita gets next round. Never send the QR overlay to Emzagar/Hovita. There is no signed-pdf-first-backup/ — that write-once backup was removed once Hovita stopped receiving QR PDFs.

Quick start

pnpm install
pnpm db:push
pnpm db:seed
pnpm dev

Open /dashboard/templates/create to author a contract template.

Guides