Cliché (Clisé) Management

Overview

Clisés are flexographic printing plates that transfer ink to substrates during production. The P.FLEX system tracks their complete lifecycle from creation through retirement.

CliseItem Data Model

Complete interface definition from inventory.models.ts:16-43:

Show CliseItem Interface (TypeScript)

export interface CliseItem {
  id: string;
  item: string;                  // Unique code/identifier
  ubicacion: string;             // Physical warehouse location
  descripcion: string;           // Product description
  cliente: string;               // Customer name
  z: string;                     // Cylinder gear teeth (Z-value)
  estandar: string;
  medidas: string;
  troquel: string;               // Associated die reference
  linkedDies: string[];          // Explicitly linked die IDs
  ancho: number | null;          // Width in mm
  avance: number | null;         // Advance/repeat length in mm
  col: number | null;            // Number of columns
  rep: number | null;            // Number of repetitions
  n_clises: number | null;       // Cliché version number
  espesor: string;               // Thickness/gauge
  ingreso: string;               // Entry date
  obs: string;                   // Observations/notes
  maq: string;                   // Machine assignment
  colores: string;               // Color names (comma-separated)
  colorUsage?: CliseColorUsage[];// Detailed color meter breakdown
  n_ficha_fler: string;          // FLER technical sheet reference
  mtl_acum: number | null;       // Accumulated meters used
  imagen?: string;               // Preview image URL
  history: CliseHistory[];       // Operation history log
  hasConflict?: boolean;         // Import validation flag
}

Field Descriptions

item

string

required

Unique identifier code for the cliché (e.g., “CL-2045-A”)

ubicacion

string

required

Physical location in warehouse. Examples:

1150 → Rack CL-1, range 1136-1190
A-01 → Zona A, position 01
Numeric values auto-map to visual rack layout

cliente

string

required

Customer name (e.g., “Coca Cola”, “Nestlé”)

string

Cylinder gear teeth count. Used for die compatibility matching. Common values: “280”, “360”, “420”

ancho

number

Print width in millimeters

avance

number

Repeat length (advance) in millimeters. Critical for production setup.

troquel

string

Legacy die reference field (text-based). Modern system uses linkedDies array for structured references.

linkedDies

string[]

Array of die IDs explicitly linked to this cliché. Enables production planning and die compatibility warnings.

linkedDies: ["die-abc123", "die-def456"]

mtl_acum

number

Critical maintenance field: Accumulated meters of substrate printed with this cliché.

Below 500,000m: Status = OK
Above 500,000m: Status = MANT (maintenance required)
Triggers alerts and maintenance scheduling

colorUsage

CliseColorUsage[]

Detailed breakdown of meters printed per color:

export interface CliseColorUsage {
  name: string;   // Color name (e.g., "Cyan", "Magenta")
  meters: number; // Meters printed with this color
}

Used for color-specific maintenance planning.

history

CliseHistory[]

Complete audit trail of operations. See History Tracking section below.

hasConflict

boolean

Import validation flag. Set to true when required fields (item, cliente) are missing during Excel import.

History Tracking

Every operation is logged in the history array:

export interface CliseHistory {
  date: string;         // ISO date string
  type: 'Producción' | 'Mantenimiento' | 'Reparación' | 
        'Cambio Versión' | 'Creación' | 'Baja' | 'Otro';
  description: string;  // Operation details
  user: string;         // User who performed action
  machine?: string;     // Machine used (if applicable)
  amount?: number;      // Meters printed (for production entries)
}

Example History Entry

{
  date: "2024-03-15T14:30:00Z",
  type: "Producción",
  description: "Orden 45001 - Etiquetas 500ml",
  user: "jperez",
  machine: "GIDUE-320",
  amount: 12500
}

Reference: inventory.models.ts:2-9

KPI Statistics

The component calculates real-time inventory metrics:

// inventory-clise.component.ts stats calculation
get stats() {
  const total = this.cliseItems.length;
  const alert = this.cliseItems.filter(i => 
    i.hasConflict || (i.mtl_acum || 0) >= 500000
  ).length;
  const active = this.cliseItems.filter(i => 
    !i.hasConflict && (i.mtl_acum || 0) < 500000
  ).length;
  const totalUsage = this.cliseItems.reduce((sum, i) => 
    sum + (i.mtl_acum || 0), 0
  );
  return { total, alert, active, totalUsage };
}

Displayed as dashboard cards in the UI.

Excel Import

Flexible column mapping handles diverse spreadsheet formats:

// inventory.service.ts:183-193
readonly CLISE_MAPPING = {
  'item': ['item', 'codigo', 'code', 'id', 'clise'],
  'ubicacion': ['ubicación', 'ubicacion', 'location'],
  'descripcion': ['descripción', 'descripcion', 'description'],
  'cliente': ['cliente', 'client'],
  'z': ['z', 'dientes'],
  'ancho': ['ancho', 'width'],
  'avance': ['avance', 'length'],
  'ingreso': ['ingreso', 'fecha ingreso'],
  'mtl_acum': ['mtl acum', 'mtl. acum.', 'metros acumulados']
};

Import Workflow

Select Excel File

Click Importar button and choose .xlsx, .xls, or .csv file

Preview & Validation

System displays preview modal showing:

Valid records (green badge)
Conflicts requiring review (red badge, animated pulse)

Confirm Import

Click Importar Todo to add all records. Conflicted items are flagged with hasConflict: true for manual correction.

Records missing item or cliente will be flagged as conflicts but still imported. Review and correct these items immediately after import.

Die Linking

Clisés can be linked to compatible dies for production planning:

Manual Die Linking

