🚀 AtomQuest 1.0

The Ultimate Next-Generation Enterprise Performance Management & Goal Tracking Platform

Live Demo • Report Bug • Request Feature

---

🌟 Overview

AtomQuest is a high-performance, enterprise-grade Goal Setting and Tracking Portal built for the modern workforce. Designed with mathematical rigor, seamless role-based workflows, and a stunning UI, it replaces archaic performance reviews with real-time, automated, and shared quarterly check-ins.

This platform was engineered from the ground up for the Atomberg AtomQuest Hackathon 1.0.

---

⚡ Core Features

🔐 1. Strict Role-Based Access Control (RBAC)

Secure, middleware-protected workflows tailored to three core personas:

• 👤 Employees: Draft, submit, and manage goals. Log quarterly fractional check-ins.
• 💼 Managers: Approve, reject, or request rework on team goals. Cascade Shared KPIs down the hierarchy.
• 👑 Admins / HR: Oversee organization analytics, monitor SLA escalations, and unlock frozen goals.

🎯 2. Intelligent Progress Engine

A sophisticated mathematical goal-tracking engine with multiple Units of Measurement (UoM):

• Numeric & Percentage: Standard fractional achievement tracking.
• Timeline: Date-driven goal progression.
• Zero-Based: Binary edge-case handling (e.g., Target=0, dividing-by-zero protection).

🤝 3. Cascading Shared KPIs

Managers can push Master Department KPIs down to their team. Employees inherit these shared goals and can only modify their personal weightage, ensuring total organizational alignment while preserving data consistency.

⏳ 4. Automated Workflows & SLA Escalation 🏆 (Bonus Module)

• Strict Validation: Real-time checking to ensure goal weightages exactly equal 100%.
• Goal Locking: Approved goals are mathematically frozen to preserve audit integrity.
• SLA Escalation Engine: A Vercel Cron Job sweeps the PostgreSQL database daily. Goals that miss deadlines or check-ins are automatically flagged, generating an Escalation Ticket visible in a dedicated Admin Dashboard for HR resolution.

📊 5. Real-Time Analytics & Exports 🏆 (Bonus Module)

• Interactive Dashboards: Gorgeous, glassmorphic data visualization for QoQ trends, goal distribution, and achievement matrixes powered by Recharts.
• Live CSV Export: Download entire department performance reports in one click via live PostgreSQL aggregation.

---

🏗️ System Architecture

AtomQuest leverages a fully serverless Edge computing architecture to deliver sub-50ms latency globally.

graph TD
    subgraph Users ["User Personas (Role-Based Access)"]
        E[Employee]
        M[Manager]
        A[Admin / HR]
    end

    E -->|Submit Goals & Check-ins| F1
    M -->|Approve/Reject & Push KPIs| F1
    A -->|View Analytics & Audit Logs| F1

    subgraph Frontend ["Frontend (Vercel Edge)"]
        F1[Next.js 15 App Router]
        F1 --> F2[Zustand & TanStack Query]
        F1 --> F3[Shadcn UI + Tailwind CSS]
    end

    F2 <-->|JSON Payloads| B1

    subgraph Backend ["Backend API (Vercel Serverless)"]
        B1[Next.js API Routes]
        B1 --> B2[NextAuth.js SSO]
        B1 --> B3[Zod Schema Validation]
        B3 --> B4[Prisma ORM]
    end

    subgraph Cloud ["Cloud Infrastructure"]
        C1[Vercel Cron Jobs] -->|Daily Trigger| B1
        B4 <--> C2[(Supabase PostgreSQL)]
    end

Loading

---

💻 Tech Stack

• Framework: Next.js 15 (App Router, Turbopack)
• Language: TypeScript
• Database: PostgreSQL (Hosted on Supabase)
• ORM: Prisma
• Authentication: NextAuth.js (Enterprise SSO Mocking)
• Styling: Tailwind CSS, Framer Motion
• UI Components: Shadcn UI, Headless UI, Lucide Icons
• Data Validation: Zod
• Infrastructure: Vercel (Edge Functions & Cron Jobs)

---

🔑 Demo Credentials

AtomQuest features an auto-provisioning mock authentication system specifically engineered for rapid Hackathon judging. Simply use the following emails (any password works) to instantly switch between roles:

Persona	Login Email	Key Journey
Admin / HR	admin@demo.com	View Analytics Dashboard & SLA Escalation Queue
Manager	manager@demo.com	Approve team goals & push Shared KPIs
Employee	employee@demo.com	Draft goals & log Quarterly Check-ins

---

🚀 Getting Started

Follow these instructions to run the project locally.

1. Clone the Repository

git clone https://github.com/MBGIRISH/ATOMQUEST.git
cd ATOMQUEST

2. Install Dependencies

npm install

3. Setup Environment Variables

Create a .env file in the root directory:

# Required: Supabase or local PostgreSQL connection string
DATABASE_URL="postgresql://user:password@localhost:5432/atomquest"

# Required: Auth Secrets
NEXTAUTH_SECRET="your-super-secret-jwt-encryption-key"
NEXTAUTH_URL="http://localhost:3000"

4. Push Database Schema

npx prisma db push

5. Start the Development Server

npm run dev

Open http://localhost:3000 in your browser.

---

🛡️ Security & Integrity

AtomQuest was engineered with strict enterprise constraints:

• Zod Schema Validation: Every API route rigidly validates incoming payloads. Negative numeric values, missing fields, or weightage overflows are instantly rejected.
• Prisma Transactions: Complex operations (like syncing shared KPIs) utilize database-level transaction guarantees.
• Zero-Trust UI: Forms remount dynamically to prevent React state caching, and the UI never trusts client-side state without backend verification.

---

Built with ❤️ for the AtomQuest Hackathon