whatisgithub

What is restaurant-dish-inventory-bot?

hiswattson456/restaurant-dish-inventory-bot — explained in plain English

Analysis updated 2026-05-18

1JavaScriptAudience · ops devopsComplexity · 4/5Setup · hard

In one sentence

A Telegram bot and web admin panel that lets restaurant staff report broken tableware and lets managers track and act on those reports.

Mindmap

mindmap
  root((repo))
    What it does
      Telegram breakage reports
      Web admin panel
      Photo and reason logging
    Tech stack
      Node.js
      Telegraf
      Express
      Supabase
      Redis
    Use cases
      Track dish breakage
      Manage warehouse inventory
      Review staff reports
    Audience
      Restaurant managers
      Restaurant staff
      Small business ops

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Let restaurant staff report a broken dish from their phone through Telegram with a photo attached

USE CASE 2

Give managers a web dashboard to review, approve, and track breakage reports across warehouses

USE CASE 3

Maintain a catalog of tableware items and categories per warehouse location

What is it built with?

Node.jsTelegrafExpressSupabasePostgreSQLRedisNginx

How does it compare?

hiswattson456/restaurant-dish-inventory-botacip/slack-claude-agentadii0906/supportiq
Stars111
LanguageJavaScriptJavaScriptJavaScript
Setup difficultyhardmoderatemoderate
Complexity4/53/53/5
Audienceops devopsdeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · hard Time to first run · 1h+

Requires setting up Supabase, Redis, Nginx with HTTPS, and a Telegram bot token.

So what is it?

This is a two part system for restaurant staff to track and report tableware breakage. The first part is a Telegram bot that employees use directly from their phones: after registering with a name and access password, a worker can browse warehouses and tableware categories, find the specific item that broke, enter a quantity, choose a reason for the breakage, attach a photo, and submit the report, all within the Telegram chat interface. Once confirmed, the report is automatically forwarded to a designated admin Telegram group. The second part is a web based admin panel that managers access through a browser. From there, an administrator can set up warehouses and tableware categories, maintain the item catalog, review and action breakage requests, manage employee accounts, and adjust bot settings. Admin accounts are protected by their own authentication system. Under the hood the application is written in JavaScript on Node.js, using the Telegraf library for the Telegram bot and Express for the admin web panel. It stores data in a Supabase hosted PostgreSQL database, uses Redis to handle sessions and caching, and runs behind an Nginx reverse proxy with HTTPS via Let's Encrypt. A process manager called PM2 keeps the application running continuously on a server, and deployment can be automated through GitHub Actions. The project is described as private software built for internal use within a restaurant. The overall goal is to replace an informal process, such as staff verbally telling a manager about a broken plate or writing it on paper, with a structured digital record that a manager can search and act on. Because the bot lives inside Telegram, staff do not need to learn a new app or log into a separate system, they just open a chat they likely already have installed on their phone. The admin panel gives managers the oversight layer on top of that, letting them see breakage trends across warehouses and categories over time.

Copy-paste prompts

Prompt 1
Explain how a staff member submits a breakage report using this project's Telegram bot flow
Prompt 2
Walk me through deploying this bot and admin panel with PM2 and Nginx on a server
Prompt 3
Show me the data model this project likely uses in its Supabase PostgreSQL database for warehouses and reports

Frequently asked questions

What is restaurant-dish-inventory-bot?

A Telegram bot and web admin panel that lets restaurant staff report broken tableware and lets managers track and act on those reports.

What language is restaurant-dish-inventory-bot written in?

Mainly JavaScript. The stack also includes Node.js, Telegraf, Express.

How hard is restaurant-dish-inventory-bot to set up?

Setup difficulty is rated hard, with roughly 1h+ to a first successful run.

Who is restaurant-dish-inventory-bot for?

Mainly ops devops.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.