bachelor-meal-management-system

Bachelor Meal Management System

Production-ready full-stack app for managing a bachelor mess: meals, shopping costs, meal rate, balances, group management, reports, and notifications.

Tech stack

• Frontend: React (Vite) + Tailwind CSS
• Backend: Node.js + Express.js
• Database: MongoDB (Mongoose)
• Auth: JWT access token

Project structure

.
├─ backend/
└─ frontend/

Setup

1) Requirements

• Node.js 18+ (recommended)
• MongoDB running locally or a MongoDB Atlas connection string

Optional (local Mongo via Docker):

docker compose up -d

2) Environment variables

• Copy .env.example → .env
• Fill in values:
  • MONGO_URI
  • JWT_ACCESS_SECRET
  • CORS_ORIGIN
  • VITE_API_BASE_URL

3) Install dependencies

From repo root:

npm install

4) Run in development

npm run dev

Frontend: http://localhost:5173

API: http://localhost:5000/api/health

In local development, the Vite dev server proxies /api/* to the backend on port 5000 (see frontend/vite.config.ts).

If you prefer separate terminals:

npm run dev:backend
npm run dev:frontend

5) Build for production

npm run build

6) Run backend in production mode

npm run start

API (high level)

Base URL: /api

• Auth: /auth
• Users: /users
• Groups: /groups
• Meals: /meals
• Costs: /costs

Notes

• Passwords are hashed with bcrypt.
• Protected endpoints require Authorization: Bearer <token>.