{"id":21358386,"url":"https://github.com/danzigerrr/inventory-management-system-using-django","last_synced_at":"2025-03-16T06:16:56.625Z","repository":{"id":250924921,"uuid":"835358033","full_name":"Danzigerrr/Inventory-Management-System-using-Django","owner":"Danzigerrr","description":"This Django-based web application helps small businesses manage inventory, process sales, and generate reports.","archived":false,"fork":false,"pushed_at":"2024-10-04T10:04:00.000Z","size":1079,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-01-22T18:34:25.455Z","etag":null,"topics":["django","inventory-management-system","mit-license","open-source","python","reporting","sales-management-system","user-authentication","web-application"],"latest_commit_sha":null,"homepage":"https://danzigerrrinventorymanager.pythonanywhere.com/","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Danzigerrr.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","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-07-29T17:06:49.000Z","updated_at":"2024-10-04T10:03:52.000Z","dependencies_parsed_at":"2025-01-22T18:40:36.690Z","dependency_job_id":null,"html_url":"https://github.com/Danzigerrr/Inventory-Management-System-using-Django","commit_stats":null,"previous_names":["danzigerrr/inventory-management-system-using-django"],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Danzigerrr%2FInventory-Management-System-using-Django","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Danzigerrr%2FInventory-Management-System-using-Django/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Danzigerrr%2FInventory-Management-System-using-Django/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Danzigerrr%2FInventory-Management-System-using-Django/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Danzigerrr","download_url":"https://codeload.github.com/Danzigerrr/Inventory-Management-System-using-Django/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243830955,"owners_count":20354856,"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":["django","inventory-management-system","mit-license","open-source","python","reporting","sales-management-system","user-authentication","web-application"],"created_at":"2024-11-22T05:16:03.398Z","updated_at":"2025-03-16T06:16:56.600Z","avatar_url":"https://github.com/Danzigerrr.png","language":"Python","readme":"\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://www.google.com/url?sa=i\u0026url=https%3A%2F%2Fwww.freepik.com%2Fpremium-vector%2Fweather-infographic-line-climate-forecast-banner-with-rain-sunny-cold-day-elements-clouds-sky-moon-icons-precipitation-cloudiness-prediction-vector-meteorology-background_33099939.htm\u0026psig=AOvVaw2MkwMPrTj5Qa60n1F8LWEi\u0026ust=1721297430172000\u0026source=images\u0026cd=vfe\u0026opi=89978449\u0026ved=0CBEQjRxqFwoTCMjzn-HqrYcDFQAAAAAdAAAAABAE\" \ntarget=\"blank\"\u003e\u003cimg src=\"READMEImages/repo_banner.png\" width=\"500\" alt=\"Repo Banner\" /\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n# Inventory and Sales Management System\n\n![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)\n![Build Status](https://github.com/Danzigerrr/Inventory-Management-System-using-Django/actions/workflows/djangoCI.yml/badge.svg)\n![Python Version](https://img.shields.io/badge/python-3.8%2B-blue)\n![Django Version](https://img.shields.io/badge/django-3.2%2B-green)\n\nThis is a Django-based web application designed to manage the inventory and sales for a small business that sells handmade crafts and art supplies. The application provides functionalities to track inventory levels, process sales, and generate reports.\n\n**The application is live here: [Demo link](https://danzigerrrinventorymanager.pythonanywhere.com/).** The project is hosted on [PythonAnywhere](https://help.pythonanywhere.com/pages/DeployExistingDjangoProject/) ❤️🐍\n\n## Features\n\n- **Inventory Management**: Track stock levels, receive new inventory, and update inventory levels as items are sold.\n- **Sales Processing**: Process sales in both the physical store and the online store, and automatically update inventory levels accordingly.\n- **Reporting**: Generate reports on sales, inventory levels, and customer data, such as popular products and customer purchase histories.\n- **User-Friendly Interface**: Easy-to-use interface for the business owner and employees.\n- **Security**: Password-protected access and regular data backups.\n- **Scalability**: Designed to accommodate future business growth.\n\n## Installation\n\n1. **Clone the Repository**\n   ```bash\n   git clone https://github.com/Danzigerrr/Inventory-Management-System-using-Django.git\n   cd inventory_management\n   ```\n\n2. **Create and Activate a Virtual Environment**\n   ```bash\n   python -m venv venv\n   source source .venv/Scripts/activate\n\n   ```\n\n3. **Install Dependencies**\n   ```bash\n   pip install -r requirements.txt\n   ```\n\n4. **Run Migrations**\n   ```bash\n   python manage.py migrate\n   ```\n\n5. **Insert sample data into database**\n   ```bash\n   python manage.py populate_db\n   ```\n   \n6. **Create a Superuser**\n   ```bash\n   python manage.py createsuperuser\n   ```\n\n7. **Run the Development Server**\n   ```bash\n   python manage.py runserver\n   ```\n\n8. **Access the Application**\n    - Open your browser and go to `http://127.0.0.1:8000/`\n\n## Usage\n\n### Admin Interface\n\n- Visit `http://127.0.0.1:8000/admin/` to access the Django admin interface.\n- Log in with the superuser credentials.\n- Manage products, inventory transactions, sales, and customer data through the admin interface.\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://www.google.com/url?sa=i\u0026url=https%3A%2F%2Fwww.freepik.com%2Fpremium-vector%2Fweather-infographic-line-climate-forecast-banner-with-rain-sunny-cold-day-elements-clouds-sky-moon-icons-precipitation-cloudiness-prediction-vector-meteorology-background_33099939.htm\u0026psig=AOvVaw2MkwMPrTj5Qa60n1F8LWEi\u0026ust=1721297430172000\u0026source=images\u0026cd=vfe\u0026opi=89978449\u0026ved=0CBEQjRxqFwoTCMjzn-HqrYcDFQAAAAAdAAAAABAE\" \ntarget=\"blank\"\u003e\u003cimg src=\"READMEImages/admin_page.png\" width=\"500\" alt=\"Django Admin Page\" /\u003e\u003c/a\u003e\n\u003c/p\u003e\n\nThe admin can also log in to the system and manage the inventory, sales, and customer data through the provided interface.\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://www.google.com/url?sa=i\u0026url=https%3A%2F%2Fwww.freepik.com%2Fpremium-vector%2Fweather-infographic-line-climate-forecast-banner-with-rain-sunny-cold-day-elements-clouds-sky-moon-icons-precipitation-cloudiness-prediction-vector-meteorology-background_33099939.htm\u0026psig=AOvVaw2MkwMPrTj5Qa60n1F8LWEi\u0026ust=1721297430172000\u0026source=images\u0026cd=vfe\u0026opi=89978449\u0026ved=0CBEQjRxqFwoTCMjzn-HqrYcDFQAAAAAdAAAAABAE\" \ntarget=\"blank\"\u003e\u003cimg src=\"READMEImages/admin_page_with_menu.png\" width=\"500\" alt=\"Application Admin Page\" /\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n\n### Main Application for Users\n\n- **Searching products**: Navigate to `/inventory/search/` to search for products by name.\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://www.google.com/url?sa=i\u0026url=https%3A%2F%2Fwww.freepik.com%2Fpremium-vector%2Fweather-infographic-line-climate-forecast-banner-with-rain-sunny-cold-day-elements-clouds-sky-moon-icons-precipitation-cloudiness-prediction-vector-meteorology-background_33099939.htm\u0026psig=AOvVaw2MkwMPrTj5Qa60n1F8LWEi\u0026ust=1721297430172000\u0026source=images\u0026cd=vfe\u0026opi=89978449\u0026ved=0CBEQjRxqFwoTCMjzn-HqrYcDFQAAAAAdAAAAABAE\" \ntarget=\"blank\"\u003e\u003cimg src=\"READMEImages/user_page_view.png\" width=\"500\" alt=\"User Page - profile\" /\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n- **Purchase Products**: Selected a product to buy it and specify the quantity.\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://www.google.com/url?sa=i\u0026url=https%3A%2F%2Fwww.freepik.com%2Fpremium-vector%2Fweather-infographic-line-climate-forecast-banner-with-rain-sunny-cold-day-elements-clouds-sky-moon-icons-precipitation-cloudiness-prediction-vector-meteorology-background_33099939.htm\u0026psig=AOvVaw2MkwMPrTj5Qa60n1F8LWEi\u0026ust=1721297430172000\u0026source=images\u0026cd=vfe\u0026opi=89978449\u0026ved=0CBEQjRxqFwoTCMjzn-HqrYcDFQAAAAAdAAAAABAE\" \ntarget=\"blank\"\u003e\u003cimg src=\"READMEImages/user_search_for_products.png\" width=\"500\" alt=\"User Page - search for products\" /\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n- **Check Purchased Products**: Navigate to `/users/profile/` to view profile details and purchasing history.\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://www.google.com/url?sa=i\u0026url=https%3A%2F%2Fwww.freepik.com%2Fpremium-vector%2Fweather-infographic-line-climate-forecast-banner-with-rain-sunny-cold-day-elements-clouds-sky-moon-icons-precipitation-cloudiness-prediction-vector-meteorology-background_33099939.htm\u0026psig=AOvVaw2MkwMPrTj5Qa60n1F8LWEi\u0026ust=1721297430172000\u0026source=images\u0026cd=vfe\u0026opi=89978449\u0026ved=0CBEQjRxqFwoTCMjzn-HqrYcDFQAAAAAdAAAAABAE\" \ntarget=\"blank\"\u003e\u003cimg src=\"READMEImages/user_buy_product.png\" width=\"500\" alt=\"User Page - buy products\" /\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n## Testing\nTo run the tests use the following command:\n```bash\npython manage.py test\n```\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://www.google.com/url?sa=i\u0026url=https%3A%2F%2Fwww.freepik.com%2Fpremium-vector%2Fweather-infographic-line-climate-forecast-banner-with-rain-sunny-cold-day-elements-clouds-sky-moon-icons-precipitation-cloudiness-prediction-vector-meteorology-background_33099939.htm\u0026psig=AOvVaw2MkwMPrTj5Qa60n1F8LWEi\u0026ust=1721297430172000\u0026source=images\u0026cd=vfe\u0026opi=89978449\u0026ved=0CBEQjRxqFwoTCMjzn-HqrYcDFQAAAAAdAAAAABAE\" \ntarget=\"blank\"\u003e\u003cimg src=\"READMEImages/unit_tests_results.png\" width=\"500\" alt=\"Unit Tests Results\" /\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n\n## Contributing\n\nContributions are welcome! Please fork the repository and submit a pull request.\n\n## License\n\nThis project is licensed under the [MIT licensed](LICENSE).\n\n## Stay in touch\n**Author - Krzysztof Nazar**:\n- [Linkedin](https://www.linkedin.com/in/krzysztofnazar/)\n- [GitHub](https://github.com/Danzigerrr)\n\n\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdanzigerrr%2Finventory-management-system-using-django","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdanzigerrr%2Finventory-management-system-using-django","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdanzigerrr%2Finventory-management-system-using-django/lists"}