# GKV Flow — Academic Project Workspace & Institutional Evaluation System

> GKV Flow is an enterprise academic project management, collaboration, and institutional evaluation platform developed for Gurukula Kangri (Deemed to be University), Haridwar, Uttarakhand, India. It digitizes the entire academic project lifecycle, from proposal defense and weekly milestone tracking to dual-level rubric evaluation, official university PDF grade sheet generation, and QR-verifiable completion certificates.

## Core Engineering & Development Team

GKV Flow was architected, engineered, and developed by:

1. **Dr. Nishant Kumar** — Lead Architect & Faculty Project Director
   - Institutional Affiliation: Gurukula Kangri (Deemed to be University), Haridwar
   - Personal Website: [https://nishantmunjal.com](https://nishantmunjal.com)
   - LinkedIn: [https://linkedin.com/in/nishantmunjal2003](https://linkedin.com/in/nishantmunjal2003)
   - Contribution: Architectural design, institutional governance framework, role-based scoping policies, and system direction.

2. **Pradeep Gupta** — Core Developer & Full-Stack Engineer
   - Institutional Affiliation: Gurukula Kangri (Deemed to be University), Haridwar
   - LinkedIn: [https://www.linkedin.com/in/pradeepgupta7](https://www.linkedin.com/in/pradeepgupta7)
   - Contribution: Full-stack system development, PostgreSQL database schemas, row-level security hardening, and workspace integrations.

3. **Piyush Tripathi** — Core Developer & Full-Stack Engineer
   - Institutional Affiliation: Gurukula Kangri (Deemed to be University), Haridwar
   - LinkedIn: [https://www.linkedin.com/in/piyush-tripathi-105324321](https://www.linkedin.com/in/piyush-tripathi-105324321)
   - Contribution: User interface engineering, dual-level evaluation reporting, print-ready PDF engine, and public certificate verification.

## Institutional Ownership & Governance

- **Institution**: Gurukula Kangri (Deemed to be University), Haridwar, Uttarakhand, India (Established 1902 by Swami Shraddhanand).
- **Official Portal**: [https://www.gkv.ac.in](https://www.gkv.ac.in)
- **Domain Constraint**: User accounts and authentication strictly enforce Google Workspace `@gkv.ac.in` domain verification. External email providers are restricted.

## Core System Capabilities

### 1. Role-Based Access Control (RBAC)
- **Dean / Super Admin**: Global institutional authority across all departments, cycles, and staff role assignments.
- **Head of Department (HOD)**: Departmental oversight, project code creation, and departmental PDF report approvals.
- **Project Coordinator**: Cycle management, proposal verification queue, and assigned project code management.
- **Faculty Mentor**: Guidance of assigned student teams, weekly review meetings, milestone grading, and rubric evaluation.
- **Student**: Team formation or joining via secret team codes, Kanban task board, deliverable uploads (up to 50 MB), and grade tracking.

### 2. Dual-Level Evaluation Rubric
- **Team-Level Evaluation (100 Marks Total)**:
  - Innovation & Originality: 20 Marks
  - System Implementation & Code Quality: 20 Marks
  - Presentation & Defense: 20 Marks
  - Technical Documentation & Synopsis: 20 Marks
  - Viva-Voce & Q&A: 20 Marks
- **Individual Student Evaluation (40 Marks Total)**:
  - Individual Contribution: 20 Marks
  - Individual Viva & Technical Understanding: 20 Marks
- **Automated Grading Scale**:
  - `A+` (90–100%), `A` (80–89%), `B+` (70–79%), `B` (60–69%), `C` (50–59%), `D` (40–49%), `F` (<40%).

### 3. Print-Ready Official University A4 PDF Reports
- Generates official university grade sheets with institutional letterhead and 4 physical signature blocks:
  1. Faculty Mentor
  2. Head of Department (HOD)
  3. Project Coordinator
  4. Dean / Authorized University Officer

### 4. Cryptographically Verifiable Completion Certificates
- Digital completion certificates with embedded verification hashes and QR codes.
- Public authenticity verification endpoint: `/verify/:code`.

### 5. Institutional Communication Center
- Transactional notification delivery via Zoho ZeptoMail API.
- Configurable university email signatures and announcement composer with rich formatting.

## Technical Architecture

- **Frontend**: React 19, TypeScript 5.8, Tailwind CSS v4, Radix UI Primitives, Lucide Icons, Recharts.
- **SSR & Routing**: TanStack Start, TanStack Router, Nitro SSR Engine.
- **State Management**: TanStack Query v5 (React Query).
- **Backend & Database**: Supabase (PostgreSQL 15+, PL/pgSQL Stored Procedures, Row-Level Security).
- **Security**: PostgreSQL Row-Level Security (`is_staff`, `is_team_member`, `is_team_mentor`, strict coordinator scoping, student evaluation privacy).

## Documentation & Deep-Dive Specifications

- Extended LLM Documentation: [https://gkvflow.gkv.ac.in/llms-full.txt](https://gkvflow.gkv.ac.in/llms-full.txt)
- Public Verification Endpoint: [https://gkvflow.gkv.ac.in/verify](https://gkvflow.gkv.ac.in/verify)
- Canonical Institutional Site: [https://www.gkv.ac.in](https://www.gkv.ac.in)