Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/ElthonJohan/Sistema-MRP/llms.txt

Use this file to discover all available pages before exploring further.

Before any material can flow through the system you need at least one principal warehouse (the central stock location) and one or more obra warehouses (work sites that receive materials). You also need a material catalogue — each entry carries a unique code, a unit of measure, and unit prices used for budget cost calculations.

Warehouses

The Warehouse model has two types controlled by the type column (see Data Models):
TypeRole
principalThe client’s main stock store. One per client. The dispatch and requirement services locate it via Warehouse.owner_id == obra.owner_id and Warehouse.type == "principal".
obraA work-site warehouse. A client can have many. Receives material via receipts.
Each client must have exactly one principal warehouse before requirements can be created. requirement_service.create_requirement() returns an error — "No hay almacén principal configurado. Por favor crea uno primero." — if none is found.

Create a warehouse

1

Open the Warehouses page

Navigate to Almacenes in the sidebar.
2

Expand the creation form

Click Nuevo almacén to expand the form.
3

Fill in the required fields

Enter Nombre (name), select Tipo (principal or obra), and provide Ciudad/Distrito and Dirección.
4

Submit

Click Crear Almacén. The warehouse appears in the list immediately and is owned by the currently logged-in client.

Edit or delete a warehouse

Expand the Editar almacén existente section, select the warehouse from the dropdown, update any field, and click Actualizar. To delete, click the button next to the warehouse card and confirm the prompt.

Materials

The Material model stores the full catalogue shared across all clients (see Data Models):
FieldTypeNotes
codeString (unique)Human-readable identifier, e.g. MAT-001
nameString (unique)Display name
unitStringUnit of measure: kg, m, unidad, litro, etc.
descriptionStringOptional free-text description
unit_priceFloatUnit price in Peruvian soles (S/.)
unit_price_dolaresFloatUnit price in US dollars ($)
unit_price and unit_price_dolares are used to calculate material costs in dispatch reports and budget tracking. Both fields default to 0.0. Set them accurately so that cost reports in soles and dollars reflect real values.

Create a material

1

Open the Materials page

Navigate to Materiales in the sidebar.
2

Expand the creation form

Click Nuevo material to expand the form.
3

Enter the material details

Fill in Código (must be unique), Nombre (must be unique), Unidad, and optionally Descripción. Enter at least one of Costo S/. or Costo $ with a value greater than zero.
4

Submit

Click Crear Material. The entry appears in the catalogue immediately.

Edit or delete a material

Click next to a material card to expand an inline edit form. Update any field and click Guardar cambios. Click to delete — the deletion is permanent, so verify there is no active inventory for the material first.

Build docs developers (and LLMs) love