🟢 Caso 08 — Extraccion de modulo critico sin romper operacion#

Implementacion operativa del caso 08 con paridad al stack PHP. Compatibilidad de contrato implementada con Proxy nativo + EventEmitter para emitir cada avance de cutover.

⬅️ Caso 08 · ⚖️ Comparativa de los 7 stacks · 🟢 Perfil de Node.js · 🧬 Todos los perfiles

Que resuelve#

Compara dos formas de extraer un modulo critico de pricing:

pricing-bigbang: corta el modulo de una vez. Si los consumidores no estan alineados al nuevo contrato, rompe en el path critico (TypeError / 409 / 502 segun escenario).
pricing-compatible: el llamado pasa por un Proxy de compatibilidad que traduce campos (cost_usd → price) en vuelo y avanza el cutover por consumidor; el bus de eventos publica cada avance.

Escenarios: stable, rule_drift, shared_write, peak_sale, partner_contract. Consumers: checkout, marketplace, backoffice, partner_api.

Primitiva Node-especifica#

const compatibilityProxy = new Proxy(newPricingModule, {
  get(target, prop, receiver) {
    if (prop === 'computeFinalPrice') {
      return (payload) => {
        if (payload?.cost_usd !== undefined && payload.price === undefined) {
          payload = { ...payload, price: payload.cost_usd };
        }
        return Reflect.get(target, prop, receiver).call(target, payload);
      };
    }
    return Reflect.get(target, prop, receiver);
  },
});

El codigo de negocio sigue llamando pricing.computeFinalPrice(payload). La traduccion vive en el Proxy, no en el negocio. Adicionalmente un EventEmitter (cutoverBus) publica cada advance y mantiene un log circular en memoria.

Arranque#

bash

docker compose -f compose.yml up -d --build

Puerto local: 828 (modo aislado, ver opciones abajo).

Como consumir (dos opciones)#

Hub Node.js (recomendado, 8300 en compose.nodejs.yml): este caso queda servido en http://localhost:8300/08/... junto a los otros 11 casos.

Modo aislado (828 en este compose.yml): levanta solo este caso, util cuando la medicion necesita procesar limpio (sin otros casos compartiendo runtime).

Endpoints#

bash

curl http://localhost:8300/08/
curl http://localhost:8300/08/health
curl "http://localhost:8300/08/pricing-bigbang?scenario=rule_drift&consumer=checkout"
curl "http://localhost:8300/08/pricing-compatible?scenario=rule_drift&consumer=checkout"
curl "http://localhost:8300/08/cutover/advance?consumer=checkout&step=25"
curl http://localhost:8300/08/extraction/state
curl "http://localhost:8300/08/flows?limit=10"
curl http://localhost:8300/08/diagnostics/summary
curl http://localhost:8300/08/metrics
curl http://localhost:8300/08/metrics-prometheus
curl http://localhost:8300/08/reset-lab

Que observar#

pricing-bigbang con rule_drift rompe con TypeError; pricing-compatible lo absorbe via Proxy y devuelve 200;
cutover_log muestra cada avance emitido por el EventEmitter;
app_consumer_cutover_progress{consumer="..."} en Prometheus permite ver el corte gradual.