🏛️ CampusCare

🏛️ CampusCare

Smart Campus Infrastructure with Real-Time Heatmaps, AI Insights & Community Rewards

🌟 Built with Firebase, Gemini AI & Modern Web Technologies 🌟

📋 Table of Contents

The Problem
Our Solution
Technology Stack
Core Features
System Architecture
Getting Started
Deployment
Contributing

🎯 The Problem

Campus infrastructure breaks down. A lot. And when it does, the response is almost always reactive rather than preventive:

The Reality:

💧 Water leaks in the same spots, semester after semester
⚡ Power outages disrupt classes without warning
📶 WiFi dead zones frustrate students and faculty
🚽 Sanitation issues impact health and comfort
🔧 Maintenance teams work blind, without data

Why Traditional Systems Fail:

Most campuses rely on scattered complaint emails, phone calls, or paper forms. There's no central intelligence, no pattern recognition, no way to see which buildings are problem hotspots, and no data to justify budget allocation.

The Gap: Without spatial intelligence and trend analysis, every issue feels new. Resources get wasted on symptoms while root causes go unaddressed.

💡 Our Solution

CampusCare transforms scattered complaints into actionable intelligence.

We combine real-time geospatial visualization, AI-powered insights, and community engagement to help campuses shift from reactive firefighting to data-driven infrastructure planning.

🎯 How It Works

📱 Report → 🗺️ Visualize → 📊 Analyze → 🤖 AI Insights → ⚡ Prioritize → ✅ Resolve

✨ What Makes Us Different

🗺️ See the Patterns
Interactive heatmaps show where problems cluster. One glance reveals chronic trouble zones.

🎯 Know What Matters
AI-powered priority scoring ranks issues by urgency, frequency, and impact - not just chronology.

🤖 Understand Why
Gemini AI analyzes trends and explains them in plain English: "Building A has 3x more electrical issues than average."

🏆 Engage the Community
Voting system lets users upvote critical issues. Leaderboard rewards active reporters with points and recognition.

📧 Stay Informed
Auto-email notifications when issues are reported, resolved, or deleted - keeping everyone in the loop.

🚀 Key Capabilities

Real-Time Intelligence

Live heatmaps with severity weighting
Dynamic filters (category, time, building)
Historical trend analysis

Smart Prioritization

AI risk scoring per zone
Community voting influence
Predictive maintenance queues

Admin Power Tools

Complete user & issue management
System-wide analytics dashboard
Export reports (CSV/JSON)
Bulk operations

Community Rewards

Points for reporting issues
Vote multipliers for engagement
Public leaderboard
Recognition badges

The Result? Administrators get a data-backed command center. Maintenance teams know where to focus. Students feel heard. And the campus infrastructure actually gets better over time.

�️ Technology Stack

💻 Frontend

⚡ Next.js 14 with App Router
🎨 Tailwind CSS + Shadcn UI
🗺️ Leaflet + OpenStreetMap
📊 Recharts for analytics
🔔 React Hot Toast notifications

⚙️ Backend

🔒 Express + TypeScript APIs
🔥 Firebase Admin SDK
📧 Nodemailer for emails
🐳 Docker containerization
🚂 Railway deployment

💾 Database & Storage

📄 Firestore NoSQL database
🗺️ GeoPoint for spatial queries
🖼️ Firebase Storage for images
⚡ Real-time data sync
🔍 Composite indexes

🤖 AI & Intelligence

🧠 Gemini 1.5 Flash API
🔐 Firebase Authentication
📊 AI-powered insights
🎯 Risk scoring algorithms
📝 Natural language reports

✨ Core Features

🗺️ Interactive Heatmaps Real-time issue density visualization Severity-weighted heat intensity Dynamic filters (category, status, building) Critical zone identification Custom campus boundaries	🎯 Smart Prioritization AI-powered risk scoring Community voting system Recurrence analysis Priority-based queues Automated triage
🤖 AI Insights (Gemini) Plain-English analysis Pattern recognition Trend reports Root cause suggestions Natural language queries	🏆 Community Rewards Points for issue reporting Vote multipliers Public leaderboard Recognition badges Engagement tracking
👥 Admin Dashboard User management (CRUD) Issue oversight & bulk actions System-wide analytics Export reports (CSV/JSON) Activity monitoring	📧 Email Notifications Beautiful HTML templates Issue reported alerts Resolution notifications Deletion confirmations OAuth welcome emails
🔐 Authentication Email/password login Google OAuth Role-based access control JWT token security Profile management	📊 Analytics & Trends Historical pattern analysis Category breakdowns Building-wise metrics Time-series charts Predictive insights

