@sparkerp/plugin-sdk 0.1.0 → 1.1.0

package/bundle/docs/applications/hcm/compensation-equity.md

@@ -0,0 +1,36 @@
+---
+title: Equity & Stock
+audience: tenant
+---
+
+# Equity & Stock (HCM)
+
+This page documents the shipped **Equity/Stock** screen
+(`hcm-compensation`) — tracking equity/stock grants to employees. Not for
+plugin developers.
+
+## Creating a grant
+
+**Create Equity Grant** — pick the **Employee**, the **Compensation
+Cycle** it's under, and the **Equity Plan**. Set the **Instrument** type
+(e.g. RSU, stock option), **Grant Date**, and **Units Granted**, then the
+money side: **Grant Price**, **Exercise Price** (for options), and
+**Current Fair Value / Unit** — the grant's value and its current
+estimated value are both calculated from these, not manually entered.
+
+Vesting is its own set of fields: **Vesting Start**, **Vesting Period
+(Years)**, and **Cliff (Months)** — the cliff is the initial period before
+any units vest at all, common for a 1-year cliff on a 4-year vest.
+**Expiration Date** caps how long the grant (particularly an option) stays
+exercisable.
+
+## Tracking what's vested
+
+The grid shows Units Granted, Vested, and Unvested for every grant, plus
+its Instrument type and Status. The KPI row (Total Grants, Active Grants,
+Pending Approval, Fully Vested) gives you a quick read on how much of your
+equity program has actually vested out.
+
+## Related
+
+- [Bonus Plans & Incentive Plans](./compensation-bonus-incentive.md)

package/bundle/docs/applications/hcm/compensation-salary.md

@@ -0,0 +1,47 @@
+---
+title: Salary Planning, Salary Review & Merit Increase
+audience: tenant
+---
+
+# Salary Planning, Salary Review & Merit Increase (HCM)
+
+This page documents three shipped **Compensation** screens
+(`hcm-compensation`) covering the core process of changing what someone
+earns, each tied to a [Compensation Cycle](./compensation-cycles.md). Not
+for plugin developers.
+
+## Salary Planning
+
+Propose a salary change: pick the **Employee** and the **Compensation
+Cycle** it belongs to, set the **Increase Type**, and enter the **Manager
+Increase %**. The screen shows you the employee's current salary range
+(Min/Mid/Max) alongside what you're proposing, and calculates the
+**Final Increase %** and resulting new salary/compa-ratio for you — you
+don't have to do that math yourself. Set an **Effective Date** for when it
+should take effect.
+
+The KPI row (Total Entries, Draft, Approved, Finalized) tells you at a
+glance how much of your planning is actually done vs. still in draft.
+
+## Salary Review
+
+The formal review process. Pick the **Employee**, **Compensation Cycle**,
+and **Review Type**, and enter a **Recommended %** increase along with a
+written **Justification** — this isn't optional busywork, it's what your
+approvers see when deciding whether to approve the increase. This goes
+through a real multi-stage approval chain, tracked via the KPI row
+(Total Reviews, Submitted, Approved, Finalized).
+
+## Merit Increase
+
+A merit-based increase tied to the employee's actual **Performance
+Rating**. Enter the **Manager %** you're proposing and, if your tenant
+uses one, the **Matrix Recommendation %** (a suggested percentage based on
+rating + position in range) for comparison — plus a **Justification**.
+Goes through its own two-stage approval, tracked via KPIs (Total Merit
+Increases, Submitted, Approved, Finalized).
+
+## Related
+
+- [Compensation Cycles](./compensation-cycles.md)
+- [Compensation Dashboard & Reports](./compensation-analytics.md)

package/bundle/docs/applications/hcm/compliance-analytics.md

