Skip to content

The "belle_donuts" project is a delightful GitHub repository that showcases the mouthwatering world of donut delivery, providing a seamless platform for managing orders, tracking deliveries, and ensuring customer satisfaction. Join us in this flavorful journey and make every bite a moment of pure joy.

Notifications You must be signed in to change notification settings

daniel-leal/belle_donuts

Repository files navigation

🍩 Belle Donuts - Administration Panel

CI License

This repository contains the source code of Belle Donuts, an administration panel developed using Elixir and Phoenix. Belle Donuts is a system designed for delivery restaurants that sell donuts. It allows for product management, order tracking, and configuration of opening hours. Additionally, it provides APIs for integration with the digital menu.

📋 Prerequisites

Before getting started with the configuration and execution of Belle Donuts, make sure your development environment meets the following prerequisites:

  • Elixir (version 1.11 or higher)
  • Erlang (version 23 or higher)
  • Phoenix (version 1.6 or higher)
  • PostgreSQL (version 10 or higher)

⚙️ Installation

Follow the steps below to set up the development environment and run Belle Donuts:

  1. Clone this repository to your local environment:

    git clone https://github.com/daniel-leal/belle_donuts.git
  2. Navigate to the project directory:

    cd belle_donuts
  3. Install project dependencies:

    mix deps.get
  4. Configure the database in the config/dev.exs file. Ensure that the configurations are correct for your local environment.

  5. Create and migrate the database:

    mix ecto.setup
  6. Start the Phoenix server:

    mix phx.server
  7. Open a web browser and access http://localhost:4000 to access the Belle Donuts administration panel.

  8. The credentials are on the seeds.exs file

🚀 Usage

Belle Donuts provides an intuitive interface for managing products, orders, and opening hours. Through the administration panel, you can perform the following tasks:

  • Add, edit, and delete products, including information such as name, description, price, and availability.
  • View the list of orders, including details such as customer, ordered items, and status.
  • Update the status of orders as they are processed.
  • Configure the restaurant's opening hours.

Additionally, Belle Donuts offers APIs for integration with the digital menu. These APIs allow other systems to consume data from Belle Donuts to display the menu in mobile apps, websites, and more.

🤝 Contributing

If you would like to contribute to the development of Belle Donuts, please follow the steps below:

  1. Fork this repository and clone it to your local environment.

  2. Create a new branch for your contribution:

    git checkout -b my-contribution
  3. Make the desired changes to the code.

  4. Run tests to ensure that the system is functioning correctly:

    mix test
  5. Commit your changes:

    git commit -m "My Contribution"
  6. Push the changes to your forked repository:

    git push origin my-contribution
  7. Open a pull request in this repository, describing your contribution and any relevant details.

Thank you for considering contributing to Belle Donuts! Your help is greatly appreciated. 💜

About

The "belle_donuts" project is a delightful GitHub repository that showcases the mouthwatering world of donut delivery, providing a seamless platform for managing orders, tracking deliveries, and ensuring customer satisfaction. Join us in this flavorful journey and make every bite a moment of pure joy.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published