{"id":24802624,"url":"https://github.com/siddh-coder/customer-billing-system","last_synced_at":"2025-03-25T05:36:04.962Z","repository":{"id":268499261,"uuid":"904546287","full_name":"siddh-coder/Customer-Billing-System","owner":"siddh-coder","description":"Windows-only Command Line Interface C-Project","archived":false,"fork":false,"pushed_at":"2024-12-17T05:29:16.000Z","size":20,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-01-30T05:15:49.746Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"C","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/siddh-coder.png","metadata":{"files":{"readme":"README.md","changelog":"history.c","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-12-17T05:25:06.000Z","updated_at":"2024-12-17T05:30:25.000Z","dependencies_parsed_at":"2024-12-17T06:26:22.825Z","dependency_job_id":"268b3997-77f9-446a-90e8-a4e58776f8d6","html_url":"https://github.com/siddh-coder/Customer-Billing-System","commit_stats":null,"previous_names":["siddh-coder/customer-billing-system"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/siddh-coder%2FCustomer-Billing-System","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/siddh-coder%2FCustomer-Billing-System/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/siddh-coder%2FCustomer-Billing-System/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/siddh-coder%2FCustomer-Billing-System/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/siddh-coder","download_url":"https://codeload.github.com/siddh-coder/Customer-Billing-System/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":245407758,"owners_count":20610232,"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":[],"created_at":"2025-01-30T05:15:55.549Z","updated_at":"2025-03-25T05:36:04.941Z","avatar_url":"https://github.com/siddh-coder.png","language":"C","funding_links":[],"categories":[],"sub_categories":[],"readme":"Grocery Shop Management System\r\n\r\nOverview\r\nThis is a Grocery Shop Management System implemented in C. \r\nIt provides functionalities to manage a grocery shop's inventory, place orders, generate bills, and maintain sales reports. \r\nThe system features an interactive console interface with color-coded outputs for a better user experience.\r\nThe program is specifically tailored for any Grocery Shop and includes customizable shop details displayed prominently.\r\n\r\n------------------------------------------------------------------------------\r\nFeatures\r\n\r\n1. Inventory Management\r\n   - Add new items to the inventory.\r\n   - View all inventory items.\r\n   - Edit the price or quantity of existing items.\r\n   - Remove items from the inventory.\r\n   - View inventory items by category.\r\n\r\n2. Shop Operations\r\n   - Place orders and generate bills.\r\n   - View sales reports.\r\n   - Maintain and view order history.\r\n   - Edit shop details, such as name, address, and contact information.\r\n\r\n3. Interactive Menu\r\n   - Color-coded and user-friendly interface for easier navigation.\r\n   - Command-line arguments for quick access to specific features.\r\n\r\n-------------------------------------------------------------------------------\r\n\r\nRequirements\r\n\r\n- A C compiler (e.g., GCC).\r\n- The code is designed for Windows and relies on Windows-specific APIs.\r\n\r\n-------------------------------------------------------------------------------\r\nInstallation and Setup\r\n\r\n1. Clone the repository or copy the source files into your project directory.\r\n\r\n2. Ensure the following files are available:\r\n   - 'final.c': The main program source file.\r\n   - 'heads.h': Header file with function declarations.\r\n   - 'Makefile': Used to build the executable out of the source(.c) files. \r\n\r\n3. Compile the program using a C compiler, such as GCC:\r\n   Run the makefile by typing 'make' on your computer. \r\n   (Make sure that environment variable to \"C:\\MinGW\\msys\\1.0\\bin\" is set.)\r\n\r\n4. Run the program as per the instructions below.\r\n\r\n-----------------------------------------------------------------------------------------\r\n\r\nUsage\r\n\r\nThe program can be used in two modes: **Command-line mode** and **Interactive menu mode**.\r\n\r\nCommand-Line Mode\r\n- Run the program with specific arguments for quick actions. Examples:\r\n  -            '-i': View the inventory.\r\n  -            '-o': Place an order and generate a bill.\r\n  -            '-h': View order history.\r\n  -            '-g': View items in a specific group.\r\n  -           '-ep': Edit the price of an item.\r\n  -           '-eq': Edit the quantity of an item.\r\n  - '-r' or '--rem': Remove an item from the inventory.\r\n  - '-a' or '--add': Add a new item to the inventory.\r\n\r\nExample command:\r\n```\r\nshopApp.exe -i\r\n\r\n```\r\n------------------------------------------------------------------------------------------------------------------\r\nInteractive Menu Mode\r\n- Run the program without arguments to start the interactive menu:\r\n  ```\r\n  shopApp.exe\r\n\r\n  ```\r\n- Follow the prompts to perform various operations, such as viewing the inventory, adding items, or placing orders.\r\n-------------------------------------------------------------------------------------------------------------------\r\n\r\nFile Descriptions\r\n\r\n1. \"shop_details.txt\":\r\n   This file contains the shop's name, address, and phone number. The information is displayed at the top of the menu and reports.\r\n\r\n   Example:\r\n   ```\r\n   The Green Basket\r\n   123 Market Lane, Downtown\r\n   +1-800-555-1234\r\n   ```\r\n\r\n2. \"inventory.txt\":\r\n   This file stores inventory data, including categories, product names, quantities, prices, expiry dates, and units.\r\n\r\n   Example:\r\n   ```\r\n   Fruits\r\n   SNo.       Product Name         Quantity       Price in Rs       Expiry Date         Unit\r\n   1          Apple                50             100               2024-12-31         Rs per kg\r\n   ```\r\n\r\n--------------------------------------------------------------------------------------------------------------------\r\n\r\nFeatures Breakdown\r\nInventory Management\r\n- Add Item: Specify details such as category, product name, quantity, price, expiry date, and unit to add a new item.\r\n- View Inventory: Display all items in the inventory, grouped by categories.\r\n- Edit Price/Quantity: Modify the price or quantity of an existing item.\r\n- Remove Item: Delete an item from the inventory.\r\n- View by Group: Filter items based on specific categories.\r\n\r\nOrder Management\r\n- Place an order by selecting items and quantities.\r\n- Automatically deduct ordered quantities from the inventory.\r\n- Generate a bill for the order.\r\n\r\nReports and History\r\n- View a detailed sales report, including total revenue generated.\r\n- Access the history of all previous orders.\r\n\r\n---\r\n\r\nDeveloper Notes\r\n\r\n- The program uses Windows-specific APIs for console operations (e.g., setting text color and clearing the screen). \r\n  It will not work on non-Windows systems without modification.\r\n\r\n---\r\n\r\nLimitations\r\n\r\n1. Windows-Specific: The program relies on Windows APIs and is not cross-platform.\r\n2. File Corruption: If `inventory.txt` or `shop_details.txt` is corrupted, the program may crash or behave unpredictably.\r\n\r\n---\r\nCredits\r\n\r\nEdit Shop Details and Sales Report - Romir Gupta(BT2024195)\r\n\r\nShow Inventory and Show Group      - Aditya Mittal(BT2024188)\r\n\r\nEdit Price and Edit Quantity       - Divyanshu Ghosh(IMT2024068)\r\n\r\nAdd and Delete Inventory           - Devaang Rastogi(BT2024031)\r\n\r\nExit and Testing                   - Mayank Ray(IMT2024052)\r\n\r\nPlace order and Order History      - Siddharth Brijesh Tripathi(IMT2024011)\r\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsiddh-coder%2Fcustomer-billing-system","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsiddh-coder%2Fcustomer-billing-system","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsiddh-coder%2Fcustomer-billing-system/lists"}