backorder 0.1.0__tar.gz

backorder-0.1.0/PKG-INFO

@@ -0,0 +1,51 @@
+Metadata-Version: 2.4
+Name: backorder
+Version: 0.1.0
+Summary: Lightweight Python utility for supply chain metrics, EOQ, safety stock, and inventory modeling.
+Author-email: Albergracht Technologies <technologies@albergracht.com>
+License-Expression: MIT
+Keywords: backorder,inventory,supply-chain,eoq,ecommerce,logistics
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+
+# 📦 backorder (alpha)
+
+A lightweight, zero-dependency Python utility for e-commerce inventory management, supply chain calculations, and backorder mitigation. 
+
+Features include Economic Order Quantity (EOQ), Safety Stock calculation, and Reorder Point (ROP) modeling.
+
+## ⚡ Installation
+
+```bash
+pip install backorder
+```
+
+## 🚀 Quickstart
+
+```bash
+import backorder
+
+# 1. Economic Order Quantity (EOQ)
+# Balances the cost of ordering against the cost of holding inventory.
+optimal_qty = backorder.economic_order_quantity(
+    annual_demand=10000, 
+    order_cost=50.0, 
+    holding_cost_per_unit=2.5
+)
+print(f"Optimal Order Quantity (EOQ): {optimal_qty} units")
+
+# 2. Reorder Point & Safety Stock
+# Calculates exactly when to reorder to prevent backorders.
+model = backorder.InventoryModel(
+    average_daily_demand=30,
+    max_daily_demand=45,
+    average_lead_time_days=7,
+    max_lead_time_days=10
+)
+
+print(f"Safety Stock Needed: {model.safety_stock} units")
+print(f"Reorder Point (ROP): {model.reorder_point} units")
+```
+
+## ⚠️ Disclaimer
+This package provides mathematical models for supply chain estimates. It does not replace comprehensive ERP systems. Real-world supply chains are subject to unpredictable disruptions.

backorder-0.1.0/README.md

@@ -0,0 +1,41 @@
+# 📦 backorder (alpha)
+
+A lightweight, zero-dependency Python utility for e-commerce inventory management, supply chain calculations, and backorder mitigation. 
+
+Features include Economic Order Quantity (EOQ), Safety Stock calculation, and Reorder Point (ROP) modeling.
+
+## ⚡ Installation
+
+```bash
+pip install backorder
+```
+
+## 🚀 Quickstart
+
+```bash
+import backorder
+
+# 1. Economic Order Quantity (EOQ)
+# Balances the cost of ordering against the cost of holding inventory.
+optimal_qty = backorder.economic_order_quantity(
+    annual_demand=10000, 
+    order_cost=50.0, 
+    holding_cost_per_unit=2.5
+)
+print(f"Optimal Order Quantity (EOQ): {optimal_qty} units")
+
+# 2. Reorder Point & Safety Stock
+# Calculates exactly when to reorder to prevent backorders.
+model = backorder.InventoryModel(
+    average_daily_demand=30,
+    max_daily_demand=45,
+    average_lead_time_days=7,
+    max_lead_time_days=10
+)
+
+print(f"Safety Stock Needed: {model.safety_stock} units")
+print(f"Reorder Point (ROP): {model.reorder_point} units")
+```
+
+## ⚠️ Disclaimer
+This package provides mathematical models for supply chain estimates. It does not replace comprehensive ERP systems. Real-world supply chains are subject to unpredictable disruptions.

backorder-0.1.0/backorder/__init__.py

@@ -0,0 +1,4 @@
+from .inventory import InventoryModel, economic_order_quantity, LEGAL_DISCLAIMER
+
+__version__ = "0.1.0"
+__all__ = ["InventoryModel", "economic_order_quantity", "LEGAL_DISCLAIMER"]

backorder-0.1.0/backorder/inventory.py

