HR Flow ‐ Ver1 - magicplatforms/ai-workflows GitHub Wiki

Below are mermaid sequence diagrams for each stage of the Hire-to-Retire workflow. Each diagram is written using GitHub-compatible syntax.

1. Attract & Source

sequenceDiagram
    participant HRManager
    participant HRPlatform
    participant JobBoard
    participant AIEngine

    HRManager->>HRPlatform: Approve job requisition
    HRPlatform->>JobBoard: Auto-push posting
    HRPlatform->>AIEngine: Request job-description language, comp suggestions
    AIEngine-->>HRPlatform: Return suggested text and target compensation

2. Screen & Select

sequenceDiagram
    participant Candidate
    participant HRPlatform
    participant AIEngine
    participant HiringManager

    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

3. Offer & Hire

sequenceDiagram
    participant HRManager
    participant HRPlatform
    participant Candidate

    HRManager->>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

4. Onboard & Provision

sequenceDiagram
    participant HRPlatform
    participant NewHire
    participant ITSystem
    participant AIAssistant

    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

5. Core HR & Self-Service

sequenceDiagram
    participant Employee
    participant HRPlatform
    participant Manager

    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

6. Time, Scheduling & Attendance

sequenceDiagram
    participant Employee
    participant TimeSystem
    participant Manager
    participant HRPlatform

    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

7. Payroll & Benefits

sequenceDiagram
    participant HRPlatform
    participant PayrollSystem
    participant TaxAuthority
    participant Employee

    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

8. Develop & Engage

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

    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

9. Analytics & Insights

sequenceDiagram
    participant HRPlatform
    participant AnalyticsEngine
    participant Manager

    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

10. Changes, Compliance & Autonomy

sequenceDiagram
    participant Manager
    participant HRPlatform
    participant ActionAgent

    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

11. Offboarding

sequenceDiagram
    participant HRPlatform
    participant Employee
    participant ITSystem
    participant PayrollSystem
    participant AIEngine

    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

12. Year-End & Continuous Improvement

sequenceDiagram
    participant HRPlatform
    participant PayrollSystem
    participant TaxAuthority
    participant AnalyticsEngine
    participant HRManager

    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