🏗️ System Architecture

%%{init: {'theme':'base', 'themeVariables': { 'primaryColor':'#1976d2','primaryTextColor':'#fff','primaryBorderColor':'#0d47a1','lineColor':'#424242','secondaryColor':'#388e3c','tertiaryColor':'#f57c00','noteBkgColor':'#fff9c4','noteTextColor':'#000'}}}%%
graph TB
    subgraph Frontend["🖥️ Frontend - Vercel"]
        NextJS["Next.js 14<br/>App Router + RSC"]
        Leaflet["Leaflet Maps<br/>Real-time Heatmaps"]
        AdminUI["Admin Dashboard<br/>Charts & Analytics"]
    end

    subgraph Backend["⚙️ Backend - Railway"]
        Express["Express + TypeScript<br/>REST API"]
        AdminModule["Admin Module<br/>User/Issue Management"]
        EmailService["Nodemailer<br/>HTML Templates"]
    end

    subgraph Data["💾 Data Layer"]
        Firestore["Firebase Firestore<br/>GeoPoint Queries"]
        FirebaseAuth["Firebase Auth<br/>JWT Tokens"]
    end

    subgraph AI["🤖 AI Layer"]
        Gemini["Gemini 1.5 Flash<br/>Natural Language Insights"]
    end

    NextJS --> Express
    Leaflet --> NextJS
    AdminUI --> AdminModule
    Express --> Firestore
    Express --> FirebaseAuth
    Express --> Gemini
    EmailService --> Express
    AdminModule --> Firestore

    style Frontend fill:#1976d2,stroke:#0d47a1,stroke-width:2px,color:#fff
    style Backend fill:#388e3c,stroke:#2e7d32,stroke-width:2px,color:#fff
    style Data fill:#7b1fa2,stroke:#6a1b9a,stroke-width:2px,color:#fff
    style AI fill:#f57c00,stroke:#e65100,stroke-width:2px,color:#fff

Architecture Layers

🎨 Frontend

Next.js 14

App Router
React Server Components
Leaflet heatmaps
Admin dashboard

⚙️ Backend

Express API

TypeScript
Railway deployment
40+ endpoints
Email service

💽 Database

Firestore

GeoPoint queries
Composite indexes
Real-time sync
Role-based access

🤖 AI

Gemini AI

Plain-English reports
Pattern analysis
Trend insights
1500 req/day

🛠️ Technology Stack

💻 Frontend Stack

Features:

🚀 Server-side rendering for performance
🎨 Modern UI with Tailwind CSS
📱 Responsive design
⚡ Optimized for speed
🗺️ OpenStreetMap + Leaflet integration

⚙️ Backend Stack

Features:

🔒 Type-safe APIs with TypeScript
🔥 Firebase SDK for database
🐳 Containerized deployment
🔐 Firebase authentication
📊 RESTful architecture
💰 100% Free hosting

☁️ Google Cloud Platform Suite

Serverless
Containers

NoSQL +
Geospatial

Interactive
Maps

AI
Insights

Auth &
Hosting

Open Source
Maps

📊 Data Model

Infrastructure Issue Entity

Field	Type	Description
issue_id	UUID	Unique identifier
category	Enum	Water, Electricity, WiFi, Sanitation, etc.
latitude	Float	Geographic latitude
longitude	Float	Geographic longitude
severity	Integer	Severity level (1-5)
timestamp	DateTime	Issue creation time
status	Enum	Open, In Progress, Resolved
description	Text	Issue details
building_id	String	Associated building identifier (optional)

🚀 Quick Start

📋 Prerequisites

v18 or higher

Free Spark Plan

From AI Studio

⚡ 3-Step Setup

1️⃣ Firebase Setup

# Create Firebase project
# (console.firebase.google.com)

# Enable Firestore
# Enable Authentication
# Download service account key

Get:

Project ID
Service account JSON
Web app config

📖 Full Guide

2️⃣ Backend Deploy

cd backend
npm install

# Add .env file
FIREBASE_SERVICE_ACCOUNT_KEY='{...}'
GOOGLE_GEMINI_API_KEY='your_key'
EMAIL_USER='your@gmail.com'
EMAIL_PASS='app_password'

# Deploy to Railway
npm run build

📖 Railway Guide

3️⃣ Frontend Deploy

cd frontend
npm install

# Add .env.local
NEXT_PUBLIC_API_URL='https://your-api.railway.app'
NEXT_PUBLIC_FIREBASE_CONFIG='{...}'

# Run locally
npm run dev

# Deploy to Vercel
vercel --prod

