VIT-AP Mess Review Portal

A comprehensive web and mobile application for managing hostel mess operations at VIT-AP University. The system enables menu management, student feedback collection, and complaint handling across multiple hostels.

Architecture

Component	Technology
Backend	Go 1.21+ with Gin framework
Frontend	Next.js 14 with TypeScript
Mobile	Flutter with Riverpod
Database	PostgreSQL (Neon cloud)
ORM	SQLC (type-safe SQL)
Styling	Tailwind CSS + shadcn/ui
Authentication	JWT + Google OAuth

Quick Start

Prerequisites

• Go 1.21 or higher
• Node.js 18 or higher
• Flutter 3.x
• PostgreSQL database

Backend Setup

cd backend
cp .env.example .env
# Configure DATABASE_URL and JWT_SECRET
go run cmd/server/main.go

Server runs on http://localhost:8080

Frontend Setup

cd frontend
npm install
cp .env.example .env.local
npm run dev

Application runs on http://localhost:3000

Mobile App Setup

cd vitap_mess-main
flutter pub get
flutter run

Project Structure

mess-app/
├── backend/
│   ├── cmd/server/          # Application entry point
│   ├── internal/
│   │   ├── handlers/        # HTTP request handlers
│   │   ├── services/        # Business logic (SQLC integrated)
│   │   ├── models/          # Data models
│   │   ├── database/        # Database connections + SQLC helpers
│   │   ├── db/              # SQLC generated code
│   │   └── middleware/      # Auth middleware
│   └── migrations/          # SQL migrations
├── frontend/                # Next.js admin dashboard
├── vitap_mess-main/         # Flutter mobile app
│   ├── lib/
│   │   ├── core/
│   │   │   ├── api/         # API clients
│   │   │   ├── models/      # Data models
│   │   │   ├── pages/       # UI screens
│   │   │   ├── widgets/     # Reusable components
│   │   │   ├── theme/       # App theming
│   │   │   └── router/      # Navigation
│   │   └── main.dart
└── scripts/                 # Utility scripts

Features

Mobile App (Flutter)

• Google OAuth authentication
• Daily menu viewing with date selector (30 days range)
• Star ratings for meals (1-5)
• Complaint submission with categories
• Profile management (hostel, room, floor)
• Dark/Light theme with Material 3

Admin Dashboard (Next.js)

• Menu management with bulk upload
• Student management
• Complaint handling
• Review analytics
• Hostel configuration

Backend (Go + SQLC)

• Type-safe database queries
• JWT authentication
• Role-based access control
• RESTful API

User Roles

Role	Access Level
SUPERADMIN	Full system access
ADMIN	Menu management, complaint handling
VENDOR	View/edit menus for assigned hostel
STUDENT	Mobile app - reviews and complaints

Deployment

• Backend: AWS EC2
• Frontend: Vercel
• Database: Neon PostgreSQL

License

MIT License