API Inventario
Microservicio REST para gestión de inventario (productos, categorías, stock).
Tech Stack
- Python 3.11 + FastAPI
- PostgreSQL + SQLAlchemy ORM
- Docker + docker-compose
Quick Start
Con Docker (recomendado)
docker-compose up -d
API disponible en http://localhost:8000 Swagger docs: http://localhost:8000/docs
Sin Docker
pip install -r requirements.txt
uvicorn app.main:app --reload --port 8000
API Endpoints
| Method | Endpoint | Descripción |
|---|---|---|
| GET | /health |
Health check |
| POST | /api/v1/categories |
Crear categoría |
| GET | /api/v1/categories |
Listar categorías |
| GET | /api/v1/categories/{id} |
Obtener categoría |
| PUT | /api/v1/categories/{id} |
Actualizar categoría |
| DELETE | /api/v1/categories/{id} |
Eliminar categoría |
| POST | /api/v1/products |
Crear producto |
| GET | /api/v1/products |
Listar productos (paginated) |
| GET | /api/v1/products/{id} |
Obtener producto |
| PUT | /api/v1/products/{id} |
Actualizar producto |
| DELETE | /api/v1/products/{id} |
Eliminar producto |
| GET | /api/v1/products/low-stock |
Productos con stock bajo |
| POST | /api/v1/stock/move |
Registrar movimiento |
| GET | /api/v1/stock/history/{product_id} |
Historial de movimientos |
Environment Variables
| Variable | Default | Description |
|---|---|---|
| DATABASE_URL | postgresql://user:pass@localhost:5432/inventario | PostgreSQL connection string |
| DEBUG | false | Modo debug |
| API_VERSION | v1 | API version prefix |
Proyecto
- Repositorio: https://gitea.danielarroyo.cl/proyectos/api-inventario
- Spec: SPEC.md