UrbanTree Corp (UTC)

UrbanTree Corp (UTC) is an enterprise-grade Bio-Civic Command Center designed for Smart Cities. It provides a full-stack operating system to plan, audit, and monetize urban green cover using satellite telemetry and ground-truth validation.

System Overview

The platform serves as a digital infrastructure layer for Municipal Corporations, enabling:

• Biometric Asset Management: Tracking lifecycle, health (NDVI), and species distribution of urban flora.
• Carbon Ledger: Real-time calculation of sequestration metrics aligned with the Indian Carbon Market (ICM).
• Security & Compliance: Role-Based Access Control (RBAC) with mandated Time-based One-Time Password (TOTP) authentication.

Technical Architecture

The application is built on a modern, serverless stack designed for high availability and data integrity.

• Frontend: Next.js 16 (App Router) with React Server Components.
• Styling: Tailwind CSS for a utility-first, responsive design system.
• Authentication: Custom AuthService interfacing with Firebase Auth and otplib for cryptographic TOTP generation.
• Database: Cloud Firestore (NoSQL) for scalable user profiles and session logging.
• Visualization: Recharts for data-driven analytics.

Installation & Setup

Prerequisites

• Node.js v18.17.0 or higher
• npm v9.0.0 or higher
• A valid Firebase Project with Firestore and Auth enabled

Configuration

1. Clone the repository

   git clone [https://github.com/urbantree-corp/platform.git](https://github.com/urbantree-corp/platform.git)
   cd platform

2. Install dependencies

   npm ci

3. Environment Setup Create a src/lib/firebase.js file based on the provided architecture documentation. Ensure strict adherence to the API key injection process.

4. Execute Development Server

   npm run dev

   The application will broadcast on http://localhost:3000.

Security Protocols

This repository enforces strict security measures:

1. Session Termination: Automatic session invalidation occurs after 20 seconds of user inactivity.
2. MFA Enforcement: All employee accounts require Google Authenticator binding.
3. Audit Trails: All login events are immutable and logged to Firestore sessions collection.

Refer to SECURITY.md for vulnerability reporting procedures.

License

Copyright (c) 2026 UrbanTree Corp. Distributed under the MIT License. See LICENSE for details.