@@ -0,0 +1,25 @@
+---
+title: Compliance Dashboard & Reports
+audience: tenant
+---
+
+# Compliance Dashboard & Reports (HCM)
+
+This page documents two shipped **Compliance** analytics screens
+(`hcm-compliance`). Not for plugin developers.
+
+## Compliance Dashboard
+
+8 real KPI cards, one per compliance area: Statutory Rules Active, Labor
+Laws Active, Certifications Verified, Policies Acknowledged, Documents
+Active, Audits Completed, and Calendar Events Completed/Overdue — a
+single screen to check whether anything across your whole compliance
+program needs attention.
+
+## Compliance Reports
+
+A reporting view over the same real compliance data.
+
+## Related
+
+- [Audit Management & Compliance Calendar](./compliance-audits-calendar.md)

package/bundle/docs/applications/hcm/compliance-audits-calendar.md

@@ -0,0 +1,52 @@
+---
+title: Audit Management & Compliance Calendar
+audience: tenant
+---
+
+# Audit Management & Compliance Calendar (HCM)
+
+This page documents two shipped **Compliance** screens (`hcm-compliance`).
+Not for plugin developers.
+
+## Audit Management
+
+**New Audit** is organized into four sections:
+
+- **Audit Identity** — Audit Name, Audit Type (14 real types: Internal,
+  External, Compliance, HR, Payroll, Safety, Statutory, Regulatory, Labor
+  Law, Process, Document, System, Vendor, Follow-Up).
+- **Schedule** — Planned Start/End dates and the actual Audit Period.
+- **Scope & Rating** — Objective, Priority (Low/Medium/High/Critical),
+  Risk (Low/Medium/High/Critical), Organization, Country, Jurisdiction.
+- **Team** — Lead Auditor, Reviewer, Approver.
+
+An audit moves through a real 12-state lifecycle: Draft → Planned →
+Scheduled → In Progress → Fieldwork Completed → Report Draft → Under
+Review → Report Issued → Action Required (if findings need follow-up) →
+Follow-Up → Completed / Closed / Cancelled. The grid tracks Findings, Open
+Actions, and Risk directly, and the KPI row (Total Audits, Planned, In
+Progress, Completed, Open Actions, Critical Findings) gives you a
+program-wide read on how much is still outstanding.
+
+## Compliance Calendar
+
+**New Compliance Obligation** covers a wide range of deadline types (20
+real event types — Statutory Filing/Payment/Report, Tax Filing/Payment,
+License/Registration/Contract/Benefit Renewal, Certificate/Document
+Expiry, Medical Exam, Safety Inspection/Training, Audit, Policy/
+Compliance Review, Labor Law Deadline, Employee Notification, Declaration,
+or Other). Each obligation records its **Source** — where it came from:
+Manual entry, or auto-derived from a Labor Law, Statutory Rule, Tax Rule,
+License, Registration, or Policy (system-generated ones trace back to the
+actual rule that created them, not a plain manual note). Set a Due Date,
+Priority, Risk, Owner, Reviewer, and Organization/Location.
+
+The grid tracks Due Date, Type, Priority, Risk, and Status; the KPI row
+(Total Obligations, Upcoming, Overdue, Completed, Critical, Scheduled)
+makes overdue and critical obligations visible at a glance rather than
+buried in a long list.
+
+## Related
+
+- [Statutory Rules & Labor Law](./compliance-regulatory.md)
+- [Compliance Dashboard & Reports](./compliance-analytics.md)

package/bundle/docs/applications/hcm/compliance-employee-tracking.md

