Skip to content

PolyannaMeira/hamburgueria-backend

Repository files navigation

🍔 Burger App

This is a Full Stack project developed as part of the DevClub course, with the goal of building a complete application to manage orders for a burger restaurant.


🚀 About the Project

DevBurguer is a web application that allows:

Customer:

  • View a menu of burgers and sides
  • Place orders online

Administrator:

  • Manage orders through the admin panel

The focus is on applying best development practices, backend integration, API consumption, and component organization in a real-world environment.


Login Screen

Menu Screen

Offers and Categories Screen

Cart Screen

Admin Screen

Products Screen


🛠️ Technologies Used

Frontend:

https://github.com/PolyannaMeira/hamburgueria-frontend

  • React (with React Hooks)
  • Axios (for HTTP requests)
  • React Router DOM (for routing)
  • Styled-Components or CSS Modules (for styling)
  • Context API (to manage global state)

Backend:

  • Node.js with Express
  • MongoDB with Mongoose
  • Dotenv (environment variables)
  • Cors (to allow requests)
  • Nodemon (for development)

Others:

  • Git & GitHub (version control)
  • Postman (to test the API)
  • Docker

📚 Learnings

During the development of DevBurguer, the following concepts were applied and learned:

  • Structuring a Full Stack project from scratch
  • Connecting frontend and backend using RESTful APIs
  • Creating private routes for administrators
  • Using MongoDB with Mongoose for data persistence
  • Code organization and componentization in React
  • Managing global state with Context API
  • Error handling on both frontend and backend
  • Securing sensitive information using .env files

🖥️ How to Run the Project Locally

⚙️ Prerequisites

Before starting, you will need to have installed:

🔧 Installation

  1. Clone the repository hamburgueria-frontend:
git clone https://github.com/PolyannaMeira/hamburgueria-frontend.git
cd Hamburgueria
  1. Clone the repository hamburgueria-backend:
git clone https://github.com/PolyannaMeira/hamburgueria-backend.git
cd Hamburgueria
  1. Configure the .env file:

Create a .env file inside the Devburger_API folder with the following variables (example):

PORT=5000
MONGO_URI=mongodb://localhost:27017/devburguer
JWT_SECRET=your_secret_key
  1. Start the backend:
npm run dev
  1. Install frontend and backend dependencies (if in a separate folder):
cd ../[frontend-folder]
npm install
  1. Start the frontend and the backend:
npm start

📂 Project Structure (Summary)



├── hamburgueria-backend/
│   ├── controllers/
│   ├── models/
│   ├── routes/
│   ├── .env (added to .gitignore)
│   ├── server.js
│   └── ...

├── hamburgueria-frontend/
│   ├── src/
│   ├── public/
│   └── ...
│


👩‍💻 Developed by

Polyanna Meira 🔗 GitHub 🔗 LinkedIn


⚠️ Warning

This project is intended for learning purposes. Sensitive information (such as API keys or database credentials) should not be versioned — use .env files with properly configured .gitignore.

Releases

No releases published

Packages

 
 
 

Contributors