🍛 Pro Mess

A full-stack mess (shared-meal) management platform for students living in Bangladeshi messes and dorms. Track meals, bazar (grocery) spending, deposits and fixed costs. Pro Mess calculates the meal rate and each member's balance automatically.

✨ Features

Module	What it does
📊 Dashboard	Mess overview, personal overview, month progress, member balances, highlights and recent activity
🍽️ Meals	Daily meal counts per member
🛒 Bazar	Grocery spending entries plus a bazar rotation schedule showing whose turn it is
💰 Deposits	Monthly deposits per member
🏠 Fixed costs	Rent, gas, electricity, internet and other costs, with a breakdown by category
👥 Members	Admin-managed members, with a forced password change on first login
📜 Activity log	An audit trail of every change

How the money works

meal rate      = total bazar cost / total meals
meal cost      = member's meals × meal rate
net balance    = deposits − meal cost

🔐 Security

• Supabase Auth with two roles: admin and member
• Row Level Security on every table. Everyone in the mess can see the data, members can manage their own meals, and admins manage everything else.
• Server actions handle mutations, and the service-role key is only ever used on the server.

🧱 Tech Stack

• Frontend: Next.js 16 (App Router), React 19, Tailwind CSS 4, lucide-react
• Backend: Supabase (PostgreSQL, Auth, RLS) and Next.js Server Actions
• Language: TypeScript

📁 Structure

src/
├── app/            # routes: dashboard, meals, bazar, deposits, fixed-costs, members, activity…
├── components/     # layout shell + reusable UI (glass cards, modals, stat cards)
├── contexts/       # auth context
└── lib/            # supabase clients, audit logger, types, utils
supabase/
├── schema.sql      # tables, enums, RLS policies
└── seed.sql

🚀 Getting Started

git clone https://github.com/Muktaditbf/MESS-PRO.git
cd MESS-PRO
npm install

1. Create a project at supabase.com, then run supabase/schema.sql (and optionally seed.sql) in the SQL editor.
2. Create a .env.local file:

   NEXT_PUBLIC_SUPABASE_URL=your-project-url
   NEXT_PUBLIC_SUPABASE_ANON_KEY=your-anon-key
   SUPABASE_SERVICE_ROLE_KEY=your-service-role-key

3. Start the dev server:

   npm run dev

   Then open http://localhost:3000.

👤 Author

Muktadi · CSE @ Southeast University · GitHub · LinkedIn