Handover workspace

ERS, Todo, OfferReview, and Docu in one view

Imported from live server docs, code structure, and deployment notes.

May 31, 2026, 11:17 AM

ERS

Offer Letter and Renewal System v0.3 — Complete Runnable Pack (Missing Endpoints + Seed + Minimal UI + Signature UI Spec)

**App Version:** 0.3.0 This file closes the gaps from v0.2 so you can run end-to-end. The only remaining “UI-heavy” part is signature placement (drag/drop) — backend is already ready.

docs/specs/ERS-v0.3-runnable-pack.md

Updated May 5, 2026, 9:14 AM

Offer Letter and Renewal System v0.3 — Complete Runnable Pack (Missing Endpoints + Seed + Minimal UI + Signature UI Spec)

App Version: 0.3.0
This file closes the gaps from v0.2 so you can run end-to-end. The only remaining “UI-heavy” part is signature placement (drag/drop) — backend is already ready.

Historical note:

  • Product name is now Offer Letter and Renewal System.
  • This runnable pack keeps the original ERS-v0.3 filename for traceability.

0) Update env

NEXT_PUBLIC_APP_VERSION="0.3.0"

1) Current Implementation Notes (updated)

These are the implemented deltas in the current project state:

  • System now supports both Renewal and New Hire case types.
  • New-hire cases skip manager justification and performance snapshot requirements.
  • CEO can approve and sign new-hire cases once the latest offer letter is present.
  • PDF signer supports drag-and-drop placement with fit-width A4 rendering.
  • pdf.js worker is configured client-side for stable preview rendering.
  • Multi-signature placement flow is supported across multiple pages.
  • Finalization submits all saved placements in one request.
  • Digital mark is stamped under each signature:
    • signed on: YYYY-MM-DD HH:mm UTC using Offer Letter and Renewal System
  • Signing is restricted to APPROVED cases only.
  • On successful signing:
    • case transitions to SIGNED
    • case is treated as closed/read-only
    • active HR users are notified (in-app + email outbox)