## 🚀 How to Run the Project

### Method 1: Docker Compose (Recommended)

Make sure Docker is running on your system, then execute:

```bash

# Clone the repository

git clone https://github.com/your-username/AI-Digital-Product-Passport.git

cd AI-Digital-Product-Passport

# Start all backend, frontend, and database containers

docker compose up --build

```

Access Points:

- **Frontend App**: `http://localhost:5173` (or `http://localhost`)

- **Backend API Docs (Swagger)**: `http://localhost:8000/api/docs`

- **Public QR Passport Verification**: `http://localhost:5173/public/passport/1`

---

### Method 2: Manual Local Setup

#### 1. Backend Setup

```bash

cd backend

# Create & activate Python virtual environment

python -m venv venv

# Windows: venv\Scripts\activate | Mac/Linux: source venv/bin/activate

# Install dependencies

pip install -r requirements.txt

# Run database migrations

alembic upgrade head

# Start FastAPI dev server

uvicorn app.main:app --reload --port 8000

```

#### 2. Frontend Setup

```bash

cd frontend

# Install Node modules

npm install

# Start Vite dev server

npm run dev

```

---

## 🔑 Demo Account Credentials

| Role | Email | Password |

| :--- | :--- | :--- |

| **Admin** | `admin@tatatech.com` | `Admin123!` |

| **Customer** | `customer@tatatech.com` | `Customer123!` |

| **Service Engineer** | `engineer@tatatech.com` | `Engineer123!` |

Step 1: Launch the Application

Start the application using Docker Compose or by manually running the backend and frontend servers. Once the services are running, open the frontend application in your web browser.

Step 2: Login

Use one of the provided demo accounts to access the platform based on your role:

• Administrator
• Customer
• Service Engineer

Each role provides access to different modules and functionalities.

Step 3: Manage Digital Product Passports

Administrators and manufacturers can register new products by entering product details such as serial number, batch number, manufacturer information, and production details. The system automatically generates a unique Digital Product Passport (DPP) along with a QR code for each product.

Step 4: Track Product Lifecycle

View and update the complete lifecycle of each product, including manufacturing, quality inspection, warehousing, shipping, installation, maintenance, repair, and end-of-life recycling.

Step 5: AI Predictive Maintenance

Navigate to the AI dashboard to analyze product health. The system predicts:

• Remaining Useful Life (RUL)
• Failure Probability
• Anomaly Detection
• Preventive Maintenance Recommendations

Step 6: Digital Twin Monitoring

Open the Digital Twin module to monitor the virtual representation of each product. Users can simulate machine conditions such as temperature, vibration, runtime, and load to observe how these changes affect AI predictions in real time.

Step 7: Sustainability Dashboard

Access ESG analytics to monitor:

• Carbon Footprint
• Energy Consumption
• Recyclability Score
• Circular Economy Metrics
• Sustainability Performance

Step 8: AI Copilot

Use the AI Copilot to ask questions in natural language, such as:

• "Show products requiring maintenance."
• "Which products have the highest failure risk?"
• "Display warranty status for Product X."
• "Generate a sustainability summary."

The assistant retrieves information from the system and provides contextual responses.

Step 9: QR Code Verification

Scan or open the generated QR code to access the public Digital Product Passport. Authorized users can verify product authenticity and view lifecycle history, warranty information, maintenance records, and AI-generated insights.

Step 10: Reports & Analytics

Generate and export detailed reports in PDF format containing product details, AI predictions, lifecycle history, maintenance records, and sustainability analytics for business analysis and compliance purposes.

Hardware Requirements

Minimum

• Processor: Intel Core i3 (8th Gen) / AMD Ryzen 3 or equivalent
• RAM: 8 GB
• Storage: 10 GB free disk space
• Display: 1366 × 768 resolution
• Internet: Required for dependency installation and updates

Recommended

• Processor: Intel Core i5 (10th Gen) / AMD Ryzen 5 or higher
• RAM: 16 GB or more
• Storage: 20 GB SSD free space
• Graphics: Integrated GPU or higher (for smoother Digital Twin animations)
• Internet: High-speed broadband connection

Software Requirements

Operating System

• Windows 10/11 (64-bit)
• Ubuntu 20.04+ / Debian-based Linux
• macOS Monterey or later