@@ -0,0 +1,57 @@
+import math
+from dataclasses import dataclass
+from typing import Dict, Any
+
+LEGAL_DISCLAIMER = "Informational supply chain calculations only. Does not replace enterprise ERP systems."
+
+
+def economic_order_quantity(annual_demand: float, order_cost: float, holding_cost_per_unit: float) -> int:
+    """
+    Calculates the Economic Order Quantity (EOQ).
+    Formula: sqrt((2 * Demand * OrderCost) / HoldingCost)
+    Returns the optimal number of units to order to minimize total inventory costs.
+    """
+    if holding_cost_per_unit <= 0:
+        raise ValueError("Holding cost must be greater than zero.")
+    if annual_demand < 0 or order_cost < 0:
+        raise ValueError("Demand and order cost cannot be negative.")
+        
+    eoq = math.sqrt((2.0 * annual_demand * order_cost) / holding_cost_per_unit)
+    return math.ceil(eoq)
+
+
+@dataclass
+class InventoryModel:
+    average_daily_demand: float
+    max_daily_demand: float
+    average_lead_time_days: float
+    max_lead_time_days: float
+
+    @property
+    def safety_stock(self) -> int:
+        """
+        Calculates the Safety Stock required to prevent backorders during lead time variability.
+        Formula: (Max Demand * Max Lead Time) - (Average Demand * Average Lead Time)
+        """
+        max_scenario = self.max_daily_demand * self.max_lead_time_days
+        avg_scenario = self.average_daily_demand * self.average_lead_time_days
+        stock = max_scenario - avg_scenario
+        return max(0, math.ceil(stock))
+
+    @property
+    def reorder_point(self) -> int:
+        """
+        Calculates the Reorder Point (ROP) - the inventory level at which a new order should be placed.
+        Formula: (Average Daily Demand * Average Lead Time) + Safety Stock
+        """
+        lead_time_demand = self.average_daily_demand * self.average_lead_time_days
+        return math.ceil(lead_time_demand + self.safety_stock)
+
+    def summary(self) -> Dict[str, Any]:
+        return {
+            "average_daily_demand": self.average_daily_demand,
+            "average_lead_time_days": self.average_lead_time_days,
+            "safety_stock": self.safety_stock,
+            "reorder_point": self.reorder_point,
+            "disclaimer": LEGAL_DISCLAIMER
+        }

backorder-0.1.0/backorder.egg-info/PKG-INFO

@@ -0,0 +1,51 @@
+Metadata-Version: 2.4
+Name: backorder
+Version: 0.1.0
+Summary: Lightweight Python utility for supply chain metrics, EOQ, safety stock, and inventory modeling.
+Author-email: Albergracht Technologies <technologies@albergracht.com>
+License-Expression: MIT
+Keywords: backorder,inventory,supply-chain,eoq,ecommerce,logistics
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+
+# 📦 backorder (alpha)
+
+A lightweight, zero-dependency Python utility for e-commerce inventory management, supply chain calculations, and backorder mitigation. 
+
+Features include Economic Order Quantity (EOQ), Safety Stock calculation, and Reorder Point (ROP) modeling.
+
+## ⚡ Installation
+
+```bash
+pip install backorder
+```
+
+## 🚀 Quickstart
+
+```bash
+import backorder
+
+# 1. Economic Order Quantity (EOQ)
+# Balances the cost of ordering against the cost of holding inventory.
+optimal_qty = backorder.economic_order_quantity(
+    annual_demand=10000, 
+    order_cost=50.0, 
+    holding_cost_per_unit=2.5
+)
+print(f"Optimal Order Quantity (EOQ): {optimal_qty} units")
+
+# 2. Reorder Point & Safety Stock
+# Calculates exactly when to reorder to prevent backorders.
+model = backorder.InventoryModel(
+    average_daily_demand=30,
+    max_daily_demand=45,
+    average_lead_time_days=7,
+    max_lead_time_days=10
+)
+
+print(f"Safety Stock Needed: {model.safety_stock} units")
+print(f"Reorder Point (ROP): {model.reorder_point} units")
+```
+
+## ⚠️ Disclaimer
+This package provides mathematical models for supply chain estimates. It does not replace comprehensive ERP systems. Real-world supply chains are subject to unpredictable disruptions.

backorder-0.1.0/backorder.egg-info/SOURCES.txt

@@ -0,0 +1,8 @@
+README.md
+pyproject.toml
+backorder/__init__.py
+backorder/inventory.py
+backorder.egg-info/PKG-INFO
+backorder.egg-info/SOURCES.txt
+backorder.egg-info/dependency_links.txt
+backorder.egg-info/top_level.txt

backorder-0.1.0/backorder.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

backorder-0.1.0/backorder.egg-info/top_level.txt

@@ -0,0 +1 @@
+backorder

backorder-0.1.0/pyproject.toml

@@ -0,0 +1,19 @@
+[build-system]
+requires = ["setuptools>=61.0"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "backorder"
+version = "0.1.0"
+description = "Lightweight Python utility for supply chain metrics, EOQ, safety stock, and inventory modeling."
+readme = "README.md"
+license = "MIT"
+requires-python = ">=3.8"
+authors = [
+    { name = "Albergracht Technologies", email = "technologies@albergracht.com" },
+]
+keywords = ["backorder", "inventory", "supply-chain", "eoq", "ecommerce", "logistics"]
+
+[tool.setuptools.packages.find]
+where = ["."]
+include = ["backorder*"]

backorder-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+