Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/EdgarJr30/proyecto-de-grado-cms/llms.txt

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

​
Overview

The Parts module allows you to maintain a comprehensive catalog of spare parts used in maintenance operations. Each part includes detailed information about units of measure, categories, criticality, and vendor relationships.

​
Parts Table Structure

Each part record contains:
FieldTypeDescription
codestringUnique part identifier (e.g., “BRG-001”)
namestringDescriptive part name
descriptiontextDetailed part description
uom_idUUIDUnit of measure (pieces, liters, meters, etc.)
category_idUUIDPart category for organization
criticalityenumLOW, MEDIUM, HIGH, CRITICAL
min_stock_qtynumberMinimum stock level alert
is_activebooleanActive status flag

​
Accessing Parts

Navigate to Inventory > Repuestos (/inventory/parts) to access the parts management interface.
Requires inventory:read permission to view parts. Editing requires inventory:write or inventory:full_access.

​
Creating a New Part

1

Open Create Dialog

Click the Nueva parte button in the parts page toolbar.
2

Enter Part Code

Provide a unique part code (e.g., “PUMP-101”, “FILTER-A4”).
Part codes must be unique across the system and cannot be changed after creation.
3

Add Part Details

Fill in required fields:
  • Name: Descriptive name (e.g., “Hydraulic Pump 5HP”)
  • UOM: Select from available units of measure
  • Category: Assign to a part category
  • Criticality: Set priority level for procurement
4

Optional Information

Add supplementary data:
  • Description: Technical specifications or notes
  • Min Stock Qty: Trigger level for reorder alerts
  • Is Active: Keep checked for active parts
5

Save Part

Click Guardar to create the part record.

​
Part Criticality Levels

Criticality affects procurement priority and stock management:
Critical Parts
  • Essential for operation/safety
  • Zero downtime tolerance
  • Maintain high safety stock
  • Expedited procurement process
Examples: Safety valves, emergency shutdown components

​
Part Categories

Organize parts using hierarchical categories: 
Electrical Components
├── Motors
│   ├── AC Motors
│   └── DC Motors
├── Switches
└── Cables

Mechanical Components
├── Bearings
├── Seals
└── Fasteners
Navigate to Inventory > Categorías de repuestos to manage categories.
Categories support parent-child relationships for hierarchical organization. Each category can have one parent and multiple children.

​
Units of Measure (UOM)

Define how parts are counted and tracked:
CodeNameUsage
PCPieceIndividual items
MMeterLength measurements
LLiterVolume (liquids)
KGKilogramWeight/mass
FTFootLength (imperial)
GALGallonVolume (imperial)
BOXBoxPackaged quantities
SETSetMulti-part kits
Manage UOMs at Inventory > Unidades de medida (UdM).

​
Vendor Relationships

Link parts to suppliers for procurement:
1

Access Vendors

Navigate to Inventory > Proveedores (/inventory/vendors).
2

Create Vendor Record

Add vendor information:
  • Name
  • Contact details
  • Lead time days
  • Is active status
3

Link to Parts

In reorder policies, assign preferred vendors to specific part/warehouse combinations.

​
Service Functions

The frontend uses these service functions for part operations: 
// List parts with filters
import { listParts } from '@/services/inventory';

const parts = await listParts({
  limit: 200,
  offset: 0,
  orderBy: 'code',
  ascending: true,
  is_active: true
});

// Get single part
import { getPart } from '@/services/inventory';
const part = await getPart(partId);

// Create part
import { createPart } from '@/services/inventory';
const newPart = await createPart({
  code: 'PUMP-101',
  name: 'Hydraulic Pump',
  uom_id: uomId,
  category_id: categoryId,
  criticality: 'HIGH',
  is_active: true
});

// Update part
import { updatePart } from '@/services/inventory';
const updated = await updatePart(partId, {
  min_stock_qty: 5,
  criticality: 'CRITICAL'
});

// Delete part
import { deletePart } from '@/services/inventory';
await deletePart(partId);

​
Search and Filtering

The parts page provides:
  • Text search: Filter by part code, name, or description
  • Category filter: Show parts from specific categories
  • Criticality filter: Filter by priority level
  • Active status: Show only active or all parts
  • Pagination: Navigate large part catalogs efficiently

​
Best Practices

Naming Convention

Use consistent part codes with prefixes:
  • BRG-xxx: Bearings
  • MTR-xxx: Motors
  • FLT-xxx: Filters
  • PMP-xxx: Pumps

Documentation

Include specifications in description:
  • Manufacturer part number
  • Technical specifications
  • Compatible assets
  • Installation notes

Stock Levels

Set realistic minimum stock:
  • Consider lead time
  • Usage frequency
  • Criticality level
  • Storage constraints

Regular Reviews

Periodically audit parts:
  • Deactivate obsolete parts
  • Update criticality levels
  • Review min stock quantities
  • Consolidate duplicates

​
Common Operations

​
Bulk Import

For large part catalogs, use CSV import: 
code,name,description,uom_code,category_name,criticality,min_stock_qty
BRG-001,Ball Bearing 6200,"Standard 6200 bearing, SKF",PC,Bearings,MEDIUM,10
FLT-001,Oil Filter,"Standard oil filter, 10 micron",PC,Filters,HIGH,20
PMP-001,Centrifugal Pump,"5HP centrifugal pump",PC,Pumps,CRITICAL,2

​
Inactive Parts

Mark parts as inactive instead of deleting:
  • Preserves history
  • Maintains data integrity
  • Can be reactivated if needed
  • Hides from active selections
Cannot delete parts with existing stock or transaction history. Mark as inactive instead.

Stock Management

Track part quantities and availability

Reorder Policies

Automate procurement with min/max levels

Warehouses

Store parts in organized locations

Documents

Process part movements and transactions

Build docs developers (and LLMs) love

Get started for freeTalk to us