Job Description Agreements

The Job Description Agreements page, at route /hr/job-description-agreements, lists all job description agreements and supports creating new ones with a dual-signature workflow.

​

Overview

The list groups agreements by status: Draft, Awaiting Manager, Awaiting Employee, Signed, and Superseded. The status filter at the top narrows the grid. When no agreements exist at all, an empty state prompts you to create the first one. Selecting New Agreement opens a creation dialog. Each agreement card links to the detail page at /hr/job-description-agreements/:id.

​

Who it’s for

Access follows your organization’s role and module configuration. ## Before you start

• The job position or role description should be finalized before creating an agreement.
• Both the manager and the employee named in the agreement must have active user accounts.

​

Steps

1. Go to HR → Job Description Agreements.
2. Optionally filter by Status (Draft, Awaiting Manager, Awaiting Employee, Signed, Superseded).
3. Select an agreement card to open its detail page.
4. To create a new agreement, select New Agreement and complete the dialog.

​

Key concepts

​

Viewing an agreement

The Agreement Details page at /hr/job-description-agreements/:id manages the dual-signature lifecycle for a single job description agreement. Three tabs are presented: Overview (employee name, position title, manager, created date, and signature status for each party), Content (content snapshot of the job description), and Signature (signature workflow with actionable sign buttons). Status lifecycle: draft → pending_manager_signature → pending_employee_signature → signed. Submitting for signature triggers an in-app notification to the manager. After both parties sign, a PDF is generated and a notification is sent to the employee at /hr/me/documents. Before you start: the agreement must have been created from the list; correct personnel must be available to sign (manager first, then employee).

1. From the Job Description Agreements list, select an agreement card to open its detail page.
2. Review the Overview tab: confirm employee, position, manager details, and signature status.
3. From draft status, click Submit for Signature — an in-app notification is sent to the manager.
4. When status is pending_manager_signature, click Sign as Manager, complete the SignatureDialog, and confirm.
5. When status is pending_employee_signature, click Sign as Employee, complete the signature dialog; a PDF is generated after this step.
6. After both signatures, click Download PDF to retrieve the signed document from storage.

​

Related

Documentation sources

• src/routes/hr.tsx
• src/cores/hr/pages/JobDescriptionAgreementsPage.tsx
• src/cores/hr/pages/JobDescriptionAgreementDetailPage.tsx
• src/cores/hr/hooks/job-descriptions/useJobDescriptionAgreements.ts
• src/cores/hr/hooks/job-descriptions/index.ts
• src/cores/hr/components/job-descriptions/AgreementCard.tsx
• src/platform/signatures/index.ts