operx-cli 0.6.0__tar.gz → 0.7.1__tar.gz

{operx_cli-0.6.0 → operx_cli-0.7.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: operx-cli
-Version: 0.6.0
+Version: 0.7.1
 Summary: La línea de comandos de OperX: tu empresa desde la terminal, con tu token de API.
 Requires-Python: >=3.10
 Description-Content-Type: text/markdown
@@ -118,6 +118,8 @@ operx ordenes asignar 1234 "Pedro Pérez"
 operx ordenes comentar 1234 "Llegó el repuesto"
 operx ordenes editar 1234 --prioridad critica --vence 05/11/2026
 operx ordenes adjuntar 1234 foto.jpg --momento despues
+operx ordenes repuestos 1234                   # lo planeado, lo usado y su costo
+operx ordenes repuesto 1234 --articulo FIL-010 --lugar "Bodega central" --cantidad 2
 
 operx reportes indicadores --dias 30           # MTTR, MTBF, cumplimiento de preventivos
 operx reportes vencidas
@@ -153,10 +155,12 @@ operx inventario traslado --articulo FIL-010 --cantidad 2 --de "Bodega central"
 operx inventario ajuste --articulo FIL-010 --lugar "Bodega central" --cantidad -1 --motivo Conteo
 operx inventario movimientos --articulo FIL-010
 operx inventario revertir 4512                 # deshace un movimiento equivocado
+operx inventario por-comprar                   # lo bajo el mínimo y las solicitudes aprobadas
 
 operx equipos parar BOM-04 --motivo Falla --minutos 90
 operx equipos reanudar 21
 operx equipos hallazgo BOM-04 --titulo "Fuga en el sello" --severidad alta
+operx equipos hallazgo-a-orden 8 --prioridad alta  # la orden para ese hallazgo
 operx lecturas anular 31 --motivo "Lectura de otro equipo"
 
 operx lecturas puntos BOM-04
@@ -165,6 +169,8 @@ operx lecturas registrar --punto 12 --valor 73,4
 operx personas listar --buscar pérez
 operx personas importar empleados.xlsx               # revisa el archivo, no guarda
 operx personas importar empleados.xlsx --confirmar   # guarda si ninguna fila tiene errores
+operx personas ausencia "Ana Ruiz" --tipo vacaciones --desde 02/11/2026 --hasta 06/11/2026
+operx personas ausencia "Ana Ruiz" --tipo permiso --desde 09/11/2026 --horas 08:00-10:00
 
 operx sst acciones --estado abiertas
 operx sst nueva-accion --titulo "Señalizar la salida" --para 15/11/2026 --responsable "Ana Ruiz"
@@ -221,9 +227,9 @@ tipo, si es obligatorio y los valores permitidos. También están en Acceso
 por API › Documentación:
 
 ```sh
-operx api rutas repuestos
-operx api campos inventory/work-orders/1234/parts/ --metodo POST
-operx api POST inventory/work-orders/1234/parts/ -d '{"action": "usar", "item": 3, "quantity": "2", "location": 2}'
+operx api rutas purchase requests
+operx api campos inventory/purchase-requests/ --metodo POST
+operx api POST inventory/purchase-requests/ -d '{"item": 3, "quantity": "10", "reason": "Bajo el mínimo"}'
 operx api GET pm/schedules/ -q search=compresor
 operx api POST contacts/ -d @contacto.json
 operx api GET work-orders/export/ -o ordenes.csv

{operx_cli-0.6.0 → operx_cli-0.7.1}/README.md

@@ -104,6 +104,8 @@ operx ordenes asignar 1234 "Pedro Pérez"
 operx ordenes comentar 1234 "Llegó el repuesto"
 operx ordenes editar 1234 --prioridad critica --vence 05/11/2026
 operx ordenes adjuntar 1234 foto.jpg --momento despues
+operx ordenes repuestos 1234                   # lo planeado, lo usado y su costo
+operx ordenes repuesto 1234 --articulo FIL-010 --lugar "Bodega central" --cantidad 2
 
 operx reportes indicadores --dias 30           # MTTR, MTBF, cumplimiento de preventivos
 operx reportes vencidas
@@ -139,10 +141,12 @@ operx inventario traslado --articulo FIL-010 --cantidad 2 --de "Bodega central"
 operx inventario ajuste --articulo FIL-010 --lugar "Bodega central" --cantidad -1 --motivo Conteo
 operx inventario movimientos --articulo FIL-010
 operx inventario revertir 4512                 # deshace un movimiento equivocado
+operx inventario por-comprar                   # lo bajo el mínimo y las solicitudes aprobadas
 
 operx equipos parar BOM-04 --motivo Falla --minutos 90
 operx equipos reanudar 21
 operx equipos hallazgo BOM-04 --titulo "Fuga en el sello" --severidad alta
+operx equipos hallazgo-a-orden 8 --prioridad alta  # la orden para ese hallazgo
 operx lecturas anular 31 --motivo "Lectura de otro equipo"
 
 operx lecturas puntos BOM-04
@@ -151,6 +155,8 @@ operx lecturas registrar --punto 12 --valor 73,4
 operx personas listar --buscar pérez
 operx personas importar empleados.xlsx               # revisa el archivo, no guarda
 operx personas importar empleados.xlsx --confirmar   # guarda si ninguna fila tiene errores
+operx personas ausencia "Ana Ruiz" --tipo vacaciones --desde 02/11/2026 --hasta 06/11/2026
+operx personas ausencia "Ana Ruiz" --tipo permiso --desde 09/11/2026 --horas 08:00-10:00
 
 operx sst acciones --estado abiertas
 operx sst nueva-accion --titulo "Señalizar la salida" --para 15/11/2026 --responsable "Ana Ruiz"
@@ -207,9 +213,9 @@ tipo, si es obligatorio y los valores permitidos. También están en Acceso
 por API › Documentación:
 
 ```sh
-operx api rutas repuestos
-operx api campos inventory/work-orders/1234/parts/ --metodo POST
-operx api POST inventory/work-orders/1234/parts/ -d '{"action": "usar", "item": 3, "quantity": "2", "location": 2}'
+operx api rutas purchase requests
+operx api campos inventory/purchase-requests/ --metodo POST
+operx api POST inventory/purchase-requests/ -d '{"item": 3, "quantity": "10", "reason": "Bajo el mínimo"}'
 operx api GET pm/schedules/ -q search=compresor
 operx api POST contacts/ -d @contacto.json
 operx api GET work-orders/export/ -o ordenes.csv

{operx_cli-0.6.0 → operx_cli-0.7.1}/operx_cli/AGENTES.md

@@ -59,16 +59,19 @@ llamada queda en el historial del token, marcada como hecha desde la CLI.
 
 - Todos los comandos que escriben aceptan `--json`: la salida es solo la
   respuesta de la API (el registro, con su `id`). Úsalo para encadenar pasos.
-- Escriben: `ordenes crear`, `ordenes editar`, `ordenes estado`,
-  `ordenes asignar`, `ordenes comentar`, `ordenes adjuntar`,
-  `preventivos crear`, `preventivos nota`, `equipos crear`, `equipos editar`,
-  `equipos parar`, `equipos reanudar`, `equipos hallazgo`, `clientes crear`,
-  `clientes editar`, `lugares crear`, `articulos crear`, `inventario entrada`, `inventario salida`, `inventario ajuste`,
-  `inventario traslado`, `inventario revertir`, `lecturas registrar`,
-  `lecturas anular`, `personas importar --confirmar`, `sst nueva-accion`,
-  `sst accion-hecha`, `ambiental nueva-accion`, `ambiental accion-hecha`,
-  `ambiental residuo`, `ambiental lectura`, `avisos --marcar-leidos`, y
-  `operx api` con POST, PUT, PATCH o DELETE. Todos llevan `--si`.
+- Escriben, y todos llevan `--si`:
+  - Trabajos: `ordenes crear`, `editar`, `estado`, `asignar`, `comentar`,
+    `adjuntar` y `repuesto`; `preventivos crear` y `nota`.
+  - Registros: `equipos crear` y `editar`, `clientes crear` y `editar`,
+    `lugares crear`.
+  - Inventario: `articulos crear`; `inventario entrada`, `salida`, `ajuste`,
+    `traslado` y `revertir`.
+  - Equipos: `equipos parar`, `reanudar`, `hallazgo` y `hallazgo-a-orden`;
+    `lecturas registrar` y `anular`.
+  - Personas: `personas importar --confirmar` y `personas ausencia`.
+  - SG-SST y Ambiental: `sst nueva-accion` y `accion-hecha`;
+    `ambiental nueva-accion`, `accion-hecha`, `residuo` y `lectura`.
+  - `avisos --marcar-leidos`, y `operx api` con POST, PUT, PATCH o DELETE.
 - Un error se corrige con su contrario, nunca borrando: `inventario revertir`
   deshace un movimiento, `lecturas anular` una lectura.
 - SG-SST y Ambiental van por empresa: sin `--empresa`, la de la cuenta. Una
@@ -124,7 +127,7 @@ cinco pasos:
 1. **Busca la ruta.** `operx api rutas TEXTO --json` deja las que tienen
    cada palabra del texto en la ruta, en su `producto` (SG-SST, Inventario…)
    o en lo que hace. Las rutas están en inglés: busca también así
-   (`operx api rutas sst inspections`, `operx api rutas repuestos`).
+   (`operx api rutas sst inspections`, `operx api rutas purchase requests`).
 2. **Lee lo que lleva.** `operx api campos RUTA --json` (con `--metodo POST`
    para uno solo) da, por método:
    - `en_la_ruta`: los valores de la dirección, como `{pk}`.
@@ -163,9 +166,9 @@ Más opciones de `operx api`:
 - `-o archivo`: guarda una respuesta que es un archivo (CSV, PDF).
 
 ```sh
-operx api rutas repuestos --json
-operx api campos inventory/work-orders/1234/parts/ --metodo POST --json
-operx api POST inventory/work-orders/1234/parts/ -d '{"action": "usar", "item": 3, "quantity": "2", "location": 2}' --si
+operx api rutas purchase requests --json
+operx api campos inventory/purchase-requests/ --metodo POST --json
+operx api POST inventory/purchase-requests/ -d '{"item": 3, "quantity": "10", "reason": "Bajo el mínimo"}' --si
 operx api GET work-orders/export/ -o ordenes.csv
 ```
 
@@ -176,28 +179,35 @@ operx api GET work-orders/export/ -o ordenes.csv
 operx ordenes listar --vencidas --asignada-a yo --todas --json
 
 # Pasar una orden a completada, después de su sí
-operx ordenes estado 1234 completada --si
+operx ordenes estado 1234 completada --si --json
 
 # Registrar una lectura: primero el número del punto
 operx lecturas puntos BOM-04 --json
-operx lecturas registrar --punto 12 --valor 73,4 --si
+operx lecturas registrar --punto 12 --valor 73,4 --si --json
 
 # Sacar stock: primero el código y el lugar exactos
 operx inventario existencias --buscar filtro --json
-operx inventario salida --articulo FIL-010 --lugar "Bodega central" --cantidad 2 --motivo Consumo --si
+operx inventario salida --articulo FIL-010 --lugar "Bodega central" --cantidad 2 --motivo Consumo --si --json
 
 # Un artículo nuevo y lo que llegó de él (crear da el código)
-operx articulos crear --nombre "Filtro de aceite" --unidad und --tipo consumible --si
-operx inventario entrada --articulo CON-0001 --lugar "Bodega central" --cantidad 10 --costo-unitario 25.000 --si
+operx articulos crear --nombre "Filtro de aceite" --unidad und --tipo consumible --si --json
+operx inventario entrada --articulo CON-0001 --lugar "Bodega central" --cantidad 10 --costo-unitario 25.000 --si --json
 
 # Un equipo que entró a mantenimiento
-operx equipos editar BOM-04 --estado en-mantenimiento --si
+operx equipos editar BOM-04 --estado en-mantenimiento --si --json
 
-# Un repuesto usado en una orden (no tiene comando propio): ruta, campos, ids, escribir
-operx api rutas repuestos --json
-operx api campos inventory/work-orders/1234/parts/ --metodo POST --json
-operx inventario existencias --buscar filtro --json
-operx api POST inventory/work-orders/1234/parts/ -d '{"action": "usar", "item": 3, "quantity": "2", "location": 2}' --si
+# Un repuesto usado en una orden, y lo que ya lleva
+operx ordenes repuesto 1234 --articulo FIL-010 --lugar "Bodega central" --cantidad 2 --si --json
+operx ordenes repuestos 1234 --json
+
+# Lo que hay que comprar, y una solicitud de compra (no tiene comando propio)
+operx inventario por-comprar --json
+operx api campos inventory/purchase-requests/ --metodo POST --json
+operx api POST inventory/purchase-requests/ -d '{"item": 3, "quantity": "10", "reason": "Bajo el mínimo"}' --si
+
+# La orden para un hallazgo, y una ausencia (queda por aprobar)
+operx equipos hallazgo-a-orden 8 --prioridad alta --si --json
+operx personas ausencia "Ana Ruiz" --tipo permiso --desde 09/11/2026 --horas 08:00-10:00 --si --json
 
 # Crear y seguir con el id que responde
 operx ordenes crear --titulo "Cambio de rodamiento" --equipo BOM-04 --si --json
@@ -221,5 +231,5 @@ operx sst acciones --estado abiertas --json
 
 # Lo que vence este mes en lo ambiental, y registrar residuos
 operx ambiental obligaciones --json
-operx ambiental residuo --corriente "Aceite usado" --kg 12,5 --si
+operx ambiental residuo --corriente "Aceite usado" --kg 12,5 --si --json
 ```

{operx_cli-0.6.0 → operx_cli-0.7.1}/operx_cli/__init__.py

@@ -2,4 +2,4 @@
 API (backend/users/api_allowlist.py) from a terminal, with a personal API
 token."""
 
-__version__ = "0.6.0"
+__version__ = "0.7.1"

{operx_cli-0.6.0 → operx_cli-0.7.1}/operx_cli/app.py

@@ -147,6 +147,7 @@ registros.equipos.command("parar")(planta.parar)
 registros.equipos.command("reanudar")(planta.reanudar)
 registros.equipos.command("hallazgos")(planta.hallazgos)
 registros.equipos.command("hallazgo")(planta.hallazgo)
+registros.equipos.command("hallazgo-a-orden")(planta.hallazgo_a_orden)
 app.add_typer(registros.equipos, name="equipos")
 app.add_typer(registros.clientes, name="clientes")
 app.add_typer(registros.lugares, name="lugares")

{operx_cli-0.6.0 → operx_cli-0.7.1}/operx_cli/commands/inventario.py

@@ -214,3 +214,31 @@ def salida(
     confirm_write(f"Salida de {cantidad} de «{item['name']}» de {place['name']} ({reason['name']}).", si)
     moved = answer_of(client.send("POST", "inventory/actions/salida", json=move))
     print_result(moved, as_json, f"Salida registrada: {cantidad} de {item['name']} de {place['name']}.")
+
+
+TO_BUY_COLUMNS = [
+    ("code", "Código"), ("name", "Artículo"), ("place_name", "Lugar"), ("on_hand", "Hay"), ("min_qty", "Mínimo"),
+    ("quantity", "Pedir"), ("unit", "Unidad"), ("supplier_name", "Proveedor"), ("unit_price", "Último precio"),
+    ("request_number", "Solicitud"),
+]
+
+
+@app.command("por-comprar")
+def por_comprar(
+    ctx: typer.Context,
+    as_json: JsonOption = False,
+    as_csv: CsvOption = False,
+):
+    """Lo que hay que comprar: lo que está bajo el mínimo (cuánto pedir para llegar al máximo) y las solicitudes aprobadas."""
+    output = output_format(as_json, as_csv)
+    lines = client_of(ctx).get("inventory/por-comprar")
+    if output != "json":
+        lines = [
+            {**line, "code": (line.get("item") or {}).get("code"),
+             # A request may name something not in the catalog: its description.
+             "name": (line.get("item") or {}).get("name") or line.get("description"),
+             "unit": (line.get("item") or {}).get("unit"), "supplier_name": (line.get("supplier") or {}).get("name"),
+             "request_number": (line.get("request") or {}).get("number")}
+            for line in lines
+        ]
+    print_rows(TO_BUY_COLUMNS, lines, output)

{operx_cli-0.6.0 → operx_cli-0.7.1}/operx_cli/commands/ordenes.py

@@ -7,14 +7,16 @@ from typing import Annotated, Optional
 import typer
 
 from ..lookup import find_one
-from ..output import print_card, print_notes, print_record, print_rows
+from ..output import cell_text, json_text, print_card, print_notes, print_record, print_rows
 from ..values import shown_moment
 from .common import (
     AllOption, CliError, CsvOption, JsonOption, SearchOption, YesOption, answer_of, client_of, confirm_write, day,
-    list_rows, number, output_format, print_result, without_empty,
+    list_rows, moment, number, output_format, print_result, without_empty,
 )
 
-app = typer.Typer(help="Órdenes de trabajo: verlas, crearlas, moverlas de estado, asignarlas y comentarlas.", no_args_is_help=True)
+app = typer.Typer(
+    help="Órdenes de trabajo: verlas, crearlas, moverlas de estado, asignarlas, comentarlas y sus repuestos.", no_args_is_help=True,
+)
 
 
 class Estado(str, Enum):
@@ -75,7 +77,7 @@ def _in_spanish(order):
         **order,
         "status": STATUS_LABELS.get(order.get("status"), order.get("status")),
         "priority": PRIORITY_LABELS.get(order.get("priority"), order.get("priority")),
-        "due_date": (order.get("due_date") or "")[:10],
+        "due_date": shown_moment(order.get("due_date")),
     }
 
 
@@ -289,3 +291,54 @@ def comentar(
     confirm_write(f"Comentar en la orden {orden}.", si)
     comment = answer_of(client_of(ctx).send("POST", f"work-orders/{orden}/comments", json={"body": texto}))
     print_result(comment, as_json, f"Comentario agregado a la orden {orden}.")
+
+
+# ── Parts (Inventario: inventory/stage_views.py WorkOrderPartsView) ──────────
+
+PART_COLUMNS = [
+    ("item_code", "Código"), ("item_name", "Repuesto"), ("location_name", "De"), ("planned", "Planeado"),
+    ("used", "Usado"), ("unit", "Unidad"), ("cost", "Costo"),
+]
+
+
+@app.command()
+def repuestos(
+    ctx: typer.Context,
+    orden: Annotated[int, typer.Argument(help="El número de la orden.")],
+    as_json: JsonOption = False,
+    as_csv: CsvOption = False,
+):
+    """Los repuestos de una orden: lo planeado, lo usado y su costo."""
+    output = output_format(as_json, as_csv)
+    answer = client_of(ctx).get(f"inventory/work-orders/{orden}/parts")
+    if output == "json":
+        typer.echo(json_text(answer))
+        return
+    print_rows(PART_COLUMNS, answer.get("parts", []), output)
+    if output == "tabla":
+        typer.echo(f"Costo de repuestos: {cell_text(answer.get('cost'))}")
+
+
+@app.command()
+def repuesto(
+    ctx: typer.Context,
+    orden: Annotated[int, typer.Argument(help="El número de la orden.")],
+    articulo: Annotated[str, typer.Option("--articulo", help="El código o nombre del repuesto.")],
+    lugar: Annotated[str, typer.Option("--lugar", help="De qué bodega o vehículo sale.")],
+    cantidad: Annotated[str, typer.Option("--cantidad", help="Cuánto: 2 o 2,5. Negativa devuelve al stock lo que no se usó.")],
+    planeado: Annotated[bool, typer.Option("--planeado", help="Solo lo reserva para la orden; no sale del stock.")] = False,
+    fecha: Annotated[Optional[str], typer.Option("--fecha", help="Cuándo se usó, si no fue ahora: 22/10/2026 08:00.")] = None,
+    si: YesOption = False,
+    as_json: JsonOption = False,
+):
+    """Registra un repuesto usado en una orden: sale del stock y suma a su costo. Con --planeado solo lo reserva."""
+    client = client_of(ctx)
+    item = find_one(client, "inventory/items", articulo, ["code", "name"], "artículo")
+    place = find_one(client, "locations", lugar, ["name"], "lugar")
+    part = {"action": "planear" if planeado else "usar", "item": item["id"], "quantity": number(cantidad), "location": place["id"]}
+    if fecha and not planeado:
+        part["occurred_at"] = moment(fecha)
+    what = "Reservar" if planeado else "Usar"
+    confirm_write(f"{what} {cantidad} de «{item['name']}» de {place['name']} en la orden {orden}.", si)
+    answer = client.send("POST", f"inventory/work-orders/{orden}/parts", json=part).json()
+    print_result(answer, as_json, f"Listo. Costo de repuestos de la orden {orden}: {cell_text(answer.get('cost'))}.")

{operx_cli-0.6.0 → operx_cli-0.7.1}/operx_cli/commands/personas.py

@@ -6,6 +6,8 @@ Every run checks the whole file first and shows each row's errors; with
 gets access to the app here: invitations are sent from Usuarios y acceso.
 """
 
+import re
+from enum import Enum
 from pathlib import Path
 from typing import Annotated, Optional
 
@@ -16,7 +18,7 @@ from ..output import json_text, note, print_rows
 from ..spreadsheet import DATE_FIELDS, people_rows
 from ..values import shown_moment
 from .common import (
-    AllOption, CliError, CsvOption, JsonOption, SearchOption, YesOption, client_of, confirm_write, list_rows,
+    AllOption, CliError, CsvOption, JsonOption, SearchOption, YesOption, client_of, confirm_write, day, list_rows,
     output_format, print_result,
 )
 
@@ -137,3 +139,56 @@ def importar(
     print_result(
         saved, as_json, f"Se guardaron {saved['saved']} personas. Nadie recibió acceso a la app: invítalos en Usuarios y acceso.",
     )
+
+
+class TipoAusencia(str, Enum):
+    vacaciones = "vacaciones"
+    permiso = "permiso"
+    licencia = "licencia"
+
+
+# people/models.py Absence.KIND_CHOICES. An incapacidad goes with its
+# certificate, in the app.
+ABSENCE_KEYS = {"vacaciones": "vacation", "permiso": "permit", "licencia": "leave"}
+HOURS = re.compile(r"^(\d{1,2}):(\d{2})\s*-\s*(\d{1,2}):(\d{2})$")
+
+
+def _hours(text):
+    """'8:00-12:00' → ('08:00', '12:00')."""
+    found = HOURS.match(text.strip())
+    if not found:
+        raise CliError(f"«{text}» no son horas: escríbelas como 08:00-12:00.")
+    start_hour, start_minute, end_hour, end_minute = found.groups()
+    return f"{int(start_hour):02d}:{start_minute}", f"{int(end_hour):02d}:{end_minute}"
+
+
+@app.command()
+def ausencia(
+    ctx: typer.Context,
+    persona: Annotated[str, typer.Argument(help="El nombre o código de la persona.")],
+    tipo: Annotated[TipoAusencia, typer.Option("--tipo")],
+    desde: Annotated[str, typer.Option("--desde", help="El primer día: 02/11/2026.")],
+    hasta: Annotated[Optional[str], typer.Option("--hasta", help="El último día; sin él, el mismo.")] = None,
+    horas: Annotated[Optional[str], typer.Option("--horas", help="Un permiso de unas horas: 08:00-12:00.")] = None,
+    motivo: Annotated[Optional[str], typer.Option("--motivo")] = None,
+    si: YesOption = False,
+    as_json: JsonOption = False,
+):
+    """Registra una ausencia: vacaciones, un permiso o una licencia. Queda por aprobar. Una incapacidad, en la app."""
+    client = client_of(ctx)
+    person = find_one(client, "employees", persona, ["user_name", "employee_code"], "persona")
+    start = day(desde)
+    absence = {"employee_id": person["id"], "kind": ABSENCE_KEYS[tipo.value], "start_date": start, "end_date": day(hasta) or start}
+    if horas:
+        absence["hours_from"], absence["hours_to"] = _hours(horas)
+    if motivo:
+        absence["reason"] = motivo
+    when = shown_moment(start) if absence["end_date"] == start else f"del {shown_moment(start)} al {shown_moment(absence['end_date'])}"
+    if horas:
+        when += f", de {absence['hours_from']} a {absence['hours_to']}"
+    confirm_write(f"{tipo.value.capitalize()} de {person['user_name']}: {when}.", si)
+    created = client.send("POST", "people/absences", json=absence).json()
+    print_result(created, as_json, (
+        f"Ausencia registrada: {created.get('kind_label', tipo.value.capitalize())} de {person['user_name']}, {when}. "
+        f"{created.get('status_label', 'Por aprobar')}."
+    ))

{operx_cli-0.6.0 → operx_cli-0.7.1}/operx_cli/commands/planta.py

@@ -1,6 +1,7 @@
 """Equipos' day at the plant, under `operx equipos` (app.py): a machine's
 stops (equipment/stops.py) and the findings someone marked on it
-(equipment/findings.py). Deciding a finding stays in the app."""
+(equipment/findings.py), and the work order for one. Watching or closing a
+finding stays in the app."""
 
 from datetime import date, timedelta
 from enum import Enum
@@ -12,6 +13,7 @@ from ..lookup import find_in, find_one
 from ..output import print_rows
 from ..values import now_iso, shown_moment
 from .common import (
+    CliError,
     CsvOption,
     JsonOption,
     YesOption,
@@ -24,6 +26,7 @@ from .common import (
     print_result,
     without_empty,
 )
+from .ordenes import PRIORITY_KEYS, Prioridad
 
 MachineArgument = Annotated[str, typer.Argument(help="El código, nombre o id del equipo.")]
 STOPS_DAYS = 7
@@ -170,3 +173,32 @@ def hallazgo(
     confirm_write(f"Marcar «{titulo}» en «{machine['name']}».", si)
     created = client.send("POST", "equipment/findings", json=finding).json()
     print_result(created, as_json, f"Hallazgo {created['id']} marcado en {machine['name']}.")
+
+
+def hallazgo_a_orden(
+    ctx: typer.Context,
+    hallazgo: Annotated[int, typer.Argument(help="El número del hallazgo (operx equipos hallazgos).")],
+    titulo: Annotated[Optional[str], typer.Option("--titulo", help="El título de la orden; sin él, el del hallazgo.")] = None,
+    descripcion: Annotated[Optional[str], typer.Option("--descripcion")] = None,
+    prioridad: Annotated[Optional[Prioridad], typer.Option("--prioridad", help="Sin ella, media.")] = None,
+    si: YesOption = False,
+    as_json: JsonOption = False,
+):
+    """Crea la orden de trabajo para un hallazgo: queda ligada a él y a su equipo."""
+    client = client_of(ctx)
+    if not titulo:
+        # The findings list has it unless it's closed. One that already has its
+        # order is refused by the API (equipment/findings.py), never doubled.
+        found = [finding for finding in client.get("equipment/findings") if finding.get("id") == hallazgo]
+        if not found:
+            raise CliError(f"No encontré el hallazgo {hallazgo} entre los abiertos. Si es otro, dale un título: --titulo.")
+        titulo = found[0]["title"]
+    order = without_empty({
+        "title": titulo,
+        "description": descripcion,
+        "priority": PRIORITY_KEYS[prioridad.value] if prioridad else None,
+    })
+    confirm_write(f"Crear la orden «{titulo}» para el hallazgo {hallazgo}.", si)
+    finding = client.send("POST", f"equipment/findings/{hallazgo}/work-order", json=order).json()
+    created = finding.get("work_order") or {}
+    print_result(finding, as_json, f"Orden {created.get('id')} creada desde el hallazgo {hallazgo}: {created.get('title', titulo)}.")

{operx_cli-0.6.0 → operx_cli-0.7.1}/operx_cli/record_completion.py

@@ -36,6 +36,7 @@ ARGUMENT_RECORDS = {
     ("clientes", "ver"): CUSTOMERS,
     ("clientes", "editar"): CUSTOMERS,
     ("articulos", "ver"): ITEMS,
+    ("personas", "ausencia"): PEOPLE,
     ("lecturas", "puntos"): MACHINES,
 }
 

{operx_cli-0.6.0 → operx_cli-0.7.1}/operx_cli/shell.py

@@ -44,11 +44,16 @@ COMMAND_PRODUCTS = {
     "equipos reanudar": ("equipment",),
     "equipos hallazgos": ("equipment",),
     "equipos hallazgo": ("equipment",),
+    "equipos hallazgo-a-orden": ("equipment",),
+    # Parts on an order are Inventario's.
+    "ordenes repuestos": ("inventory",),
+    "ordenes repuesto": ("inventory",),
     "clientes": ("maintenance", "inventory", "sst", "environment"),
     "inventario": ("inventory",),
     "articulos": ("inventory",),
     "lecturas": ("equipment",),
     "personas importar": ("people",),
+    "personas ausencia": ("people",),
     "sst": ("sst",),
     "ambiental": ("environment",),
 }

{operx_cli-0.6.0 → operx_cli-0.7.1}/operx_cli.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: operx-cli
-Version: 0.6.0
+Version: 0.7.1
 Summary: La línea de comandos de OperX: tu empresa desde la terminal, con tu token de API.
 Requires-Python: >=3.10
 Description-Content-Type: text/markdown
@@ -118,6 +118,8 @@ operx ordenes asignar 1234 "Pedro Pérez"
 operx ordenes comentar 1234 "Llegó el repuesto"
 operx ordenes editar 1234 --prioridad critica --vence 05/11/2026
 operx ordenes adjuntar 1234 foto.jpg --momento despues
+operx ordenes repuestos 1234                   # lo planeado, lo usado y su costo
+operx ordenes repuesto 1234 --articulo FIL-010 --lugar "Bodega central" --cantidad 2
 
 operx reportes indicadores --dias 30           # MTTR, MTBF, cumplimiento de preventivos
 operx reportes vencidas
@@ -153,10 +155,12 @@ operx inventario traslado --articulo FIL-010 --cantidad 2 --de "Bodega central"
 operx inventario ajuste --articulo FIL-010 --lugar "Bodega central" --cantidad -1 --motivo Conteo
 operx inventario movimientos --articulo FIL-010
 operx inventario revertir 4512                 # deshace un movimiento equivocado
+operx inventario por-comprar                   # lo bajo el mínimo y las solicitudes aprobadas
 
 operx equipos parar BOM-04 --motivo Falla --minutos 90
 operx equipos reanudar 21
 operx equipos hallazgo BOM-04 --titulo "Fuga en el sello" --severidad alta
+operx equipos hallazgo-a-orden 8 --prioridad alta  # la orden para ese hallazgo
 operx lecturas anular 31 --motivo "Lectura de otro equipo"
 
 operx lecturas puntos BOM-04
@@ -165,6 +169,8 @@ operx lecturas registrar --punto 12 --valor 73,4
 operx personas listar --buscar pérez
 operx personas importar empleados.xlsx               # revisa el archivo, no guarda
 operx personas importar empleados.xlsx --confirmar   # guarda si ninguna fila tiene errores
+operx personas ausencia "Ana Ruiz" --tipo vacaciones --desde 02/11/2026 --hasta 06/11/2026
+operx personas ausencia "Ana Ruiz" --tipo permiso --desde 09/11/2026 --horas 08:00-10:00
 
 operx sst acciones --estado abiertas
 operx sst nueva-accion --titulo "Señalizar la salida" --para 15/11/2026 --responsable "Ana Ruiz"
@@ -221,9 +227,9 @@ tipo, si es obligatorio y los valores permitidos. También están en Acceso
 por API › Documentación:
 
 ```sh
-operx api rutas repuestos
-operx api campos inventory/work-orders/1234/parts/ --metodo POST
-operx api POST inventory/work-orders/1234/parts/ -d '{"action": "usar", "item": 3, "quantity": "2", "location": 2}'
+operx api rutas purchase requests
+operx api campos inventory/purchase-requests/ --metodo POST
+operx api POST inventory/purchase-requests/ -d '{"item": 3, "quantity": "10", "reason": "Bajo el mínimo"}'
 operx api GET pm/schedules/ -q search=compresor
 operx api POST contacts/ -d @contacto.json
 operx api GET work-orders/export/ -o ordenes.csv

{operx_cli-0.6.0 → operx_cli-0.7.1}/operx_cli.egg-info/SOURCES.txt

@@ -50,6 +50,7 @@ tests/test_articulos.py
 tests/test_cards.py
 tests/test_client.py
 tests/test_completar.py
+tests/test_daily_flows.py
 tests/test_inventario_lecturas.py
 tests/test_json_writes.py
 tests/test_login.py

{operx_cli-0.6.0 → operx_cli-0.7.1}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "operx-cli"
-version = "0.6.0"
+version = "0.7.1"
 description = "La línea de comandos de OperX: tu empresa desde la terminal, con tu token de API."
 readme = "README.md"
 requires-python = ">=3.10"

operx_cli-0.7.1/tests/test_daily_flows.py

@@ -0,0 +1,186 @@
+"""The daily flows that had only `operx api`: parts used on an order, what to
+buy, an order from a finding, an absence. Fixtures: real answers from a
+local backend with a personal token."""
+
+import json
+
+import pytest
+
+from operx_cli.shell import offered_to
+
+from .fake_api import FakeApi, page, run
+
+# GET /v1/inventory/work-orders/6/parts/ (inventory/stage_views.py WorkOrderPartsView)
+PARTS = {
+    "work_order_id": 6,
+    "parts": [{
+        "id": 1, "item_id": 2, "item_code": "CON-0001", "item_name": "Filtro e2e", "unit": "und", "item_photo": None,
+        "location_id": 5, "location_name": "Bodega e2e", "planned": "1.000", "used": "2.500", "cost": "62.50",
+        "billable": True, "billed_invoice_id": None, "note": "", "sale_price": None, "average_cost": "25.0000",
+    }],
+    "cost": "62.50",
+}
+FILTER = {"id": 2, "code": "CON-0001", "name": "Filtro e2e"}
+STORE = {"id": 5, "name": "Bodega e2e"}
+# GET /v1/inventory/por-comprar/ (inventory/purchasing_views.py ToBuyView)
+TO_BUY = [{
+    "key": "low-3", "request": None, "item": {"id": 2, "code": "CON-0001", "name": "Filtro e2e", "unit": "und", "photo": None},
+    "description": "", "quantity": "12.500", "unit_price": "25.00", "supplier": None, "place_id": 5,
+    "place_name": "Bodega e2e", "on_hand": "7.500", "min_qty": "10.000", "max_qty": "20.000", "target": "20.000",
+    "asked": "0", "coming": "0", "orders": [], "is_critical": False,
+}]
+REQUESTED = {
+    "key": "request-4", "request": {"id": 4, "number": "SC-0004", "requested_by": "Ana Ruiz", "reason": "", "work_order_id": None},
+    "item": None, "description": "Guantes de nitrilo talla M", "quantity": "20.000", "unit_price": None,
+    "supplier": {"id": 9, "name": "Filtros Ltda", "email": ""}, "place_id": None, "place_name": "", "on_hand": None,
+    "min_qty": None, "max_qty": None, "target": None, "asked": None, "coming": None, "orders": [], "is_critical": False,
+}
+# GET /v1/equipment/findings/ and POST …/findings/1/work-order/ (equipment/findings.py)
+MACHINE = {"id": 1, "code": "BOM-04", "name": "Bomba 4", "place_id": 2, "place_path": "Planta Norte", "parent": None}
+FINDING = {
+    "id": 1, "title": "Fuga en el sello", "note": "", "machine": MACHINE, "status": "new", "severity": "high",
+    "photos": [], "found_at": "2026-10-23T13:39:04.100703-05:00", "found_by_name": "Admin Smoke",
+}
+WITH_ORDER = {**FINDING, "status": "work_order", "work_order": {"id": 7, "number": "OT #7", "title": "Cambiar el sello"}}
+# GET /v1/employees/ and POST /v1/people/absences/ (people/absence_views.py)
+PEOPLE = page({"id": 1, "user_id": 1, "user_name": "Admin Smoke", "avatar": None, "employee_code": "", "is_active": True})
+ABSENCE = {
+    "id": 1, "employee": {"id": 1, "name": "Admin Smoke", "avatar": None}, "kind": "permit", "kind_label": "Permiso",
+    "status": "pending", "status_label": "Por aprobar", "start_date": "2026-11-03", "end_date": "2026-11-03",
+    "hours_from": "08:00", "hours_to": "12:00", "reason": "Cita médica", "business_days": 0, "has_certificate": False,
+    "requested_by": "Admin Smoke", "approver": "Un administrador",
+}
+
+
+@pytest.fixture(autouse=True)
+def signed_in(monkeypatch):
+    monkeypatch.setenv("OPERX_TOKEN", "opx_test")
+
+
+# ── Parts on an order ──────────────────────────────────────────────────────
+
+
+def test_repuestos_lists_what_an_order_planned_and_used_and_its_cost():
+    result = run(FakeApi({("GET", "inventory/work-orders/6/parts/"): PARTS}), "ordenes", "repuestos", "6")
+    assert result.exit_code == 0, result.output
+    for text in ("CON-0001", "Filtro e2e", "Bodega e2e", "2,5", "Costo de repuestos: 62,5"):
+        assert text in result.output
+
+
+def test_repuestos_json_is_the_apis_answer():
+    result = run(FakeApi({("GET", "inventory/work-orders/6/parts/"): PARTS}), "ordenes", "repuestos", "6", "--json")
+    assert json.loads(result.stdout) == PARTS
+
+
+def parts_api():
+    return FakeApi({
+        ("GET", "inventory/items/"): page(FILTER),
+        ("GET", "locations/"): page(STORE),
+        ("POST", "inventory/work-orders/6/parts/"): PARTS,
+    })
+
+
+def test_repuesto_records_a_part_used_from_a_place():
+    fake = parts_api()
+    result = run(fake, "ordenes", "repuesto", "6", "--articulo", "CON-0001", "--lugar", "Bodega e2e", "--cantidad", "2,5", "--si")
+    assert result.exit_code == 0, result.output
+    assert fake.sent("POST", "inventory/work-orders/6/parts/") == {"action": "usar", "item": 2, "quantity": "2.5", "location": 5}
+    assert "Costo de repuestos de la orden 6: 62,5" in result.output
+
+
+def test_repuesto_planeado_only_reserves_it():
+    fake = parts_api()
+    run(fake, "ordenes", "repuesto", "6", "--articulo", "CON-0001", "--lugar", "Bodega e2e", "--cantidad", "1", "--planeado", "--si")
+    assert fake.sent("POST", "inventory/work-orders/6/parts/")["action"] == "planear"
+
+
+def test_repuesto_used_earlier_keeps_its_moment():
+    fake = parts_api()
+    run(fake, "ordenes", "repuesto", "6", "--articulo", "CON-0001", "--lugar", "Bodega e2e", "--cantidad", "1",
+        "--fecha", "22/10/2026 08:00", "--si")
+    assert fake.sent("POST", "inventory/work-orders/6/parts/")["occurred_at"].startswith("2026-10-22T08:00")
+
+
+def test_parts_need_inventario_in_the_prompt():
+    assert not offered_to("ordenes repuestos", ["maintenance"])
+    assert offered_to("ordenes repuesto", ["maintenance", "inventory"])
+
+
+# ── What to buy ────────────────────────────────────────────────────────────
+
+
+def test_por_comprar_lists_what_is_short_and_what_was_asked_for():
+    fake = FakeApi({("GET", "inventory/por-comprar/"): TO_BUY + [REQUESTED]})
+    result = run(fake, "inventario", "por-comprar")
+    assert result.exit_code == 0, result.output
+    for text in ("CON-0001", "Bodega e2e", "12,5", "7,5", "Guantes de nitrilo talla M", "Filtros Ltda", "SC-0004"):
+        assert text in result.output
+
+
+def test_por_comprar_json_is_the_apis_answer():
+    result = run(FakeApi({("GET", "inventory/por-comprar/"): TO_BUY}), "inventario", "por-comprar", "--json")
+    assert json.loads(result.stdout) == TO_BUY
+
+
+# ── An order from a finding ────────────────────────────────────────────────
+
+
+def test_hallazgo_a_orden_titles_it_like_the_finding_unless_told():
+    fake = FakeApi({("GET", "equipment/findings/"): [FINDING], ("POST", "equipment/findings/1/work-order/"): (201, WITH_ORDER)})
+    result = run(fake, "equipos", "hallazgo-a-orden", "1", "--si")
+    assert result.exit_code == 0, result.output
+    assert fake.sent("POST", "equipment/findings/1/work-order/") == {"title": "Fuga en el sello"}
+    assert "Orden 7 creada desde el hallazgo 1: Cambiar el sello." in result.output
+
+
+def test_hallazgo_a_orden_with_its_own_title_and_priority():
+    fake = FakeApi({("POST", "equipment/findings/1/work-order/"): (201, WITH_ORDER)})
+    run(fake, "equipos", "hallazgo-a-orden", "1", "--titulo", "Cambiar el sello", "--prioridad", "alta", "--si")
+    assert fake.sent("POST", "equipment/findings/1/work-order/") == {"title": "Cambiar el sello", "priority": "high"}
+    assert not fake.called("GET", "equipment/findings/")
+
+
+def test_hallazgo_a_orden_of_a_finding_not_open_needs_a_title():
+    result = run(FakeApi({("GET", "equipment/findings/"): []}), "equipos", "hallazgo-a-orden", "1", "--si")
+    assert result.exit_code == 1
+    assert "--titulo" in result.output
+
+
+# ── An absence ─────────────────────────────────────────────────────────────
+
+
+def absence_api():
+    return FakeApi({("GET", "employees/"): PEOPLE, ("POST", "people/absences/"): (201, ABSENCE)})
+
+
+def test_ausencia_by_hours_is_a_permit_of_one_day():
+    fake = absence_api()
+    result = run(
+        fake, "personas", "ausencia", "Admin Smoke", "--tipo", "permiso", "--desde", "03/11/2026", "--horas", "8:00-12:00",
+        "--motivo", "Cita médica", "--si",
+    )
+    assert result.exit_code == 0, result.output
+    assert fake.sent("POST", "people/absences/") == {
+        "employee_id": 1, "kind": "permit", "start_date": "2026-11-03", "end_date": "2026-11-03",
+        "hours_from": "08:00", "hours_to": "12:00", "reason": "Cita médica",
+    }
+    assert "Ausencia registrada: Permiso de Admin Smoke, 03/11/2026, de 08:00 a 12:00. Por aprobar." in result.output
+
+
+def test_ausencia_of_several_days():
+    fake = absence_api()
+    run(fake, "personas", "ausencia", "Admin Smoke", "--tipo", "vacaciones", "--desde", "02/11/2026", "--hasta", "06/11/2026", "--si")
+    sent = fake.sent("POST", "people/absences/")
+    assert sent["kind"] == "vacation" and sent["start_date"] == "2026-11-02" and sent["end_date"] == "2026-11-06"
+
+
+def test_ausencia_hours_must_read_as_a_range():
+    result = run(absence_api(), "personas", "ausencia", "Admin Smoke", "--tipo", "permiso", "--desde", "03/11/2026",
+                 "--horas", "por la mañana", "--si")
+    assert result.exit_code == 1
+    assert "08:00-12:00" in result.output
+
+
+def test_ausencia_json_is_the_apis_answer():
+    result = run(absence_api(), "personas", "ausencia", "Admin Smoke", "--tipo", "permiso", "--desde", "03/11/2026", "--si", "--json")
+    assert json.loads(result.stdout) == ABSENCE

{operx_cli-0.6.0 → operx_cli-0.7.1}/tests/test_ordenes.py

@@ -20,6 +20,8 @@ def test_listar_shows_status_and_priority_in_spanish():
     result = run(FakeApi({("GET", "work-orders/"): page(ORDER)}), "ordenes", "listar")
     assert result.exit_code == 0, result.output
     assert "En progreso" in result.output and "Alta" in result.output and "Cambio de rodamiento" in result.output
+    # The due date the way people read it, like every other list.
+    assert "30/10/2026" in result.output and "2026-10-30" not in result.output
 
 
 def test_listar_json_keeps_the_apis_values():

{operx_cli-0.6.0 → operx_cli-0.7.1}/tests/test_shell.py

@@ -272,7 +272,7 @@ def test_equipos_shows_its_stops_and_findings_only_with_equipos():
 
 def test_tab_hides_a_subcommand_of_a_product_the_company_lacks():
     assert names(suggestions(ROOT, "personas ", products=["maintenance"])) == ["listar"]
-    assert set(names(suggestions(ROOT, "personas ", products=["people"]))) == {"listar", "importar"}
+    assert set(names(suggestions(ROOT, "personas ", products=["people"]))) == {"listar", "importar", "ausencia"}
 
 
 def test_ayuda_lists_every_word_the_prompt_understands(capsys):