Construction sites are complex, fast-moving environments where safety, workforce, equipment, progress, material usage, carbon impact, and reporting are often handled through disconnected tools.

Construction does not only need more dashboards — it needs an intelligent operating loop that turns signals into action.

CIVORA acts as a construction-site intelligence layer that combines operational visibility, AI-style recommendations, digital twin context, and measurable impact reporting into one polished PWA.

Scattered updates → Manual follow-up → Delayed response → Weak reporting

Site signal → Risk detection → AI recommendation → Human approval → Action → Impact report

CIVORA is designed for hackathon reliability, product clarity, and real-world construction relevance. It uses deterministic telemetry and local intelligence rules so the demo remains stable, fast, and offline-friendly.

CIVORA is an offline-ready AI command platform that helps construction teams detect risks, coordinate site operations, reduce carbon impact, and prove measurable outcomes — from one intelligent dashboard.

flowchart TD
    A[🏗️ Construction Site Signals] --> B[📡 Live Telemetry Engine]
    A --> C[👷 Workforce Inputs]
    A --> D[🦺 Safety Events]
    A --> E[🛠️ Asset Status]
    A --> F[🌱 Carbon and Material Data]

    B --> G[🧠 CIVORA Intelligence Layer]
    C --> G
    D --> G
    E --> G
    F --> G

    G --> H[⚠️ Risk Detection]
    G --> I[📈 Opportunity Detection]
    G --> J[🤖 Copilot Recommendation]

    H --> K[🧑‍💼 Human Supervisor Review]
    I --> K
    J --> K

    K --> L[✅ Approved Action]
    L --> M[📌 Site Execution]
    M --> N[📊 Measured Impact]
    N --> O[📄 Impact Report]

    O --> P[🏆 Stakeholder / Judge-Ready Evidence]

flowchart LR
    subgraph UI[🎨 Frontend Experience]
        A1[Command Center]
        A2[Digital Twin]
        A3[Safety]
        A4[Workforce]
        A5[Assets]
        A6[Carbon]
        A7[Reports]
        A8[Copilot]
    end

    subgraph Logic[🧠 Local Intelligence Layer]
        B1[Telemetry Simulator]
        B2[Rule-Based Risk Engine]
        B3[Recommendation Engine]
        B4[Impact Calculator]
        B5[Persistence Manager]
    end

    subgraph Storage[💾 Browser Runtime]
        C1[localStorage]
        C2[PWA Cache]
        C3[Offline Shell]
    end

    UI --> Logic
    Logic --> Storage
    Storage --> UI

CIVORA/
├── public/                  # Static assets and PWA files
├── src/
│   ├── components/          # Reusable UI components
│   ├── data/                # Demo telemetry and construction domain data
│   ├── hooks/               # Custom React hooks for state and behavior
│   ├── pages/                # Main product workspaces
│   ├── types/                # TypeScript domain models
│   ├── utils/                # Intelligence rules, helpers, calculations
│   └── tests/                # Vitest tests
├── package.json             # Scripts and dependencies
├── vite.config.ts           # Vite + PWA configuration
└── README.md                # Project documentation

CIVORA simulates construction site telemetry using deterministic updates. This creates a real-time product experience without depending on unstable external APIs.

sequenceDiagram
    participant Site as 🏗️ Site Simulator
    participant Telemetry as 📡 Telemetry Engine
    participant Risk as ⚠️ Risk Logic
    participant UI as 🧭 Dashboard UI
    participant Storage as 💾 localStorage

    Site->>Telemetry: Generate zone/workforce/asset signals
    Telemetry->>Risk: Evaluate site condition
    Risk->>UI: Send alerts, metrics, recommendations
    UI->>Storage: Save approved actions and state
    Storage->>UI: Restore state after refresh

The Copilot is designed as a local AI-style construction assistant for demo-safe guidance.

The current Copilot is rule-based for reliability. A production version can connect to guarded LLMs, RAG over site documents, BIM metadata, and real telemetry streams.

git clone https://github.com/sleader3221-dot/CIVORA.git
cd CIVORA

npm install

npm run dev

Open the local URL shown in terminal, usually:

http://localhost:5173

CIVORA is designed for construction environments where connectivity can be unstable.

CIVORA is not just a construction dashboard — it is a supervised intelligence loop that turns site signals into safer decisions, lower-carbon operations, and measurable impact.

Run tests using:

npm run test

Testing helps validate core UI behavior and improves confidence during fast hackathon iteration.

Build the project:

npm run build

Preview production build:

npm run preview

Deploy easily on:

Add screenshots inside a /screenshots folder and update the links below:

![Command Center](./screenshots/command-center.png)
![Digital Twin](./screenshots/digital-twin.png)
![Safety Intelligence](./screenshots/safety-intelligence.png)
![Carbon & Circularity](./screenshots/carbon-circularity.png)
![Impact Reports](./screenshots/impact-reports.png)

Recommended screenshot order for GitHub:

construction-tech
smart-construction
sustainability
safety-intelligence
digital-twin
carbon-intelligence
workforce-management
asset-management
pwa
react
typescript
vite
hackathon
impact-reporting

Karthik M A
GitHub: @sleader3221-dot

This project is currently intended for learning, demonstration, portfolio, and hackathon evaluation.