📖 Integration Guide

🌐 Access Points

Service	URL	Description
🎨 Frontend	http://localhost:3000	Next.js app with heatmaps
⚙️ Backend	http://localhost:3001	Express API on Railway
🔥 Firestore	Firebase Console	Database & authentication
📧 Admin Panel	/admin/dashboard	User/issue management

🔑 Get API Keys (All Free!)

🤖 Gemini API Key (1500 requests/day)

Visit aistudio.google.com
Click "Create API Key"
Copy to GOOGLE_GEMINI_API_KEY in .env

🔥 Firebase Config (No credit card)

Go to Firebase Console
Create new project
Enable Firestore Database
Enable Authentication (Email & Google)
Project Settings → Service Accounts → Generate new private key
Copy JSON to FIREBASE_SERVICE_ACCOUNT_KEY

📧 Gmail SMTP (For email notifications)

Enable 2FA on your Google account
Generate App Password: myaccount.google.com/apppasswords

Add to .env:

EMAIL_USER=your@gmail.com
EMAIL_PASS=your_16_char_app_password

📄 Environment Variables

Backend (.env):

FIREBASE_SERVICE_ACCOUNT_KEY='{"type":"service_account",...}'
GOOGLE_GEMINI_API_KEY='AIzaSy...'
EMAIL_USER='your@gmail.com'
EMAIL_PASS='your_app_password'
PORT=3001
FRONTEND_URL='http://localhost:3000'

Frontend (.env.local):

NEXT_PUBLIC_API_URL='http://localhost:3001'
NEXT_PUBLIC_FIREBASE_CONFIG='{"apiKey":"...","authDomain":"...",...}'

📁 Project Structure

campuscare/
├── 📄 README.md                    # You are here!
├── 🐳 docker-compose.yml           # Multi-service orchestration
├── 📚 docs/                        # Comprehensive documentation
│   ├── FIREBASE_SETUP.md          # Firebase configuration guide
│   ├── architecture/              # System design docs
│   ├── api/                       # API specifications
│   └── prompts/                   # AI prompt templates
│
├── ⚙️ backend/                     # Node.js + Express + TypeScript
│   ├── src/
│   │   ├── config/                # Firebase initialization
│   │   ├── modules/               # Feature modules
│   │   │   ├── issues/           # Issue management
│   │   │   ├── analytics/        # Data analytics
│   │   │   ├── ai/               # Gemini integration
│   │   │   └── auth/             # Firebase auth
│   │   ├── middlewares/          # Express middleware
│   │   ├── types/                # TypeScript definitions
│   │   └── utils/                # Helper functions
│   └── package.json              # Dependencies (Firebase Admin)
│
├── 🎨 frontend/                    # Next.js 14 + TypeScript
│   ├── src/
│   │   ├── app/                  # Next.js app router
│   │   ├── components/           # React components
│   │   │   ├── Map/             # Leaflet + OpenStreetMap
│   │   │   ├── Charts/          # Data visualization
│   │   │   └── Dashboard/       # Admin interface
│   │   ├── lib/                 # Firebase SDK & utilities
│   │   └── styles/              # Tailwind CSS
│   └── public/                  # Static assets
│
├── 📊 analytics/                   # Analytics Scripts
│   └── firestore/              # Firestore queries & aggregations
│
└── 🏗️ infra/                       # Infrastructure as Code
    ├── firebase.json             # Firebase hosting
    └── firestore.rules           # Firestore security rules

🧪 Testing

# Backend tests
cd backend
npm test
npm run test:coverage

# Frontend tests
cd frontend
npm test

📦 Deployment

Deploy to Google Cloud Platform in Minutes

⚙️ Backend (Cloud Run)

# Build and deploy
cd backend
gcloud run deploy campuscare-backend \
  --source . \
  --platform managed \
  --region us-central1 \
  --allow-unauthenticated

Auto-configured:

✅ Automatic HTTPS
✅ Firebase integration
✅ Environment secrets
✅ Health checks
✅ Free tier: 10GB bandwidth

🎨 Frontend (Firebase/Vercel)

# Build Next.js app
cd frontend
npm run build

# Deploy to Firebase
firebase deploy --only hosting

# Or deploy to Vercel
vercel --prod

Features:

✅ Global CDN
✅ Automatic SSL
✅ Optimized builds
✅ Preview deployments
✅ Analytics included

🔒 Security & Best Practices

🛡️ Authentication

Multi-provider support
JWT token validation
Session management
Role-based access control

🔐 Data Protection

SQL injection prevention
XSS protection
CSRF tokens
Input sanitization
Environment encryption

