{"id":21327592,"url":"https://github.com/hamada-khairi/assembly","last_synced_at":"2025-03-16T00:14:11.468Z","repository":{"id":282635969,"uuid":"858311372","full_name":"Hamada-khairi/Assembly","owner":"Hamada-khairi","description":"A DOS-based Assembly program designed to streamline coffee shop operations through inventory tracking, sales processing, and stock management. The system, built with TASM, enables efficient handling of coffee items, real-time sales processing, and detailed reporting in a user-friendly DOS interface.","archived":false,"fork":false,"pushed_at":"2024-09-16T17:54:06.000Z","size":24,"stargazers_count":1,"open_issues_count":0,"forks_count":1,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-03-16T00:14:06.620Z","etag":null,"topics":["assembly-language-programming","assembly-programming","assembly-project","cafe-software","coffee-shop-management","crud-application","inventory-system","sales-tracking","stock-management-system","tasm-assembly"],"latest_commit_sha":null,"homepage":"https://hamadakh.com","language":"Assembly","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Hamada-khairi.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-09-16T17:17:42.000Z","updated_at":"2025-01-23T21:38:22.000Z","dependencies_parsed_at":"2025-03-16T00:14:07.651Z","dependency_job_id":null,"html_url":"https://github.com/Hamada-khairi/Assembly","commit_stats":null,"previous_names":["hamada-khairi/assembly"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Hamada-khairi%2FAssembly","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Hamada-khairi%2FAssembly/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Hamada-khairi%2FAssembly/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Hamada-khairi%2FAssembly/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Hamada-khairi","download_url":"https://codeload.github.com/Hamada-khairi/Assembly/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243806076,"owners_count":20350775,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["assembly-language-programming","assembly-programming","assembly-project","cafe-software","coffee-shop-management","crud-application","inventory-system","sales-tracking","stock-management-system","tasm-assembly"],"created_at":"2024-11-21T21:18:23.800Z","updated_at":"2025-03-16T00:14:11.461Z","avatar_url":"https://github.com/Hamada-khairi.png","language":"Assembly","funding_links":[],"categories":[],"sub_categories":[],"readme":"\n# ☕ Hamada Coffee Shop Management Program (Assembly)\n\n![image](https://github.com/user-attachments/assets/28915bb0-3870-442d-b3fb-fa5ce16c72e3)\n\n\nWelcome to **Hamada Coffee Shop**, a comprehensive program designed to manage a coffee shop's inventory, sales, and stock operations using Assembly language! This project is a demonstration of advanced Assembly coding for managing a real-world use case: a coffee shop. The system allows users to explore inventory, process sales, restock items, and view sales reports—all within an interactive DOS-based interface.\n\n---\n\n## 📋 Table of Contents\n\n- [🚀 Features](#-features)\n- [⚙️ Program Structure](#-program-structure)\n  - [Data](#data)\n  - [Procedures](#procedures)\n- [📦 Installation](#-installation)\n- [🎮 Usage](#-usage)\n  - [Main Menu](#main-menu)\n  - [Inventory Management](#inventory-management)\n  - [Sales Operations](#sales-operations)\n  - [Restocking Items](#restocking-items)\n  - [Sales Report](#sales-report)\n- [👨‍💻 Authors](#-authors)\n\n---\n\n## 🚀 Features\n\n- **Explore Coffee Shop Inventory**: View detailed information about each item (ID, Name, Stock, Price).\n- **Process Sales**: Sell items by entering their ID and quantity, with real-time inventory updates.\n- **Restock Inventory**: Easily replenish stock by selecting the item ID and specifying the amount.\n- **Arrange Inventory**: Sort items by availability, including highlighting items that need replenishment.\n- **Sales Summary**: Generate and display sales statistics, including total revenue earned.\n- **User-Friendly Interface**: Interactive menu for seamless navigation and operations.\n\n---\n\n## ⚙️ Program Structure\n\n### Data\nThe program stores key details about inventory items, including:\n- **Item ID**: Unique identifier for each product.\n- **Item Name**: Coffee types, e.g., Espresso, Cappuccino.\n- **Stock Level**: Quantity available for each item.\n- **Price**: Price of each coffee.\n- **Sales Information**: Number of items sold and total revenue generated.\n\n### Procedures\n\nThe program operates using a set of well-defined procedures:\n- **Main Menu**: The starting point of the program that allows users to navigate to different features.\n- **Inventory Management**: Displays the current stock and enables sorting based on availability.\n- **Sales Operations**: Allows users to process a sale by selecting items and updating stock in real time.\n- **Restocking Items**: Offers users the ability to replenish stock for selected items.\n- **Sales Report Generation**: Summarizes sales data, including the number of items sold and the total revenue.\n\n---\n\n## 📦 Installation\n\nTo run this Assembly language program on DOS, follow these steps:\n\n### Prerequisites:\n- **TASM** (Turbo Assembler) or equivalent assembler.\n- **DOSBox** or a similar DOS emulator.\n\n### Steps:\n1. Clone or download the program files.\n2. Open the program in your DOS-based emulator.\n3. Assemble the `.asm` file using the following commands:\n   ```bash\n   tasm /zi hamada_coffee_shop.asm\n   tlink /v hamada_coffee_shop.obj\n   ```\n4. Run the executable:\n   ```bash\n   hamada_coffee_shop.exe\n   ```\n\n---\n\n## 🎮 Usage\n\n### Main Menu\n\nWhen the program starts, the user is greeted with a **Main Menu**. From here, users can:\n- View inventory.\n- Process sales.\n- Restock items.\n- View sales reports.\n- Exit the program.\n\n### Inventory Management\n\n- **Explore Inventory**: Lists all coffee items with their respective stock levels, prices, and IDs.\n- **Restocking**: Users can add more stock to selected items.\n  \n⚠️ *Items that need replenishment are displayed in **red**.*\n\n### Sales Operations\n\n- Users can sell items by entering the **item ID** and the **quantity**.\n- If the stock is insufficient, the program will notify the user with an error.\n  \n💡 *Once the sale is successful, the inventory is updated in real-time.*\n\n### Restocking Items\n\n- Select the item ID and specify the quantity to restock.\n- The system updates the inventory and confirms successful restocking.\n\n### Sales Report\n\n- **Sales Summary**: Displays the total number of items sold and total revenue generated.\n- Users can view the sales data for each item, including the quantity sold and revenue.\n\n---\n\n## Screenshots\n\n![image](https://github.com/user-attachments/assets/f367633c-aa7f-4b24-a939-8d59f0b5411d)\n\n![image](https://github.com/user-attachments/assets/82c8c18f-ac4e-45d4-9348-fc690124a14a)\n\n![image](https://github.com/user-attachments/assets/a1a5572d-89da-4b99-a86d-065fca6ef9bf)\n\n![image](https://github.com/user-attachments/assets/c9276b2c-da4a-460a-afd5-6bf988c099b9)\n\n\n\n\n## 👨‍💻 Authors\n\n- **TP066168**: Mohamed Khairy Mohamed Abdelraouf\n\nThis project was built as part of a programming course using Assembly language to develop a fully functional coffee shop management system.\n\n---\n\n## 🎯 Conclusion\n\nThe **Hamada Coffee Shop Program** demonstrates the power and flexibility of Assembly language in building real-world applications. With features like sales processing, inventory management, and a seamless user interface, this project highlights how low-level programming can be used to solve complex tasks.\n\n---\n\nThank you for visiting **Hamada Coffee Shop**! We hope you enjoyed exploring this project. ☕\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhamada-khairi%2Fassembly","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhamada-khairi%2Fassembly","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhamada-khairi%2Fassembly/lists"}