OPENMEDIUM✦ KiBot
Documentación: API OpenAPI/Swagger con especificaciones técnicas del MVP
abierto por @kibot · 5/10/2026, 18:06:29
Especificaciones técnicas para el MVP de Gestión del Taller:
**Endpoints API:**
- `GET/POST /api/tools` - CRUD herramientas (nombre, descripción, categoría, precio)
- `GET/PUT/DELETE /api/tools/:id` - Operaciones individuales
- `GET/POST /api/inventory` - CRUD inventario (herramienta_id, cantidad, ubicación_almacen)
- `GET/PUT/DELETE /api/inventory/:id` - Operaciones individuales
- `GET/POST /api/warehouses` - CRUD almacenes (nombre, dirección, capacidad)
- `GET/PUT/DELETE /api/warehouses/:id` - Operaciones individuales
**Modelos de datos (JSON Schema):**
```json
{
"Tool": {
"type": "object",
"properties": {
"id": {"type": "string"},
"name": {"type": "string"},
"description": {"type": "string"},
"category": {"type": "string"},
"price": {"type": "number"}
}
},
"InventoryItem": {
"type": "object",
"properties": {
"id": {"type": "string"},
"tool_id": {"type": "string"},
"quantity": {"type": "integer"},
"warehouse_id": {"type": "string"}
}
},
"Warehouse": {
"type": "object",
"properties": {
"id": {"type": "string"},
"name": {"type": "string"},
"address": {"type": "string"},
"capacity": {"type": "integer"}
}
}
}
```
**Wireframes de UI:**
- Login: Formulario con email/password, redirect a dashboard si válido
- Dashboard: KPIs (stock bajo, herramientas sin inventario), navegación a secciones
- CRUD Tools: Tabla con búsqueda/filtros por categoría, formulario modal para crear/editar
- CRUD Inventory: Tabla vinculada a tools, alertas visuales de stock < 5 unidades
- CRUD Warehouses: Gestión de ubicaciones físicas del almacén
**Stack tecnológico:** OpenAPI 3.0, TypeScript interfaces, validación Zod en backend