HR V2 - magicplatforms/ai-workflows GitHub Wiki

Below are five consolidated Mermaid sequence diagrams. Each groups related stages of the Hire-to-Retire flow into a single diagram. They are written using GitHub-compatible syntax.

---

1. Recruitment (Attract & Source → Screen & Select → Offer & Hire)

sequenceDiagram
    participant HRManager
    participant HRPlatform
    participant JobBoard
    participant AIEngine
    participant Candidate
    participant HiringManager

    %% Attract & Source
    HRManager->>HRPlatform: Approve job requisition
    HRPlatform->>JobBoard: Auto-push posting
    HRPlatform->>AIEngine: Request job-desc language & comp suggestions
    AIEngine-->>HRPlatform: Return suggested text & target comp

    %% Screen & Select
    Candidate->>HRPlatform: Apply via branded portal
    HRPlatform->>AIEngine: Parse résumé
    AIEngine-->>HRPlatform: Return parsed data
    HiringManager->>HRPlatform: Submit interview feedback
    HRPlatform->>AIEngine: Auto-summarize notes & rank fit
    AIEngine-->>HRPlatform: Return summary & fit score

    %% Offer & Hire
    HiringManager->>HRPlatform: Generate offer letter from template
    HRPlatform->>Candidate: Send offer letter (e-sign)
    Candidate-->>HRPlatform: Return signed offer
    HRPlatform->>HRPlatform: Convert candidate record to employee profile

---

2. Onboarding & Core HR (Onboard & Provision → Core HR & Self-Service)

sequenceDiagram
    participant HRPlatform
    participant NewHire
    participant ITSystem
    participant AIAssistant
    participant Employee
    participant Manager

    %% Onboard & Provision
    HRPlatform->>HRPlatform: Trigger new-hire checklist
    HRPlatform->>NewHire: Request tax forms (W-4/I-9), direct-deposit, policy e-signatures
    NewHire-->>HRPlatform: Submit completed forms
    HRPlatform->>ITSystem: Create email/Slack account + ship laptop
    NewHire->>AIAssistant: "Where do I find my handbook?"
    AIAssistant-->>NewHire: Provide handbook link

    %% Core HR & Self-Service
    Employee->>HRPlatform: Update address/beneficiaries
    HRPlatform->>HRPlatform: Save updated personal data
    Manager->>HRPlatform: Submit job/comp change request
    HRPlatform->>Manager: Notify for approval
    Manager-->>HRPlatform: Approve change
    HRPlatform->>HRPlatform: Apply change to central profile

---

3. Workforce Operations (Time, Scheduling & Attendance → Payroll & Benefits)

sequenceDiagram
    participant Employee
    participant TimeSystem
    participant Manager
    participant HRPlatform
    participant PayrollSystem
    participant TaxAuthority

    %% Time, Scheduling & Attendance
    Employee->>TimeSystem: Clock in via web/mobile/physical punch
    TimeSystem->>TimeSystem: Record hours
    Employee->>HRPlatform: Submit PTO request
    HRPlatform->>Manager: Auto-route request
    Manager-->>HRPlatform: Approve PTO
    HRPlatform->>TimeSystem: Feed approved hours into payroll

    %% Payroll & Benefits
    HRPlatform->>PayrollSystem: Send hours & comp data
    PayrollSystem->>PayrollSystem: Calculate gross-to-net
    PayrollSystem->>TaxAuthority: File taxes automatically
    HRPlatform->>Employee: Launch benefits open-enrollment wizard
    Employee-->>HRPlatform: Select benefit plan
    HRPlatform->>PayrollSystem: Sync deductions for payroll

---

4. Development & Insights (Develop & Engage → Analytics & Insights)

sequenceDiagram
    participant Manager
    participant HRPlatform
    participant LearningSystem
    participant SurveySystem
    participant AIEngine
    participant HRTeam
    participant AnalyticsEngine

    %% Develop & Engage
    Manager->>HRPlatform: Add continuous feedback / 1-on-1 notes
    HRPlatform->>LearningSystem: Assign learning courses for goals
    SurveySystem->>HRPlatform: Capture sentiment from surveys/social feeds
    HRPlatform->>AIEngine: Analyze survey text (cluster themes)
    AIEngine-->>HRPlatform: Return key themes & alerts
    HRPlatform->>HRTeam: Notify HR of high-priority alerts

    %% Analytics & Insights
    HRPlatform->>AnalyticsEngine: Send hiring, turnover, comp, DEI data
    AnalyticsEngine->>AnalyticsEngine: Generate dashboards
    AnalyticsEngine->>Manager: Display hiring velocity, turnover, comp vs. market
    AnalyticsEngine->>Manager: Surface flight-risk employees
    AnalyticsEngine->>Manager: Recommend next-best actions

---

5. Lifecycle & Compliance (Changes, Compliance & Autonomy → Offboarding → Year-End & Continuous Improvement)

sequenceDiagram
    participant Manager
    participant HRPlatform
    participant ActionAgent
    participant ITSystem
    participant PayrollSystem
    participant Employee
    participant AIEngine
    participant TaxAuthority
    participant HRManager

    %% Changes, Compliance & Autonomy
    Manager->>HRPlatform: Submit promotion/transfer/LOA/separation form
    HRPlatform->>ActionAgent: Pre-fill data for form
    ActionAgent-->>HRPlatform: Return pre-filled data
    HRPlatform->>HRPlatform: Push updates system-wide

    %% Offboarding
    HRPlatform->>HRPlatform: Trigger exit checklist
    HRPlatform->>ITSystem: Deactivate accounts
    HRPlatform->>PayrollSystem: Process final pay
    HRPlatform->>Employee: Send COBRA notice
    HRPlatform->>HRPlatform: Launch exit survey
    HRPlatform->>AIEngine: Analyze exit text for attrition reasons
    AIEngine-->>HRPlatform: Return attrition insights

    %% Year-End & Continuous Improvement
    HRPlatform->>PayrollSystem: Generate W-2/1099 forms
    PayrollSystem->>TaxAuthority: File ACA/EEO reports
    HRPlatform->>HRPlatform: Reset performance & comp cycles
    HRPlatform->>AnalyticsEngine: Send usage metrics & benchmark scores
    AnalyticsEngine-->>HRManager: Provide optimization recommendations

---

Each diagram now covers multiple adjacent stages of the canonical “Hire-to-Retire” workflow, reducing the total count while preserving the core interactions.