{"info":{"_postman_id":"d473c071-c193-4d5f-8e5a-0ffeadb14e25","name":"Vanguard AERO API","description":"

🚀 Vanguard AERO — Squadron Operations Command Center

Vanguard AERO is a high-fidelity, interactive management platform engineered to orchestrate team-based activities within a decentralized squadron environment. It transitions unstructured community communication into a high-density, automated workflow: Discuss → Vote → Schedule → Play → Track.

🎯 Project Overview

The Problem

In large-scale batch environments (e.g., 120+ students divided into squads), coordination via traditional messaging apps leads to:

Entropy: Important decisions are lost in chat history.
Opacity: No clear record of past performance or MVP status.
Inertia: Scheduling weekly operations manually is time-consuming and prone to error.

The AERO Solution

AERO provides a centralized, Identity-First portal that serves as the \"source of truth\" for the squadron. It leverages real-time synchronization, 3D atmospheric immersion, and role-based permissions to ensure every operation is executed with precision.

🧠 Technical Architecture

Tech Stack

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Tier	Technology	Purpose
Frontend	React 19 (Vite)	High-performance UI rendering
State	Redux Toolkit	Centralized state management & persistence
3D Engine	Three.js / R3F	Immersive \"AeroSky\" atmospheric background
Real-time	Socket.IO	Bi-directional event synchronization
Styling	Tailwind CSS 4.0	Utility-first, high-density design system
Animations	Framer Motion	Cinematic transitions and micro-interactions
Backend	Node.js (Express)	RESTful API & Signaling server
Database	MongoDB	Persistent storage for users, polls, and results

📂 Granular Folder Architecture

🖥️ Client Architecture (`/frontend`)

src/\n├── assets/          # Brand identity, icons, and 3D models\n├── components/      # Atomic UI components\n│   ├── AeroUI.jsx   # Design System (GlassPanel, AeroButton, etc.)\n│   ├── Layout.jsx   # Protected layout wrapper with Sidebar/Navbar\n│   └── SEO.jsx      # Dynamic meta-tag management for search/social\n├── hooks/           # Business logic abstractions\n│   ├── useAuth.js   # Identity & Role management\n│   ├── useStorage.js# Type-safe Local/Session storage handlers\n│   └── useSocket.js # WebSocket lifecycle management\n├── pages/           # High-level views and route components\n│   ├── Dashboard.jsx# Operational overview and metrics\n│   ├── Polls.jsx    # Democratic decision-making hub\n│   └── Calendar.jsx # Squadron milestone scheduling\n├── redux/           # Global state slices and store config\n├── services/        # API clients and WebSocket definitions\n└── utils/           # Helper functions, constants, and mock data\n

⚙️ Server Architecture (`/backend`)

src/\n├── config/          # DB connection & Environment validation\n├── controllers/     # Orchestration logic for API endpoints\n├── middleware/      # JWT verification, logging, and error handling\n├── models/          # Data schemas (Users, Polls, GameHistory)\n├── routes/          # Express route definitions\n└── index.js         # Entry point & Socket.IO server initialization\n

🚀 Installation & Setup

Prerequisites

Node.js: v18.x or higher
Package Manager: npm v9.x+ (preferred)
Environment: Access to a MongoDB instance (Local or Atlas)

1. Repository Initialization

git clone https://github.com/Dhvanitkanabar/teamaero.git\ncd teamaero\n

2. Frontend Configuration

cd frontend\nnpm install\n# Ensure .env contains:\n# VITE_API_URL=http://localhost:5000/api\n# VITE_SOCKET_URL=http://localhost:5000\nnpm run dev\n

3. Backend Configuration

cd ../backend\nnpm install\n# Create a .env file:\n# PORT=5000\n# MONGO_URI=your_mongodb_connection_string\n# JWT_SECRET=your_secure_random_string\nnpm start\n

✨ Featured Systems

🛡️ Smart Storage Utility

AERO uses a custom-built, fallback-aware storage engine located in src/utils/storage.js.

Persistent: localStorage stores theme preferences and non-sensitive operator metadata.
Ephemeral: sessionStorage manages multi-step form progress and temporary search filters.
Security: Sensitive data (passwords) are strictly excluded from storage; tokens are cleared instantly on session termination.

🗳️ Squadron Operations Hub

Dynamic Polls: Real-time voting with instant result broadcasting.
Automated Scheduling: The system automatically flags \"Wednesday\" as a combat day but allows Admin overrides.
Leaderboard: Weighted ranking system based on Participation (40%), Performance (40%), and Achievements (20%).

🎨 High-Density UI/UX

AeroSky: A 3D atmospheric simulation that reacts to user navigation.
Glassmorphism: Deep blur effects with metallic borders for a \"technical aviation\" aesthetic.
Smooth Navigation: Integration of Lenis for momentum-based scrolling.

🛠️ Development & Quality Standards

To maintain the project's high code quality, utilize the following built-in tools:

Linting: Run npm run lint to check for style violations.
Auto-Fix: Run npm run lint:fix to automatically resolve lint errors.
Formatting: Run npm run format to standardize the codebase using Prettier.

👨‍💻 Developed By: Vanguard Development Team\n📍 Project Scope: Squadron Coordination & Activity Management Platform

\n","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[{"content":"🚀 Vanguard AERO — Squadron Operations Command Center","slug":"vanguard-aero-squadron-operations-command-center"}],"owner":"50840753","collectionId":"d473c071-c193-4d5f-8e5a-0ffeadb14e25","publishedId":"2sBXqKoKuJ","public":true,"customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"FF6C37"},"publishDate":"2026-05-02T08:07:30.000Z"},"item":[{"name":"Auth","item":[{"name":"Login","id":"7bd68616-1a0b-4f24-b591-1edce155fae5","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"userId\": \"108600\",\n \"password\": \"123456\"\n}","options":{"raw":{"language":"json"}}},"url":"http://localhost:5000/api/auth/login","description":"

Authenticates an operator with their GR Number/ID and password.

\n","urlObject":{"path":["auth","login"],"host":["http://localhost:5000/api"],"query":[],"variable":[]}},"response":[],"_postman_id":"7bd68616-1a0b-4f24-b591-1edce155fae5"}],"id":"650d50cb-cfb3-4e37-9f05-0761339a6554","description":"

Authentication and Identity Management

\n","_postman_id":"650d50cb-cfb3-4e37-9f05-0761339a6554"},{"name":"Operations","item":[{"name":"Get Polls","id":"99aef30d-ee32-46e9-9df9-837a71613aa1","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"http://localhost:5000/api/operations/polls","description":"

Retrieve all active and archived squadron polls.

\n","urlObject":{"path":["operations","polls"],"host":["http://localhost:5000/api"],"query":[],"variable":[]}},"response":[],"_postman_id":"99aef30d-ee32-46e9-9df9-837a71613aa1"},{"name":"Submit Vote","id":"0bde0d27-9742-40e9-ae9f-c2b5afda19c1","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"PATCH","header":[],"body":{"mode":"raw","raw":"{\n \"optionId\": \"poll_opt_01\"\n}","options":{"raw":{"language":"json"}}},"url":"http://localhost:5000/api/operations/polls/:id/vote","description":"

Cast a vote on a specific poll.

\n","urlObject":{"path":["operations","polls",":id","vote"],"host":["http://localhost:5000/api"],"query":[],"variable":[{"id":"67fdc23d-9efa-46a8-83c4-8468b2f1d946","type":"any","value":"poll_777","key":"id"}]}},"response":[],"_postman_id":"0bde0d27-9742-40e9-ae9f-c2b5afda19c1"},{"name":"Get Calendar Events","id":"1a54bfde-a94d-40d3-aa36-2a1a42677809","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"http://localhost:5000/api/operations/calendar","description":"

Fetch the scheduled events for the current month.

\n","urlObject":{"path":["operations","calendar"],"host":["http://localhost:5000/api"],"query":[],"variable":[]}},"response":[],"_postman_id":"1a54bfde-a94d-40d3-aa36-2a1a42677809"}],"id":"9c125a74-1d9b-4362-94ba-7d0384f4fffc","description":"

Squadron Operation endpoints for Polls and Calendar

\n","_postman_id":"9c125a74-1d9b-4362-94ba-7d0384f4fffc"},{"name":"Leaderboard","item":[{"name":"Get Rankings","id":"6afb8c3d-caa3-4454-b8c9-f320e93dbd77","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"http://localhost:5000/api/rankings","description":"

Get current team rankings and MVP standings.

\n","urlObject":{"path":["rankings"],"host":["http://localhost:5000/api"],"query":[],"variable":[]}},"response":[],"_postman_id":"6afb8c3d-caa3-4454-b8c9-f320e93dbd77"}],"id":"30980fdf-13b7-4391-bca8-a237fdb672a3","description":"

Performance and Ranking endpoints

\n","_postman_id":"30980fdf-13b7-4391-bca8-a237fdb672a3"}],"variable":[{"key":"baseUrl","value":"http://localhost:5000/api"}]}