In edit mode, use the die search dropdown:

// Search dies by serie, medida, or z-value
searchDies(term: string) {
  this.dieSearchResults = this.inventoryService.dieItems
    .filter(d => 
      d.serie.toLowerCase().includes(term.toLowerCase()) ||
      d.medida.toLowerCase().includes(term.toLowerCase()) ||
      d.z === this.currentClise.z
    )
    .slice(0, 10);
}

// Add die to linkedDies array
addLinkedDie(die: DieItem) {
  if (!this.currentClise.linkedDies.includes(die.id)) {
    this.currentClise.linkedDies.push(die.id);
  }
  this.dieSearchTerm = '';
  this.dieSearchResults = [];
}

Reference: inventory-clise.component.ts:420-438

Automatic Z-Value Matching

System auto-suggests dies with matching Z-values:

get compatibleDies() {
  const linkedIds = this.currentClise.linkedDies || [];
  const manual = this.allDies.filter(d => linkedIds.includes(d.id));
  
  // Also include dies with matching Z
  const autoMatched = this.allDies.filter(d => 
    d.z === this.currentClise.z && !linkedIds.includes(d.id)
  );
  
  return [...manual, ...autoMatched];
}

CRUD Operations

Add New Cliché

addClises(items: CliseItem[]) {
  this._cliseItems.next([...items, ...this.cliseItems]);
  this.mapItemsToLayout();  // Update rack visualization
  this.audit.log(
    this.state.userName(), 
    this.state.userRole(), 
    'INVENTARIO', 
    'Alta Clisés', 
    `Se agregaron ${items.length} clichés al inventario.`
  );
}

Reference: inventory.service.ts:237-241

Update Existing Cliché

updateClise(item: CliseItem) {
  const list = this.cliseItems;
  const idx = list.findIndex(i => i.id === item.id);
  if (idx !== -1) {
    list[idx] = item;
    this._cliseItems.next([...list]);
    this.mapItemsToLayout();
    this.audit.log(
      this.state.userName(), 
      this.state.userRole(), 
      'INVENTARIO', 
      'Editar Clisé', 
      `Se modificó el cliché ${item.item}.`
    );
  }
}

Reference: inventory.service.ts:243-252

All CRUD operations trigger audit logs via AuditService for compliance tracking.

UI Component

The InventoryCliseComponent provides:

Search/Filter: Real-time text search across item, cliente, descripcion
Pagination: 20 items per page (configurable via pageSize)
Sorting: Click column headers to sort
Detail Modal: Double-click row or click eye icon
Edit Mode: Toggle between read-only and edit modes
Image Preview: Visual identification using imagen field or placeholder

Información General: Basic item data (cliente, item, fecha ingreso)
Especificaciones Técnicas: Dimensions, Z-value, colors, FLER reference
Métricas de Uso: Accumulated meters, color usage breakdown with progress bars
Troqueles Compatibles: Linked dies with search/add functionality
Registro de Operaciones: Full history table with date, type, user, description
Observaciones: Yellow-highlighted notes field
Ubicación Física: Rack visualization with editable position

Reference: inventory-clise.component.ts:216-600

Maintenance Alerts

System automatically flags clisés requiring maintenance:

// Status badge logic (line 170-172)
<span *ngIf="!item.hasConflict && (item.mtl_acum || 0) < 500000" 
      class="bg-emerald-500/10 text-emerald-400">OK</span>

<span *ngIf="!item.hasConflict && (item.mtl_acum || 0) >= 500000" 
      class="bg-amber-500/10 text-amber-400">MANT.</span>

<span *ngIf="item.hasConflict" 
      class="bg-red-500/10 text-red-400 animate-pulse">REVISAR</span>

The 500,000 meter threshold is configurable. Adjust in the status calculation logic as needed for your production requirements.

Best Practices

Regular Meter Updates

Update mtl_acum after every production run to ensure accurate maintenance scheduling

Color Usage Tracking

Populate colorUsage array for multi-color clisés to identify high-wear colors

History Logging

Add history entries for all operations (production, maintenance, repairs) to maintain compliance

Die Linking

Link compatible dies to enable production planning and reduce setup time

Die Management - Compatible cutting tools
Rack Layout - Physical location visualization
Stock Control - Finished goods using these clisés

Overview

Getting Started

Core Features

Production Modules

Inventory Management

Quality & Analytics

Administration

Cliché (Clisé) Management

Overview

CliseItem Data Model

Field Descriptions

History Tracking

Example History Entry

KPI Statistics

Excel Import

Import Workflow

Die Linking

CRUD Operations

Add New Cliché

Update Existing Cliché

UI Component

Maintenance Alerts

Best Practices

Regular Meter Updates

Color Usage Tracking

History Logging

Die Linking

Build docs developers (and LLMs) love

Overview

Getting Started

Core Features

Production Modules

Inventory Management

Quality & Analytics

Administration

​Overview

​CliseItem Data Model

​Field Descriptions

​History Tracking

​Example History Entry

​KPI Statistics

​Excel Import

​Import Workflow

​Die Linking

​CRUD Operations

​Add New Cliché

​Update Existing Cliché

​UI Component

​Modal Sections

​Maintenance Alerts

​Best Practices

Regular Meter Updates

Color Usage Tracking

History Logging

Die Linking

​Related Topics

Build docs developers (and LLMs) love

Overview

CliseItem Data Model

Field Descriptions

History Tracking

Example History Entry

KPI Statistics

Excel Import

Import Workflow

Die Linking

CRUD Operations

Add New Cliché

Update Existing Cliché

UI Component

Modal Sections

Maintenance Alerts

Best Practices

Related Topics