@@ -0,0 +1,41 @@
+---
+title: Certifications, Policy Acknowledgement & Compliance Documents
+audience: tenant
+---
+
+# Certifications, Policy Acknowledgement & Compliance Documents (HCM)
+
+This page documents three shipped **Compliance** screens (`hcm-compliance`)
+covering what's tracked per employee. Not for plugin developers.
+
+## Certifications
+
+**New Employee Certification** — Employee, Certification Name, Category,
+Country, Jurisdiction, Issuing Authority, Certificate Number, Issue Date,
+Expiry Date, and two checkboxes: **Mandatory** (is this required for the
+role) and **Renewal Required**. The grid separately tracks Status and
+Verification Status — a certification can be recorded but not yet
+verified. KPIs: Total, Verified, Pending Verification, Expired.
+
+## Policy Acknowledgement
+
+**New Policy Assignment** — Employee, Policy Code/Name, Policy Type,
+Version Number, Country, Due Date, and whether a **Signature Required**
+for acknowledgement (vs. just a click-through). Tracks Status and Version
+in the grid. KPIs: Total, Acknowledged, Pending, Declined.
+
+> **Note:** [HR Policies](./hr-policies.md) also has its own
+> Acknowledgements tab covering the same kind of tracking — if you're
+> looking for policy sign-off status, check both; this compliance-focused
+> screen and HR Policies' own tab may show overlapping data from different
+> angles.
+
+## Compliance Documents
+
+**New Compliance Document** — Document Name, Category, Country,
+Jurisdiction, Issue/Effective/Expiry Dates, and an Owner. KPIs: Total,
+Active, Pending Review, Expired.
+
+## Related
+
+- [Statutory Rules & Labor Law](./compliance-regulatory.md)

package/bundle/docs/applications/hcm/compliance-regulatory.md

@@ -0,0 +1,31 @@
+---
+title: Statutory Rules & Labor Law
+audience: tenant
+---
+
+# Statutory Rules & Labor Law (HCM)
+
+This page documents two shipped **Compliance** reference screens
+(`hcm-compliance`) — the regulatory rules your company operates under. Not
+for plugin developers.
+
+## Statutory Rules
+
+**New Statutory Rule** — Rule Code, Rule Name, Rule Type, Country,
+Jurisdiction, Scheme Name, a **Calculation Type** and **Rate Percent** for
+rules that involve a calculation (e.g. a statutory contribution rate),
+and Effective From/To dates. The grid tracks Country, Calculation Type,
+and Status through a real lifecycle: Draft → Pending Review → Approved →
+Scheduled → Active, with Suspended/Superseded/Expired/Archived/Repealed
+as end states. KPIs: Total, Active, Pending Review, Scheduled.
+
+## Labor Law
+
+**New Labor Law** — Law Code, Law Name, Short Name, Category, Country,
+Jurisdiction, Issuing Authority, an Official Reference (e.g. a citation),
+and Effective From/To. Same lifecycle-tracked Status column and KPI row
+shape (Total, Active, Pending Review, Expired) as Statutory Rules.
+
+## Related
+
+- [Audit Management & Compliance Calendar](./compliance-audits-calendar.md)

package/bundle/docs/applications/hcm/country-packs-admin.md

@@ -0,0 +1,33 @@
+---
+title: Country Pack Admin — Packs Overview, Pack Detail & Rule Builder
+audience: tenant
+---
+
+# Country Pack Admin — Packs Overview, Pack Detail & Rule Builder (HCM)
+
+This page documents three shipped screens in **`hcm-country-pack-core`**
+— the shared admin framework every individual [Country Pack](./country-packs.md)
+plugs into. Not for plugin developers.
+
+## Packs Overview
+
+A browsable list of every country pack — separate from, and more
+detailed than, the simple activate/retire list on
+[HR Settings → Country Configuration](./hr-settings.md#country-configuration).
+
+## Pack Detail
+
+Drill into one country's pack for a fuller view of what it contains.
+
+## Rule Builder
+
+A basic, form-based editor for cross-entity statutory rules. This is a
+deliberately scoped-down tool — not a full visual WHEN/THEN rule
+designer, just a straightforward form for editing the kind of rule rows
+[Country Packs](./country-packs.md) documents (PF/ESI rates, leave rules,
+labor law rules, and so on).
+
+## Related
+
+- [Country Packs](./country-packs.md)
+- [Compliance Dashboard, Statutory Registrations & Holiday Calendar](./country-packs-compliance.md)

package/bundle/docs/applications/hcm/country-packs-compliance.md

@@ -0,0 +1,31 @@
+---
+title: Country Pack Compliance Dashboard, Statutory Registrations & Holiday Calendar
+audience: tenant
+---
+
+# Country Pack Compliance Dashboard, Statutory Registrations & Holiday Calendar (HCM)
+
+This page documents three shipped screens in **`hcm-country-pack-core`**.
+Not for plugin developers.
+
+## Compliance Dashboard
+
+A cross-country compliance overview, pulling together your active packs'
+own compliance status in one view.
+
+## Statutory Registrations
+
+Track your company's real statutory registrations per country (e.g. a
+tax registration number, a social-security employer ID).
+
+## Holiday Calendar
+
+A country-pack-aware view of holidays — distinct from the main
+[Holiday Calendar](./holiday-calendar.md) in HR Settings, this one is
+scoped to what each active country pack itself defines as statutory
+holidays.
+
+## Related
+
+- [Country Packs](./country-packs.md)
+- [Master Data Formats, FX Rates & Employee Country Documents](./country-packs-localization.md)

