# Automation 6: Employment Equity Reporting Engine
## Pitch, Handover & Technical Blueprint

---

## 1. Pitch Strategy & Boardroom Key Selling Points

South African business owners and HR Managers dread the annual Employment Equity (EE) submission window (September to January). The process of manually calculating workforce demographics, mapping them to occupational levels, and generating the EEA2 and EEA4 reports is highly error-prone. 

Use these talking points to command a **R3,000-R5,000/month retainer**:

*   **The "Compliance Fine" Threat:** Non-compliance with the Employment Equity Act can result in fines ranging from R1.5 million to 10% of annual turnover. A R4,000/month system is an incredibly cheap insurance policy against catastrophic DoEL fines.
*   **The "EE Compliance Certificate" Blocker:** Since 2024, companies require an EE Compliance Certificate to do business with the state or large corporate supply chains. If the EEA2/EEA4 is not submitted on time, they lose the certificate and immediately lose revenue.
*   **"Invisible Deficits":** Most CEOs have no idea what their 5-year Sectoral Targets are until the HR manager scrambles to put a spreadsheet together in December. This dashboard provides a live, 365-day view of exactly where the company is under-represented, allowing for strategic hiring *before* the deadline.

---

## 2. South African Legal & Compliance Alignment

### Employment Equity Act (EEA) - Section 21 Reporting
*   **The Law:** Designated employers (50+ employees) must submit a report to the Director-General once every year (online deadline: 15 January).
*   **The Automation Solution:** The engine automatically pulls live payroll data, maps job titles to the statutory Occupational Levels (Top Management, Senior Management, etc.), and generates the exact grid required for the DoEL online portal.

### EEA4 Income Differentials
*   **The Law:** Employers must report on remuneration gaps between highest and lowest earners across race and gender to prove they are actively working to eliminate unfair discrimination.
*   **The Automation Solution:** The engine calculates these differentials automatically in the background, completely eliminating spreadsheet errors.

---

## 3. How the Automation Works (n8n Blueprint)

The backend is driven by `ee_workflow.json`, which acts as an aggressive, multi-channel compliance orchestrator.

1.  **The Countdown Trigger:** The cron job runs daily at 07:00, calculating the exact number of days left until 15 January.
2.  **The Data Completeness Check:** It queries the HRIS/Payroll database to find any employees who have blank Race, Gender, or Occupational Level fields.
3.  **The Multi-Channel Escalation:** 
    *   **90 Days:** Polite email to the HR Manager.
    *   **60 Days:** Warning alert posted in the EE Committee Slack channel.
    *   **30 Days:** Urgent WhatsApp to the HR Manager if targets are still missed.
    *   **7 Days:** Critical CEO WhatsApp Alert requiring immediate signature on the generated reports.

---

## 4. Implementation Steps for the Client

1.  **Install the Dashboard (`ee_dashboard.html`)**
    *   Host securely on the client's internal network or embed inside their existing HR intranet.
2.  **Map Occupational Levels**
    *   Conduct a one-time mapping exercise to link the client's internal Job Titles to the DoEL's 6 Occupational Levels.
3.  **Import n8n Workflow (`ee_workflow.json`)**
    *   Import the blueprint into the client's n8n instance.
    *   Connect the PostgreSQL node to their payroll database (e.g. Sage, SimplePay via API).
    *   Configure the Slack and Twilio/WhatsApp credentials.
4.  **Go Live**
    *   The system will immediately calculate current compliance against the Financial Services Sectoral Targets and highlight any deficits.