⚡ Rate Limiting

API throttling
DDoS protection
Request validation
IP whitelisting
Quota management

📈 Scalability & Future Roadmap

Built to Scale: Campus → Multi-Campus → Smart City

🏢 Multi-Campus

Extend to multiple institutions with tenant isolation

📱 IoT Integration

Connect real-time sensors for automated monitoring

📲 Mobile Apps

Native iOS/Android apps for field staff

🌆 Smart City

Scale to public infrastructure management

🤝 Contributing

graph LR
    A[🍴 Fork] --> B[🌿 Branch]
    B --> C[💻 Code]
    C --> D[✅ Test]
    D --> E[📝 Commit]
    E --> F[🚀 Push]
    F --> G[🔄 Pull Request]

    style A fill:#e3f2fd
    style G fill:#c8e6c9

Quick Steps:

🍴 Fork the repository
🌿 Create feature branch (git checkout -b feature/AmazingFeature)
💻 Make your changes
✅ Add tests
📝 Commit (git commit -m 'Add AmazingFeature')
🚀 Push to branch (git push origin feature/AmazingFeature)
🔄 Open a Pull Request

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

🙏 Acknowledgments

Cloud Infrastructure

Serverless computing, managed databases, and global CDN

AI Intelligence

Natural language insights and automated report generation

Interactive Maps

Open source mapping with no API key required

Open Source Maps

Free, unlimited map tiles with no API key required

📞 Contact & Support

Project Link: https://github.com/deepaksoni47/CIIS

🌟 Star this repository if you find it useful! 🌟

Name		Name	Last commit message	Last commit date
Latest commit History 109 Commits
analytics/bigquery		analytics/bigquery
backend		backend
docs		docs
frontend		frontend
infra		infra
scripts		scripts
.env.docker.example		.env.docker.example
.env.example		.env.example
.gitignore		.gitignore
FIRESTORE_OPTIMIZATION_SUMMARY.md		FIRESTORE_OPTIMIZATION_SUMMARY.md
README.md		README.md
docker-compose.prod.yml		docker-compose.prod.yml
docker-compose.yml		docker-compose.yml
firebase.json		firebase.json
firestore.indexes.json		firestore.indexes.json
package.json		package.json
quick-start.bat		quick-start.bat
quick-start.sh		quick-start.sh
railway.toml		railway.toml

Folders and files

Latest commit

History

Repository files navigation

🏛️ CampusCare

Smart Campus Infrastructure with Real-Time Heatmaps, AI Insights & Community Rewards

🌟 Built with Firebase, Gemini AI & Modern Web Technologies 🌟

📋 Table of Contents

🎯 The Problem

💡 Our Solution

🎯 How It Works

✨ What Makes Us Different

🚀 Key Capabilities

�️ Technology Stack

💻 Frontend

⚙️ Backend

💾 Database & Storage

🤖 AI & Intelligence

✨ Core Features

🗺️ Interactive Heatmaps

🎯 Smart Prioritization

🤖 AI Insights (Gemini)

🏆 Community Rewards

👥 Admin Dashboard

📧 Email Notifications

🔐 Authentication

📊 Analytics & Trends

🏗️ System Architecture

Architecture Layers

🎨 Frontend

⚙️ Backend

💽 Database

🤖 AI

🛠️ Technology Stack

💻 Frontend Stack

⚙️ Backend Stack

☁️ Google Cloud Platform Suite

📊 Data Model

Infrastructure Issue Entity

🚀 Quick Start

📋 Prerequisites

⚡ 3-Step Setup

1️⃣ Firebase Setup

2️⃣ Backend Deploy

3️⃣ Frontend Deploy

🌐 Access Points

🔑 Get API Keys (All Free!)

📄 Environment Variables

📁 Project Structure

🧪 Testing

📦 Deployment

Deploy to Google Cloud Platform in Minutes

⚙️ Backend (Cloud Run)

🎨 Frontend (Firebase/Vercel)

🔒 Security & Best Practices

🛡️ Authentication

🔐 Data Protection

⚡ Rate Limiting

📈 Scalability & Future Roadmap

Built to Scale: Campus → Multi-Campus → Smart City

🏢 Multi-Campus

📱 IoT Integration

📲 Mobile Apps

🌆 Smart City

🤝 Contributing

📄 License

🙏 Acknowledgments

📞 Contact & Support

🌟 Star this repository if you find it useful! 🌟

About

Resources

Uh oh!

Stars

Watchers

Forks

Releases

Packages 0

Uh oh!

Contributors

Uh oh!

Packages