package/bundle/docs/applications/hcm/country-packs-localization.md

@@ -0,0 +1,37 @@
+---
+title: Master Data Formats, FX Rates & Employee Country Documents
+audience: tenant
+---
+
+# Master Data Formats, FX Rates & Employee Country Documents (HCM)
+
+This page documents three shipped screens in **`hcm-country-pack-core`**.
+Not for plugin developers.
+
+## Master Data Localization Formats
+
+A read-only reference catalog of country-specific formatting
+conventions: how many address lines a country expects, what its
+state/province and postal code fields are called, name order (given name
+first vs. family name first), and similar formatting rules — useful when
+you're wondering why a form looks different for employees in different
+countries.
+
+## FX Rate & Currency Conversion
+
+A foreign-exchange rate reference table, plus your tenant's base currency
+setting. **Important:** these are manually-seeded snapshot rates, not a
+live market-data feed — don't rely on this for real-time currency
+conversion; treat it as a reference point, and update it yourself when
+rates need to change.
+
+## Employee Country Documents
+
+Per-employee tracking of country-specific document instances — work
+permits, visas, employment passes — with real expiry-date tracking, so
+you can see what's coming due.
+
+## Related
+
+- [Country Packs](./country-packs.md)
+- [Employee Profile](./employee-profile.md)

package/bundle/docs/applications/hcm/country-packs.md

