📖 Overview ✨ Features 🛠️ Tech Stack 🚀 Get Started 🎨 Showcase 🤝 Contribute

---

🌟 What is GoalIQ?

🎯 The Problem Teams struggle with: 📊 Outdated spreadsheets & misaligned targets 🔍 Lack of clear visibility in direct report goals ⏱️ Tedious manual performance reviews 📉 Unbalanced weightage distributions 🔒 Complicated and insecure login flows

✅ The Solution GoalIQ delivers: 🔄 Stunning Synchronization Dashboard 🤖 Gemini-Powered Performance Diagnostics ⚡ Real-Time Silent Background Syncing 🔑 Secure Microsoft Entra ID SSO 🎨 Premium Glassmorphic Dark UI

🚀 From Targets to Insights in 3 Steps

graph LR
    A[🎯 Define Draft Goals] -->|Balance Cumulative Weightage| B[⚡ Submit to Manager]
    B -->|Silent Background Sync| C[🤖 Generate AI Review]
    C -->|Gemini Diagnostics| D[🏆 Lock & Execute Objectives]
    
    style A fill:#ff6b6b,stroke:#c92a2a,color:#fff
    style B fill:#4ecdc4,stroke:#0a8278,color:#fff
    style C fill:#45b7d1,stroke:#1a5f7a,color:#fff
    style D fill:#95e1d3,stroke:#38ada9,color:#fff

Loading

---

✨ Core Features

🔄 Synchronization Flow Alignment Dashboards Active cycle budget trackers Auto-balancing compliance Employee target distributions GSAP-powered transitions Real-time delta visualizers	🤖 Gemini AI Engine GenAI Diagnostics Live context-aware performance reviews Auto-drafted manager check-in comments Instant prompt trigger bridges Google Gemini 2.5-Flash model Smart safe-mode offline fallbacks	⚡ Reactive Syncing Live Updates Silent background polling (20s) React Query-style focus refetching Resilient PostgreSQL structure Realtime notification triggers One-click bulk approvals
🔑 Microsoft SSO Corporate Authentication MSAL client configuration Cryptographic JWKS key validation Auto-provisioning mechanism Allowed domain restriction filters Hybrid email login fallback modes	🛡️ Role-Based Guards Enterprise Security Secure JWT sessions Double bcrypt-10 cost hashes Strict Admin / Manager panels Locked cycle escalations Full schema permission grants	🎨 Ultra-Premium UI Stunning Aesthetics Dark mode glassmorphic UI High-contrast visual tokens Resilient SVG indicators Confetti milestone animations Tailored color harmony

---

🛠️ Technology Powerhouse

🎨 Frontend Architecture

React 18.2 UI Framework

Vite Build Tool

Tailwind CSS Styling

JavaScript Language

HTML5 Structures

Additional Libraries: GSAP • Lucide React • Axios • React Router DOM • Canvas Confetti • React Hot Toast • Tailwind Merge

⚙️ Backend & Database Infrastructure

Node.js Runtime

Express Framework

PostgreSQL Engine

Supabase Data Syncing

Gemini AI Intelligence

Additional Tools: JWT Verification • Bcryptjs • Dotenv • Express Validator • Resend Email Client • JWKS RSA

---

🏗️ System Architecture

                    ┏━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓
                    ┃      🌐 GoalIQ Intelligence     ┃
                    ┃      Unified Workspace Portal   ┃
                    ┗━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━━━━┛
                                   │
                    ┏━━━━━━━━━━━━━━▼━━━━━━━━━━━━━━┓
                    ┃      ⚡ Node.js REST API     ┃
                    ┃      • JWT Authentication    ┃
                    ┃      • Gemini AI Services    ┃
                    ┃      • Resend Integrations   ┃
                    ┃      • Entra ID Validation   ┃
                    ┗━━━━━┳━━━━━━━━━━━━━━━┳━━━━━━━┛
                          │               │
            ┏━━━━━━━━━━━━━▼━━━━━┓   ┏━━━━▼━━━━━━━━━━━━━━┓
            ┃  🎨 Web Frontend  ┃   ┃  🗄️ Database      ┃
            ┃  • React 18       ┃   ┃  • Supabase Rest  ┃
            ┃  • GSAP Animation ┃   ┃  • PostgreSQL     ┃
            ┃  • Dark Themes    ┃   ┃  • Schema Grants  ┃
            ┃  • Silent Polling ┃   ┃  • Audit Logging  ┃
            ┗━━━━━━━━━━━━━━━━━━━┛   ┗━━━━━━━━━━━━━━━━━━━┛

