🔨 Máquina de Estados del Remate (FSM)

🎯 Visión General

La Máquina de Estados Finita (FSM) del sistema de remate controla el ciclo de vida de cada lote en una subasta. Gestiona los diferentes estados del lote, valida transiciones, controla el temporizador y emite eventos en tiempo real a todos los participantes.

📊 Estados del Lote

Un lote puede estar en uno de los siguientes estados:

🎮 Comandos Disponibles

Los siguientes comandos pueden ser ejecutados por el rematador (rol AUCTIONEER) a través de WebSocket:

Ejemplo de envío de comandos (WebSocket)

// Abrir lote con duración de 30 segundos
ws.send(JSON.stringify({
  kind: 'OPEN_LOT',
  lotId: 'sala-100-LOT',
  payload: { durationMs: 30000 }
}));

// Pausar lote
ws.send(JSON.stringify({
  kind: 'PAUSE_LOT',
  lotId: 'sala-100-LOT'
}));

// Anunciar "Going Once"
ws.send(JSON.stringify({
  kind: 'GO_ONCE',
  lotId: 'sala-100-LOT'
}));

// Declarar vendido
ws.send(JSON.stringify({
  kind: 'DECLARE_AWARD',
  lotId: 'sala-100-LOT'
}));

📡 Eventos de la FSM

La FSM emite eventos en tiempo real que son recibidos por todos los participantes (rematador y postores) vía WebSocket y DataChannel:

Ejemplo de recepción de eventos

ws.onmessage = (event) => {
  const message = JSON.parse(event.data);

  if (message.type === 'EVENT') {
    console.log('Evento FSM:', message.kind);
    console.log('Payload:', message.payload);

    switch (message.kind) {
      case 'LOT_OPENED':
        console.log('Lote abierto:', message.payload.state);
        break;
      case 'BID_PLACED':
        console.log('Nueva puja:', message.payload.amount);
        console.log('Líder:', message.payload.leader);
        break;
      case 'AWARD_DECLARED':
        console.log('Lote vendido a:', message.payload.winnerId);
        break;
    }
  }
};

🔄 Flujo Típico de un Remate

💻 Ejemplos de Uso

1. Abrir un lote de 60 segundos

// Desde la vista del rematador (host-asm-stream.html)
const lotId = 'sala-100-LOT-001';
const durationMs = 60000; // 60 segundos

ws.send(JSON.stringify({
  kind: 'OPEN_LOT',
  lotId: lotId,
  payload: {
    durationMs: durationMs,
    minIncrement: 100, // Incremento mínimo de $100
    ownerId: 'user-123' // Opcional
  }
}));

2. Pujar desde un postor

// Desde la vista del postor (bidder-asm-stream.html)
ws.send(JSON.stringify({
  kind: 'PLACE_BID',
  lotId: 'sala-100-LOT-001',
  payload: {
    amount: 5000,
    userId: 'bidder-456'
  }
}));

3. Pausar y reanudar un lote

// Pausar (por ejemplo, para aclarar algo)
ws.send(JSON.stringify({
  kind: 'PAUSE_LOT',
  lotId: 'sala-100-LOT-001'
}));

// ... después de resolver ...

// Reanudar
ws.send(JSON.stringify({
  kind: 'RESUME_LOT',
  lotId: 'sala-100-LOT-001'
}));

4. Secuencia completa de remate

// 1. Abrir lote
ws.send(JSON.stringify({
  kind: 'OPEN_LOT',
  lotId: 'sala-100-LOT-001',
  payload: { durationMs: 30000 }
}));

// 2. Los postores pujan...
// (eventos BID_PLACED se reciben automáticamente)

// 3. Primera advertencia
ws.send(JSON.stringify({
  kind: 'GO_ONCE',
  lotId: 'sala-100-LOT-001'
}));

// 4. Segunda advertencia
ws.send(JSON.stringify({
  kind: 'GO_TWICE',
  lotId: 'sala-100-LOT-001'
}));

// 5. Declarar vendido
ws.send(JSON.stringify({
  kind: 'DECLARE_AWARD',
  lotId: 'sala-100-LOT-001'
}));

// 6. Al finalizar todo el remate
ws.send(JSON.stringify({
  kind: 'FINALIZE_AUCTION'
}));