@@ -0,0 +1,102 @@
+---
+title: Country Packs
+audience: tenant
+---
+
+# Country Packs (HCM)
+
+This page documents the shipped **Country Pack** framework — 44 country
+packs (India, USA, UK, Germany, Japan, Australia, and 38 more), all built
+on the exact same real, shared structure. Not for plugin developers.
+
+**Who this is for:** HR/payroll admins operating in a specific country
+who need that country's real statutory rates, tax slabs, and leave/labor
+rules reflected in HCM.
+
+## How Country Packs work
+
+A Country Pack is a reference-data library for one country — it doesn't
+add new screens with new behavior; it adds real statutory rows that the
+rest of HCM ([Payroll](./payroll-setup.md), [Leave](./leave-setup.md),
+[Compliance](./compliance-regulatory.md)) reads from.
+
+**Activating a pack:** go to [HR Settings → Country Configuration](./hr-settings.md#country-configuration),
+find the country, and **Activate** it — once active, its rules become
+visible and usable across the rest of HCM. Only packs your tenant has
+actually installed show up there; this isn't a general "pick any country
+in the world" list.
+
+## What every pack actually contains
+
+The same set of statutory-rule screens repeats, country by country — the
+field names below are real (taken directly from India's own pack, the
+most complete one, and consistent across every other pack that ships the
+same screen type):
+
+- **PF/Provident Fund Rules** (where applicable) — Scheme Code, Employee
+  Rate %, Employer Rate %, Wage Ceiling, and an Effective From/To date
+  range — so a rate change over time is tracked, not overwritten.
+- **ESI/Social Security Rules** — Employee Rate %, Employer Rate %, Wage
+  Threshold, Effective From/To.
+- **Professional/Regional Tax Rules** — State/Region, Salary Band Min/Max,
+  Monthly Tax Amount, Effective From/To (for countries with sub-national
+  tax variation).
+- **Tax Slabs** — real tax regime and bracket definitions (Tax Year,
+  Standard Deduction, ordered slabs), read directly by
+  [Tax Management](./payroll-tax.md) in Payroll — not a separate,
+  disconnected copy.
+- **Gratuity/Bonus Rules** — Rule Type, Formula Description, Rate or
+  Formula, Minimum Service Years, a Cap Amount, Effective From/To.
+- **Leave Rules** — Leave Type, Eligibility Condition, Entitlement Days,
+  Accrual Method, Carry Forward Rule, Effective From/To — the statutory
+  minimums this country requires, which [Leave Policies](./leave-setup.md)
+  can be built against.
+- **Labor Law Rules** — State/Region, Rule Code/Name, Category,
+  Description, Effective From/To — real regulatory requirements, browsable
+  and filterable, feeding [Statutory Rules & Labor Law](./compliance-regulatory.md).
+- **Termination Notice / Retrenchment Rules** and **Garnishment / Wage
+  Attachment Rules** — statutory requirements around ending employment and
+  court-ordered salary deductions, where applicable.
+- **Working Calendar Rules**, **Statutory Form Definitions**, **Statutory
+  Returns**, **Employee Document Types**, and **Payroll Integration
+  Definitions** — supporting reference data each pack ships so the rest of
+  HCM knows what forms, documents, and filings apply in that country.
+
+Every rule row carries **Source Year** and an **Effective From/To** date
+range — this is real, versioned reference data, not a static snapshot; a
+rate change is added as a new row with its own effective dates, never
+overwriting history.
+
+## Why this page doesn't list each country separately
+
+Every one of the 44 packs (Australia, Austria, Belgium, Canada, China,
+Denmark, Finland, France, Germany, Hong Kong, India, Indonesia, Ireland,
+Italy, Japan, Malaysia, Netherlands, Norway, New Zealand, Philippines,
+Poland, Portugal, Saudi Arabia, Singapore, South Korea, Spain, Sweden,
+Switzerland, Taiwan, Thailand, UAE, UK, USA, Vietnam, and more) ships this
+exact same screen structure — only the actual rates, thresholds, and
+rules inside them differ, country by country. Writing 44 nearly-identical
+pages, each just restating this same structure with a different country
+name, wouldn't tell you anything this page hasn't already — the real
+content that matters is the *actual current rates and rules*, which
+belong in your own tenant's live data (via each pack's own screens once
+activated), not frozen into a documentation page that would go stale the
+moment a real rate changes.
+
+## Known gaps
+
+- **Not every pack ships every screen** — a country with no PF-equivalent
+  system, for example, simply won't have a PF Rules screen. Which
+  screens exist for your country is determined by what's actually
+  relevant there.
+- **These are reference-data screens, not an editor for your own
+  statutory positions** — the shipped rules reflect the pack's own
+  published rates; if your company needs a genuinely custom variation,
+  check with your implementation team rather than editing pack data
+  directly.
+
+## Related
+
+- [HR Settings](./hr-settings.md)
+- [Payroll Dashboard, Reports & Country Rollup](./payroll-analytics.md)
+- [Statutory Rules & Labor Law](./compliance-regulatory.md)

package/bundle/docs/applications/hcm/dashboard.md

