> ## Documentation Index
> Fetch the complete documentation index at: https://docs.encoreos.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Job Description Agreements

> Manage job description agreements that require dual-signature acknowledgment from manager and employee.

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

| Concept                 | Meaning                                                                       |
| ----------------------- | ----------------------------------------------------------------------------- |
| Dual-signature workflow | Both manager and employee must sign for the agreement to reach Signed status. |
| Superseded              | A prior agreement version replaced by a newer one.                            |

## 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`.

| Term                            | Meaning in code                                                                                       |
| ------------------------------- | ----------------------------------------------------------------------------------------------------- |
| `JobDescriptionAgreementStatus` | `draft`, `pending_manager_signature`, `pending_employee_signature`, `signed`, `superseded`            |
| `content_snapshot`              | Stored snapshot of the job description content at time of agreement creation                          |
| `SignatureDialog`               | Platform-level component from `@/platform/signatures` supporting drawn, typed, or uploaded signatures |
| `pf_notifications`              | In-app notification records sent to manager and employee at key workflow transitions                  |

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

<Columns cols={2}>
  <Card title="Human Resources" icon="users" href="/hr/overview">
    Human Resources core overview.
  </Card>

  <Card title="Governance & parity" icon="scale-balanced" href="/governance/index" />
</Columns>

<Note>
  This page documents shipped product behavior. It is not medical, legal, or
  billing advice. Verify against your organization's policies and applicable
  regulations before using it for clinical, compliance, or billing decisions.
  Protected health information (PHI) shown in the product is governed by your
  tenant's access controls and is never exposed in this documentation.
</Note>

<Accordion title="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
</Accordion>