64f0c5d754
Some checks failed
Deploy RIT Freshers Hub to VPS / Deploy to Live VPS (push) Has been cancelled
# Please enter a commit message to explain why this merge is necessary, # especially if it merges an updated upstream into a topic branch. # # Lines starting with '#' will be ignored, and an empty message aborts # the commit.
🏫 Rajalakshmi Institute of Technology — Freshers-Hub
Welcome to the Freshers-Hub Portal, a multi-service campus assistant and student utility ecosystem designed for Rajalakshmi Institute of Technology (RIT). The platform provides student services including live transit tracking, study guides, competitive programming leaderboards, developer collaboration networks, and an automated AI assistant.
🏗️ System Architecture & Service Stack
The system is built on a distributed microservice architecture utilizing four primary runtimes:
┌───────────────────────────────┐
│ Nginx Web Server │
│ (Ports 80 / 443) │
└───────────────┬───────────────┘
│
┌───────────────────────┼───────────────────────┐
▼ ▼ ▼
┌───────────────────┐ ┌───────────────────┐ ┌───────────────────┐
│ React Frontend │ │Spring Boot Backend│ │Go Chatbot Service │
│ (Vite App) │ │ (Port 8085) │ │ (Port 8081) │
└───────────────────┘ └─────────┬─────────┘ └───────────────────┘
│
▼
┌───────────────────┐ ┌───────────────────┐
│ Python Gateway │◄──┤ Telegram Bot & │
│ (Port 8082) │ │ Discord Bot │
└───────────────────┘ └───────────────────┘
Stack Components:
- Frontend: React, TypeScript, Vite, Tailwind CSS, Leaflet Maps, and Framer Motion.
- Core API Backend: Spring Boot, Java 21, Hibernate/JPA, and PostgreSQL.
- Go Chatbot Engine: Go microservice performing spelling correction (Levenshtein Distance) and BM25 ranking queries.
- Python Bot Gateway: FastAPI HTTP listener interfacing with Telegram and Discord bot APIs.
⚙️ Service Ports & Deployments
| Component | Dev Port | Production Port | Daemon Service | Description |
|---|---|---|---|---|
| React App | 5173 |
80 / 443 |
nginx |
Frontend web client |
| Spring Boot API | 8085 |
8085 |
springboot |
Core business logic & database API |
| Go Chatbot API | 8081 |
8081 |
chatbot |
Keyword lookup & campus Q&A engine |
| Python Bot Server | 8082 |
8082 |
telegram-bot |
Telegram/Discord webhook router |
| PostgreSQL Database | 5432 |
5432 |
postgresql |
Primary database cluster |
📑 Feature Documentation Directories
For full functional breakdowns, REST API schemas, and technical setup guides for each platform feature, refer to the guides inside docs/features/:
- 📚 Academic Resources Sync: Syncs static uploads on the VPS directly to database catalog endpoints.
- 🛠️ Interactive Student Toolkit: Contains SGPA/CGPA formulas and college internal marks calculation algorithms.
- 🚌 Live Bus GPS Tracking: Renders live bus coordinates with custom Leaflet overlays and static JSON fail-safes.
- 🤖 AI Chatbot Microservice: Custom Go BM25 NLP search engine and spelling correction pipeline details.
- 💬 Moderated Q&A Forum: Moderation workflow linking student web queries with Telegram Senior Helper channels.
- 🤝 Developer Collab Hub: Project listings filtered by RIT subdomains and linked with Telegram/Discord bot accept/decline callback requests.
- 🏆 LeetCode Leaderboard: LeetCode GraphQL polling details using spaced request queues to avoid rate limit bans.
- 🗺️ Interactive Campus Blueprint: Percentage-based blueprint vector coordinates system.
- 👩🏫 Faculty Directory: Unified campus-wide search and sorting directories for RIT professors.
- 🏆 Clubs & Centers Explorer: Extracurricular search matching tool with a built-in interest matching quiz.
- 🚀 RAISE Incubator Landing: Startup slot pitch reservation system.
- 🔑 Admin Panel & Service Watchdog: Operations watchdog script, notification lists, and system health status pipelines.
🛠️ Verification & Building
To verify that the system compiles successfully after local configurations:
- Verify Frontend Build:
npm run build - Verify Java Backend Compilation:
cd backend ./mvnw clean package -DskipTests - Verify Go Microservice Compilation:
cd chatbot-service go build -o chatbot