🏢 CompanyOS — Unified Company Management & Intelligence Platform

An interconnected digital operating system for organizations. Not another disconnected HR dashboard with 14 CRUD pages, but a living model of the company connecting People, Organization, Work, Resources, Time, Events, Audit History, and AI Intelligence.

---

🏛️ Core Architectural Highlights

1. Decoupled Org Engine:

   • Explicit separation of Position from Person.
   • Flexible organization hierarchy: Company ➔ Divisions ➔ Departments ➔ Teams ➔ Positions ➔ Employees.
   • Interactive organization tree with live budget, burn, capacity, and vacancy inspection.

2. Executive Command Center:

   • Real-time organizational vitals (247 Headcount, 38 Projects, 94% Attendance, 3.2% Turnover).
   • Attention Radar: Explainable anomaly alerts (Engineering capacity at 112%, Project Phoenix delayed 8 days, 3 critical vacancies, expiring contracts).

3. Operations & Cascading OKRs:

   • Company-level project oversight with Schedule, Budget, and Resource health indicators.
   • Cascading OKRs from Corporate Strategy ➔ Department Objective ➔ Team Milestone ➔ Employee Key Result.

4. Leave Engine & Real-Time Conflict Radar:

   • Multi-tier approval workflows.
   • Conflict Detection Engine: Validates leave requests in real-time against team minimum capacity and critical project delivery milestones before submission.
   • Project-attributed attendance time tracking.

5. Explainable AI Causal Root Cause Tracer & Simulation:

   • Algorithmic root-cause graph tracing why projects are delayed (e.g. Project Phoenix delay traced to backend capacity crunch, concurrent team leave, and a vacant Senior Architect position).
   • Workforce Simulation Sandbox: Interactive slider simulating organizational impact ("What if we hire N engineers?") with real-time capacity relief, delay reduction, and payroll delta calculations.
   • Domain-grounded natural language enterprise query assistant.

6. Immutable Audit & Activity Stream:

   • Event-driven architecture with asynchronous Domain Event Bus.
   • Immutable audit logs capturing WHO, WHAT, WHEN, WHERE, BEFORE, AFTER, WHY for complete historical organizational reconstruction.
   • Unified Global Command Search (Ctrl+K).

---

🚀 Quick Start Guide

Prerequisites

• Python 3.10+
• Node.js 18+

1. Backend (FastAPI + SQLAlchemy + SQLite / Postgres)

cd backend
pip install -r requirements.txt
python run.py

• Server runs on: http://localhost:8000
• Interactive Swagger API documentation: http://localhost:8000/docs

2. Frontend (React 18 + Vite + TypeScript + Tailwind CSS)

cd frontend
npm install
npm run dev

• UI available at: http://localhost:5173