Metadata-Version: 2.4
Name: inventory-optimizer
Version: 0.1.0
Summary: Inventory optimization under uncertain demand (classic and robust Newsboy).
Author: emilianob-ux
License: MIT
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: numpy<3,>=1.24
Requires-Dist: pandas<3,>=2.0
Requires-Dist: scipy<2,>=1.10
Requires-Dist: matplotlib<4,>=3.7
Provides-Extra: dev
Requires-Dist: pytest<9,>=8; extra == "dev"
Requires-Dist: pytest-cov<6,>=5; extra == "dev"
Requires-Dist: ruff<1,>=0.9; extra == "dev"
Requires-Dist: pre-commit<5,>=4; extra == "dev"
Requires-Dist: mkdocs<2,>=1.6; extra == "dev"
Requires-Dist: mkdocs-material<10,>=9; extra == "dev"
Requires-Dist: jupyter<2,>=1; extra == "dev"
Dynamic: license-file

# inventory-optimizer

[![Python](https://img.shields.io/badge/python-3.10%20%7C%203.11%20%7C%203.12-blue.svg)](https://www.python.org/downloads/)
[![CI](https://github.com/emilianob-ux/inventory-optimizer/actions/workflows/ci.yml/badge.svg)](https://github.com/emilianob-ux/inventory-optimizer/actions/workflows/ci.yml)
[![Coverage](https://codecov.io/gh/emilianob-ux/inventory-optimizer/branch/main/graph/badge.svg)](https://codecov.io/gh/emilianob-ux/inventory-optimizer)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)

Optimizacion de inventario bajo demanda incierta con enfoque clasico Newsboy y variante robusta.

## Ecuacion central

\[
Q^* = F_D^{-1}\left(\frac{p}{p+h}\right)
\]

## Demo rapida

```python
from inventory_optimizer import NewsboyOptimizer

opt = NewsboyOptimizer(holding_cost=1.0, shortage_cost=4.0)
opt.fit(("normal", 100.0, 20.0))
print(round(opt.optimal_order(), 2))
```

## Visualizaciones

- `docs/images/pareto.png`
- `docs/images/sensitivity.png`
- `docs/images/walk_forward.png`
- `docs/images/convergence.png`

![Pareto](docs/images/pareto.png)
![Sensitivity](docs/images/sensitivity.png)

## Instalacion

```bash
pip install -e ".[dev]"
```

## Estructura

- `src/inventory_optimizer`: libreria principal
- `tests`: pruebas unitarias
- `examples`: ejemplos ejecutables
- `notebooks`: tutoriales interactivos
- `docs`: documentacion MkDocs

## Estado

- v0.1.0: implementacion base clasica, robusta simplificada, simulacion, validacion temporal y CI.

## Contribuir

Ver [CONTRIBUTING.md](CONTRIBUTING.md).