@@ -0,0 +1,38 @@
+---
+title: HCM Dashboard
+audience: tenant
+---
+
+# HCM Dashboard (HCM)
+
+This page documents the shipped **HCM Dashboard** (`hcm-foundation`) — the
+landing page when you open HCM. Not for plugin developers.
+
+**Who this is for:** anyone with access to HCM — it's the home screen.
+
+## Getting there
+
+`/app/hcm/home/dashboard` — the first thing you see opening HCM.
+
+## What's on it
+
+Every number and chart on this dashboard is real, live data for your
+tenant — none of it is a placeholder:
+
+- **Total Headcount**, **Present Today**, **On Leave**, **Open Positions**,
+  and **Attrition** KPI tiles, each with a small trend sparkline.
+- An **Employee Distribution** donut, broken down by department.
+- An **Attendance** gauge for today.
+- A **Leave Balance** list of upcoming approved leave.
+- A **Birthdays** / **Anniversaries** list, for the current month.
+- A **Recruitment** funnel, showing how many candidates are in each hiring
+  stage.
+- A short **Recommendations** list — real signals worth your attention
+  (e.g. from attrition-risk data), not AI-generated text.
+
+## Known gaps
+
+- The three trend sparklines (headcount, open positions, attrition) only
+  have a few days of real history right after this feature ships for a new
+  tenant — they fill in over time as daily data accumulates, so don't
+  expect a full trend line on day one.

package/bundle/docs/applications/hcm/designations.md

@@ -0,0 +1,32 @@
+---
+title: Designations
+audience: tenant
+---
+
+# Designations (HCM)
+
+This page documents the shipped **Designations** screen
+(`hcm-organization`) — the job titles employees actually hold. Not for
+plugin developers.
+
+## What you see
+
+- **KPI cards**: Total Designations, Active Designations, Employees
+  Using, Without Grade (a quick way to spot designations missing a grade
+  assignment).
+- **Search**, plus filters for Grade, Job Family, and Status (Active /
+  Inactive / All).
+- A grid: Designation Name, Job Family, Grade, Career Level, Positions
+  Using, Status, Actions.
+
+## Creating or editing a designation
+
+The form is organized into sections: **General** (Designation Name, Short
+Name, Designation Code), **Organization** (Company / Business Unit),
+**Job Structure** (Job Family, Grade, Career Level, Designation Level),
+**Hierarchy** (Parent Designation), **Lifecycle** (Effective From/To,
+Status), and **Description**.
+
+## Related
+
+- [Job Classifications, Job Families, Job Levels & Job Grades](./job-classifications.md)

package/bundle/docs/applications/hcm/emp-documents-analytics.md

@@ -0,0 +1,27 @@
+---
+title: Document Dashboard, Reports & Expiry
+audience: tenant
+---
+
+# Document Dashboard, Reports & Expiry (HCM Employee Documents)
+
+This page documents three shipped analytics screens in the
+**`hcm-employee-documents`** module. Not for plugin developers.
+
+## Document Dashboard
+
+9 real KPI cards across every document type and status in this module.
+
+## Document Reports
+
+A KPI summary plus a Documents-by-Status chart.
+
+## Document Expiry
+
+Every document approaching or past its expiry date, with a real **Start
+Renewal** action that raises a [Document Request](./emp-documents-workflow.md)
+directly from here rather than requiring a separate manual step.
+
+## Related
+
+- [Employee Documents & Document Types](./emp-documents-core.md)

package/bundle/docs/applications/hcm/emp-documents-core.md

