🏭 FacilityOps AI Software

Version: 6.0 (Master Specification)
Tagline: The First Facility Software That Thinks Ahead.

FacilityOps is an AI-driven digital twin of an entire facility. It is designed specifically for facility management operations in healthcare facilities, commercial buildings, and industrial complexes. Built as a Progressive Web App (PWA), the system leverages modern web technologies, AI-driven automation, and multi-tenant architecture to provide end-to-end facility management capabilities.

---

🚀 Key Features

1. Total Visibility & The 3-Click Rule: Any action a non-technical user needs is reachable in three taps or fewer. The dashboard only highlights items needing immediate attention.
2. Infinite "Russian-Doll" Asset Hierarchy: Track assets with infinite nesting (e.g., Campus → Main Block → Floor 2 → Room 204 → ICU Cabinet → Cardiac Monitor).
3. Omniscient AI Brain: An onboard AI that monitors 100% of the facility's real-time state. It predicts failures, suggests root-cause analyses, and auto-drafts tickets.
4. Compliance Vault & Expiry Radar: A digital archive for compliance documents (Fire Safety, Bio-Medical Waste, etc.) that automatically fires alerts when renewals are due.
5. Offline-First PWA: Full offline capabilities for technicians in basements or remote areas. Changes are queued locally and synced silently when the network returns.

---

🛠️ Technical Architecture

• Frontend: Next.js 16 (App Router), React 19, TypeScript
• Styling: Tailwind CSS v4, Lucide React (Icons)
• Database / ORM: SQLite (via Prisma) for local development/prototyping
• PWA Support: @ducanh2912/next-pwa for Service Workers and background sync
• Charts/Analytics: Recharts

---

🔐 Mock Login Credentials

The application currently features a mock authentication UI for demonstration purposes. Since it is a prototype, any standard input will bypass the login screen and redirect to the dashboard.

For the sake of roleplay, you can use:

• Email: admin@facilityops.com
• Password: admin123

---

⚙️ Step-by-Step Installation Instructions

Follow these steps to run the software locally on your machine.

Prerequisites

1. Node.js (v18 or newer recommended)
2. npm (comes installed with Node.js)
3. Git

1. Clone the Repository

Open your terminal and run:

git clone https://github.com/keerthivinod/facility-operations-ai-software.git
cd facility-operations-ai-software

2. Install Dependencies

Install all the required Node.js packages:

npm install

3. Initialize the Database

The project uses Prisma with an SQLite database for simple local setup. Initialize the database schema by running:

npx prisma migrate dev --name init

Note: This will generate a local dev.db file and build the Prisma client.

4. Run the Development Server

Start the local Next.js development server:

npm run dev

5. Access the Application

Open your web browser and navigate to:

http://localhost:3000

You will land on the Dashboard. From there, you can explore the AI Brain, Compliance Vault, Assets (with nested hierarchies), Tickets, and more!

---

📱 PWA Installation (Optional)

Because this is a Progressive Web App, you can install it directly to your device:

• Desktop (Chrome/Edge): Click the "Install" icon in the right side of the address bar.
• Mobile (iOS/Safari): Tap "Share" and select "Add to Home Screen".
• Mobile (Android/Chrome): Tap the menu and select "Install app".

---

FacilityOps — Zero forgotten maintenance, zero compliance lapses.