OutraqHQ Platform Documentation

OutraqHQ is an Autonomous Work Intelligence and Fair Performance SaaS platform designed to eliminate workplace bias, automate daily work telemetry, and deliver hands-free executive co-piloting.

60-Second Interactive Onboarding

To solve the "Blank Canvas Paradox", every new user is greeted with a 3-step interactive onboarding banner directly on their dashboard:

1. Step 1: Check In & Review Assigned Tasks: View your active task queue.
2. Step 2: Auto-Draft Your Work Log at 5:00 PM: Outy auto-populates your work log based on commits and completed cards.
3. Step 3: Meet AI Co-Pilot Outy: Ask Outy questions in plain English anytime via the bottom-right widget.

Non-Tech Department Support

OutraqHQ works seamlessly for organizations with zero GitHub repositories (e.g. Sales, HR, Marketing, Operations, Design):

• Criteria Auto-Scaling: In IncrementCalculator.php, non-tech designations return -1.0 for GitHub criteria. Their performance score is automatically rescaled 100% to Work Logs, Tasks, and Attendance.
• Department Work Modes: Department work mode can be configured to manual, github, or hybrid.

Zero-Touch 5:00 PM Work Telemetry

Every day at 5:00 PM IST, the automated safety net job (EmployeeSafetyNetJob.php) runs across all active employees:

Autonomous CEO Co-Pilot & 1-Click Magic Email Actions

The CEO receives a 30-second morning AI executive digest at 8:00 AM daily with cryptographically signed 1-click magic email action links:

// Example 1-Click Execution Link (Valid for 24 Hours)
http://127.0.0.1:8000/api/action/execute?token=eyJpdiI6...&action=approve_increments

CEOs can sign off on monthly salary increments or resolve blocker disputes in 1 tap directly from their email inbox without ever logging into the website!

Statistical Z-Score Fairness Engine

The Fairness Engine calculates objective monthly performance scores ($0-100$) using standard deviation normalization:

AI Agent Outy 3-Tier Architecture

Outy operates via a 3-tier architecture so it never returns blank or generic responses:

• Tier 1 (Instant DB & Knowledge Base): Direct SQL lookup for direct answers (salary, manager, direct reports, assets, timesheets).
• Tier 2 (Generative RAG AI): OpenAI GPT-4o / Ollama provider for complex analytical prompts.
• Tier 3 (RuleBased Safety Engine): Fallback regex intent classifier that guarantees a rich response if AI keys are missing or offline.

All-in-One Mini ERP Suite

OutraqHQ includes 4 integrated Mini ERP modules:

• Itemized Payroll (/payroll): Combines Base Salary + OutraqHQ calculated performance increment % into monthly statements.
• Expense Claims (/expenses): Submit expense receipts for 1-click HR/Manager approval.
• Asset Vault (/assets): Assign laptops & devices with automated offboarding return checklists.
• Shift Timesheets (/timesheets): Clock-in / clock-out tracking and shift rosters.

Cryptographic Fair Workplace Verification

Organizations can generate a cryptographically signed HMAC badge certifying unbiased performance reviews:

Public Verification URL: http://127.0.0.1:8000/verify-fairness/{token}

Displays your verified Fairness Index ($0-100\%$) and SHA256 audit signature to attract top global talent.

CEO & Executive Leadership Guide

As a CEO or Owner, OutraqHQ gives you zero-friction visibility without micromanagement:

• 30-Second Morning AI Digest: Read daily org health scores, top contributors, and unresolved cross-department blockers.
• 1-Click Magic Tokens: Approve monthly increment pools or resolve blocker disputes directly from email.
• CEO Command Center (/ceo-center): Simulate salary increment pools and view company-wide performance curves.

Manager & Team Lead Guide

Managers get automated contribution tracking and blocker management tools:

• Work Log Approvals: Review 5:00 PM auto-drafted work logs submitted by team members.
• Cross-Department Blockers: Resolve inter-department delays before they trigger friction alerts.
• Expense Approvals: Approve team expense claims with 1 click.

HR Officer Guide

HR Officers manage employee onboarding, payroll generation, and company hardware assets:

• Interactive Onboarding Checklist: Track new hire 3-step onboarding progress.
• Itemized Payroll Generation: Generate monthly salary slips combining base pay + increment percentage.
• Hardware Asset Vault: Assign laptops & monitor offboarding asset return checklists.

Employee Guide

Employees enjoy 100% zero manual friction and protected performance reviews:

• 5:00 PM Auto-Draft Logs: Simply review and tap 1-Click Approve on your auto-populated daily work log.
• Clock-In Timesheets: Clock in and out with 1 click.
• Protected Fairness Score: Your output is evaluated objectively by mathematical Z-score algorithms.

5-Hub Streamlined Navigation

Frequently Asked Questions

How does Outy auto-draft work logs without GitHub?

Outy inspects completed task cards, timesheet timestamps, and attendance activity to auto-populate work logs for non-tech departments.

Can CEOs approve monthly salary increments from mobile?

Yes! The CEO simply taps the 1-Click Magic Email Execution link in their 30-Second Morning AI Digest.