Skip to content

README.md

Latest commit

 

History

History
163 lines (101 loc) · 4.24 KB

README.md

File metadata and controls

163 lines (101 loc) · 4.24 KB

🏫 CampuSync

Typing SVG

🚀 A Full-Stack Microservices Application built with Python, Flask, React, PostgreSQL, Firebase & Kafka

🌟 Overview

CampuSync is a modern Campus & Hostel Management System developed using a highly decoupled Python Microservices Architecture.

The platform digitizes and streamlines campus operations through secure authentication, intelligent complaint management, AI-powered lost & found tracking, and real-time event-driven notifications.

✨ Highlights & Features

🔐 Secure Firebase Authentication

  • Role-Based Access Control (RBAC)
  • Secure JWT verification
  • Centralized identity management

👥 Multi-Role System

Dedicated dashboards for:

  • 🎓 Student - ( specific feature & access )
  • 🛠️ Worker - ( specific feature & access )
  • 👨‍💼 Admin - ( full access & control)

🤖 AI-Powered Lost & Found

  • Image similarity matching powered by Google Gemini Vision AI
  • Automated item identification
  • Faster recovery workflow for students

⚡ Complaint Priority Engine

  • Smart complaint classification
  • Priority-based issue handling
  • Efficient task assignment workflow

📢 Real-Time Notifications

  • Kafka-powered event processing
  • Asynchronous service communication
  • Instant status updates

🏗️ Microservices Architecture

The system follows a Database-per-Service Architecture to ensure scalability, maintainability, and fault isolation.

📦 CampuSync
├── 🔐 auth-service
│   └── Firebase Authentication, JWT & RBAC

├── ⚡ complaint-service
│   └── Complaint Management & Kafka Producer

├── 🤖 lost-found-service
│   └── AI Image Matching & Gemini Integration

├── 📢 notification-service
│   └── Kafka Consumer & Real-Time Alerts

├── 🎨 frontend
│   └── React + Vite Single Page Application

└── 🐳 docker-compose.yml
    └── Multi-Container Orchestration

🛠️ Tech Stack

Layer Technologies
🎨 Frontend React.js, Vite, CSS
⚙️ Backend Python, Flask, REST APIs
🗄️ Database PostgreSQL
🔐 Authentication Firebase Admin SDK, JWT
📢 Messaging Apache Kafka
🐳 Deployment Docker, Docker Compose
🤖 AI Integration Google Gemini Vision

🎯 Engineering Concepts Demonstrated

✅ Microservices Architecture

✅ Python Based Algorith

✅ Event-Driven Communication

✅ REST API Development

✅ Authentication & Authorization

✅ AI Integration

✅ Database Design

✅ Full-Stack Development

✅ Dockerized Deployment

📸 Screenshots

🔐 Login Screen

🎓 User Dashboard

Replace the image paths above with your actual screenshots.

👨‍💻 Developer

Yashvanth Balaji

💻 Python Full Stack Developer

⚡Python • Microservices • Flask • React • PostgreSQL • Kafka • Firebase

⭐ If you found this project interesting, consider giving it a star!

🚀 Building scalable systems, one microservice at a time.