@@ -0,0 +1,33 @@
+---
+title: Employee Documents & Document Types
+audience: tenant
+---
+
+# Employee Documents & Document Types (HCM Employee Documents)
+
+This page documents two shipped screens in the **`hcm-employee-documents`**
+module — a separate, more comprehensive document system from both
+[Employee Documents](./employee-documents.md) (in `hcm-employee`) and the
+[Document Management](./employee-info-documents.md) screen (in
+`hcm-employee-information`). Not for plugin developers.
+
+> **Three document screens exist across three modules.** This one is the
+> most complete — real DMS-backed upload, verification lifecycle, letter
+> generation, digital signatures, and expiry tracking. If your company
+> uses document management heavily, this is the module to standardize on.
+
+## Employee Documents
+
+The core per-employee document record — real upload (through the
+platform's own document storage), with a real verification lifecycle, not
+just a file listing.
+
+## Document Types
+
+Master data: define the document types your company tracks, each with
+its own simple administrative status.
+
+## Related
+
+- [Document Templates, Requests & Verification Lookup](./emp-documents-workflow.md)
+- [Offer, Salary, Experience Letters, Certificates & Contracts](./emp-documents-letters.md)

package/bundle/docs/applications/hcm/emp-documents-letters.md

@@ -0,0 +1,40 @@
+---
+title: Offer, Salary, Experience Letters, Certificates & Contracts
+audience: tenant
+---
+
+# Offer, Salary, Experience Letters, Certificates & Contracts (HCM Employee Documents)
+
+This page documents five shipped **document generation** screens in the
+**`hcm-employee-documents`** module — each generates a real document for
+an existing employee, gated by its own real approval before it's issued.
+Not for plugin developers.
+
+## Offer Letters
+
+Offer/appointment-style letters for an existing employee — internal
+transfer, promotion, rehire, or revised terms (not a new hire's original
+offer, which belongs to Recruitment).
+
+## Salary Letters
+
+Salary Certificates, Revision Letters, Bank Certificates, and CTC
+Letters.
+
+## Experience Letters
+
+Experience Certificates, Relieving Letters, and Service Letters.
+
+## Certificates
+
+General-purpose HR certificates — Employment, Service, Training,
+Appreciation, Promotion, Transfer, No-Objection Certificates, and more.
+
+## Contracts
+
+Employment contracts, with a full real lifecycle: Draft → Pending
+Approval → Approved → Generated → Active → Revoked.
+
+## Related
+
+- [Digital Signatures & Signature Providers](./emp-documents-signatures.md)

package/bundle/docs/applications/hcm/emp-documents-signatures.md

@@ -0,0 +1,24 @@
+---
+title: Digital Signatures & Signature Providers
+audience: tenant
+---
+
+# Digital Signatures & Signature Providers (HCM Employee Documents)
+
+This page documents two shipped screens in the **`hcm-employee-documents`**
+module. Not for plugin developers.
+
+## Digital Signatures
+
+Request an electronic signature on any of this module's HR documents. A
+request only shows Completed once the real signature has actually come
+back — not the moment you send it.
+
+## Signature Providers
+
+An admin screen listing this module's own registered external signature
+provider connections.
+
+## Related
+
+- [Offer, Salary, Experience Letters, Certificates & Contracts](./emp-documents-letters.md)

package/bundle/docs/applications/hcm/emp-documents-workflow.md

@@ -0,0 +1,32 @@
+---
+title: Document Templates, Requests & Verification Lookup
+audience: tenant
+---
+
+# Document Templates, Requests & Verification Lookup (HCM Employee Documents)
+
+This page documents three shipped screens in the **`hcm-employee-documents`**
+module. Not for plugin developers.
+
+## Document Templates
+
+Reusable, merge-field HR document templates — the templates that Offer,
+Salary, and Experience Letters (and Certificates) are actually generated
+from.
+
+## Document Requests
+
+Request a specific document from an employee — either raised directly by
+HR, or automatically from [Document Expiry](./emp-documents-analytics.md)'s
+own "Start Renewal" action when something's about to lapse.
+
+## Document Verification Lookup
+
+A public-facing utility: verify a document's verification code (stamped
+only on genuinely issued PDFs) against the real underlying record — this
+is what lets a third party (e.g. a bank checking an experience letter) confirm
+a document is real without needing system access.
+
+## Related
+
+- [Employee Documents & Document Types](./emp-documents-core.md)