---

🚀 Quick Start

📋 Prerequisites

Node.js 18+ Download

Git Download

Gemini API Key Get Free Key

⚡ Installation Steps

1️⃣ Clone the Repository

git clone https://github.com/RITHIKKUMARAN/GoalIQ.git
cd GoalIQ

2️⃣ Setup Backend API Server

cd server
npm install

# Copy environment template
cp .env.example .env
# Open .env and populate your credentials

Configure server/.env:

PORT=3001
SUPABASE_URL=https://your-project.supabase.co
SUPABASE_SERVICE_KEY=your_supabase_service_role_key
JWT_SECRET=your_secure_jwt_decoding_key
GEMINI_API_KEY=your_google_ai_studio_gemini_key
RESEND_API_KEY=your_resend_transactional_email_token
RESEND_FROM_EMAIL=GoalIQ <onboarding@resend.dev>
FRONTEND_URL=http://localhost:5173

# Seed initial users & goal cycles
npm run seed

# Start Express Dev Server
npm run dev

✅ Backend running at http://localhost:3001

3️⃣ Setup React Frontend Client

cd ../client
npm install

Configure client/.env:

VITE_API_URL=http://localhost:3001
VITE_AZURE_CLIENT_ID=your_optional_azure_sso_client_id
VITE_AZURE_TENANT_ID=your_optional_azure_sso_tenant_id

# Start Vite Development Server
npm run dev

✅ Client running at http://localhost:5173

---

📖 Alignment Workflow Guide

1️⃣ Define Goals Create your specific targets and metrics under the active cycle

2️⃣ Balance Weight Adjust goal weights to total exactly 100% to open submissions

3️⃣ Manager Review Managers review inputs, tweak values, and approve/return entries

4️⃣ AI Diagnostics Trigger Gemini chat drawer to review progress or draft comments

---

🎨 Page Showcase

👤 Employee Workspace 🌟 High-contrast budget compliance cards 📝 Interactive Goal Creation Modal 🎯 Remaining weightage warnings 📬 Achievement submissions 💬 AI Goal Assistant Chatbot

📈 Manager command center 🗂️ Direct report summary cards ⚡ Quick Event-driven AI progress reviews 📥 Realtime-style synchronization queue 🛠️ Direct Target & Weight adjustments 🏆 One-click bulk sync approvals

🌟 Feature Availability Matrix

Dynamic Capability	Employee	Manager	System Admin
Create & Edit Goals	✅	⬜	⬜
Balance Weightages	✅	✅	⬜
Submit for Sync Lock	✅	⬜	⬜
Approve & Return Goals	⬜	✅	⬜
Launch AI Progress Reviews	⬜	✅	⬜
Silent Background Polling	✅	✅	✅
Provision Cycles & Accounts	⬜	⬜	✅

---

🤝 Contributing

We welcome contributions! Here's how you can join the loop:

• Report Bugs: Open an issue at GoalIQ Issues.
• Suggest Enhancements: Push ideas to improve glassmorphic layouts or AI review prompts.
• Submit Pull Requests: Read branching rules, run production builds, and open a PR!

---

📜 License

This project is licensed under the MIT License.

See the LICENSE file for complete details.

---

👨💻 Creator

Rithik Kumaran K

💻 Full-Stack Developer | 🤖 AI Specialist | 🎨 UI/UX Designer

---

🚀 Ready to Accelerate Your Team's Performance?