Към съдържанието
Съдържание на курса

Урок 23 — Повторна обработка на провалилото се

От · съосновател и Chief Executive Officer на Hábil ·

Какво ще постигнеш: една врата в рутера, POST /rerun, през която човек да прати отново само стъпката, която е заседнала, без да дублира нищо в дестинациите и като остави записано кой го е поискал, защо и с коя версия е излязло.

Преди да започнеш, ти трябват: завършени уроци 22 и 18 и включена средата от урок 00.

Новото днес, в едно изречение

В урок 20 остави това, което не можа да се разбере, в conciliacion_pendiente, а в урок 22 — това, което прекъсвачът не прати, в pendiente. Двете чакат едно и също: някой да отстрани причината и да го прати отново. До днес този някой нямаше как. Rerun е този инструмент: още един опит за същата операция, поискан от човек и записан като такъв.

Картината: гишето за рекламации на куриерска фирма. Носиш товарителницата си и казваш: „тази пратка остана в склада заради бурята“. Не ти препращат всичко, което си пратил онзи ден: търсят тази пратка, проверяват дали наистина е заседнала и я експедират отново. В системата остава записано, че я е препратило гишето, по твоя молба, заради бурята. Ако носиш товарителницата на пратка, която вече е доставена, ти отказват.


1. Подготви папката си

cd lecciones/23-reprocesar-lo-que-fallo
cp -R inicio mio

Рутерът има нов файл, orden-router/rerun.camel.yaml, с един-единствен маршрут: rerun, който слуша на POST /rerun. Получава това:

{"orden": "4001", "momento": "creada", "canal": "edi",
 "pedido_por": "ana.soporte", "motivo": "el SFTP del socio estuvo caído"}

Отвори го и прочети коментара отгоре. Версията от inicio/ работи, но не стига. Отбелязва операцията като pendiente и я хвърля отново към разпределянето. Това има три проблема:

Проблем Защо е важно
Излиза като опит auto, без име и без мотив Утре никой не знае, че го е поискал човек, нито защо
Отваря отново това, което вече е минало успешно, и го праща пак Rerun на нещо прието вика дестинацията отново
Отговаря с 202 devuelta al reparto („върната към разпределянето“) Този, който го е поискал, не знае как е минало

И има нещо, което не трябва да строиш: таблицата intento вече има колоните tipo, pedido_por и motivo, а INSERT-ът на маршрута intentar (в reparto.camel.yaml) вече ги попълва с три променливи. Ако те не съществуват, tipo остава auto.

2. Предвиди

Отговори на лист хартия:

  1. SFTP на партньора се връща. Ако обработиш повторно цялата поръчка (трите канала) на 4001, какво става с API-то и с ERP, които вече я имаха?
  2. API-то се забави и каналът прекъсна: 4005 остана, без да се знае как е минала. Правиш rerun. Създава ли се още една поръчка в API-то? (Подсказка: уроци 02 и 18.)
  3. Някой иска rerun на операция, която вече е aceptada. Какво трябва да отговори рутерът?

Виж какво е положението днес:

./verifica inicio

Повторните обработки излизат и затова няколко отметки минават. Но излизат като опити auto, rerun-ът на вече приетото вика дестинацията отново, вместо да откаже, а такъв без мотив се приема въпреки това.

3. Ръчен опит, с име и мотив

Отвори mio/orden-router/rerun.camel.yaml. След петте променливи, които се вземат от тялото, има четири TODO и четирите заместват това, което е отдолу: UPDATE към pendiente, изпращането към seda:repartir и отговора 202.

TODO 1: без име или без мотив — не

Първо два хедъра, за да излезе отговорът чист: removeHeaders с pattern: "*" и един setHeader за Content-Type със стойност application/json. После един filter, който пропуска само грешното: ако липсва orden, momento, canal, pedido_por или motivo, отговаря с 400 и спира.

- filter:
    expression:
      simple:
        expression: >-
          ${variable.orden} == null || ${variable.orden} == '' || …
          ${variable.pedido_por} == null || ${variable.pedido_por} == '' ||
          ${variable.motivo} == null || ${variable.motivo} == ''
    steps:
      - setHeader:
          name: CamelHttpResponseCode
          expression:
            constant:
              expression: "400"
              resultType: java.lang.Integer
      - setBody:
          expression:
            constant:
              expression: '{"resultado":"no reprocesado","motivo":"faltan datos: orden, momento, canal, pedido_por y motivo"}'
      - stop: {}

stop приключва маршрута там: това, което е отдолу, не се изпълнява.

TODO 2: само това, което се е провалило

Прочети операцията от базата, не от тялото. Копирай заявката от маршрута repartir в reparto.camel.yaml и ѝ промени две неща: да филтрира и по p.canal = :#${variable.canal} вместо по p.estado = 'pendiente' и да връща и p.estado. Тя е с outputType: SelectOne, така че тялото остава като един ред (или null).

После един choice с два клона, които отговарят и спират, както filter-ът от TODO 1:

Ако Отговаря Защо
${body} == null 404 Няма такава операция
${body[estado]} in 'aceptada,confirmada,estacionada' 409 Приетото и потвърденото са минали успешно; паркираното го освобождава обхождането (урок 17)

Всичко останало (pendiente, no_se_sabe, conciliacion_pendiente, rechazada) продължава към TODO 3. Преди да продължиш, запази състоянието в променлива antes: ще го върнеш в отговора накрая.

TODO 3: един опит, тук и сега

Това е трудното днес. Повторната обработка не се хвърля в опашката: прави се един опит в същия този миг, със същите маршрути, които използва разпределянето.

  1. Един setVariable tipo с constant manual. С това INSERT-ът на intentar записва кой и защо (променливите pedido_por и motivo вече съществуват).
  2. Един to към direct:preparar, с реда в тялото. Сглобява плика, отпечатъка и контролния номер така, както го прави разпределянето.
  3. Един doTry с to към direct:intentar. В неговия doCatch за java.io.IOException (онова „не можа да се разбере“ от урок 20) — един UPDATE operacion SET estado = 'conciliacion_pendiente' WHERE id = :#${variable.operacion}: ръчният опит не се повтаря сам, връща се пред очите на този, който го е поискал.
  4. Един filter: ако ${variable.desenlace} == 'aceptada', един to към direct:barrido, както прави разпределянето. Нещо паркирано може да е чакало тази стъпка (урок 17).

TODO 4: кажи му как е минало

Отговори с 200 с това, което е останало в променливите:

- setBody:
    expression:
      simple:
        expression: '{"resultado":"reprocesado","operacion":${variable.operacion},"intento":${variable.intento},"antes":"${variable.antes}","desenlace":"${variable.desenlace}","codigo":${variable.codigo},"version":"${variable.version}"}'

Обърни внимание на последното поле. Опитът излиза с това, което е внедрено днес: действащия мапинг и шаблон, а не тези от деня, в който се е провалил. Ако между прекъсването и rerun-а някой е поправил мапинга, rerun-ът излиза поправен, а версията, с която е излязъл, остава записана в опита (version_mapeo) и в отговора.

4. Счупи едно нарочно

С всичко завършено махни втория клон на choice от TODO 2, този с 409. Пусни ./verifica.

Преди това предвиди: verifica иска rerun на 4001, която вече е aceptada при партньора. Какво става в дестинацията?

Рутерът прави ръчния опит: вика отново канала на партньора и операцията има един опит повече. Излиза в червено отметката за rerun-а на приетото. Одитната следа вече съдържа повторна обработка, от която никой не е имал нужда, а в дестинация, която не разпознава повторения, щеше да има дубликат. Рутерът не пита дестинацията дали вече го има: пита собствената си база. Върни клона.

5. Провери

./verifica

verifica изключва SFTP и праща четири поръчки; слага API-то в бавен режим и праща 4005; после връща всичко и прави пет rerun-а, по един за всяка заседнала стъпка. Накрая иска един за нещо прието и един без мотив. Урокът е завършен, когато видиш единайсетте зелени отметки:

✅ Arrancaron el router (con su POST /rerun), los tres canales y el sondeo
✅ Con el SFTP caído, el canal del socio de la 4001 a la 4004 quedó pendiente (lo que se reprocesa)
✅ Con la API lenta, el canal rest de la 4005 no supo cómo le fue y quedó (…)
✅ Rerun: el canal del socio de la 4001 a la 4004 y el rest de la 4005 quedaron aceptados
✅ Cada rerun quedó como intento «manual», con quién lo pidió, por qué y la versión del mapeo con que salió
✅ Sin duplicados: un 850 por orden en el socio, y la API creó la 4005 una vez y al rerun contestó 200 «reenvío»
✅ Solo el paso que falló: la API y el ERP de la 4001 a la 4004 no recibieron intentos nuevos
✅ Rerun de lo que ya está aceptado: 409, sin intento nuevo y la operación sigue (…)
✅ Rerun sin motivo: 400 (sin quién y por qué, el rastro quedaría mudo)
✅ El ERP reconoce un pedido que ya tiene: 200 «ya registrado», sin renglones nuevos
✅ El 997 del socio confirmó los cuatro 850 reprocesados

Виж шестата. API-то вече имаше 4005: бавното извикване я регистрира, след като каналът прекъсна, както в урок 20. Rerun-ът я прати отново със същия ключ и API-то отговори 200 reenvío („повторно изпращане“), а не 201. Точно това прави безопасен rerun-а на едно „неизвестно“.

Направи сам един rerun на ръка и виж отговора:

curl -s -XPOST localhost:8080/rerun -H 'Content-Type: application/json' \
  -d '{"orden":"4001","momento":"creada","canal":"edi","pedido_por":"yo","motivo":"probar"}'

Не тръгва? ./verifica solucion тества нашето решение, а diff mio/orden-router/rerun.camel.yaml solucion/orden-router/rerun.camel.yaml ти казва по какво се различават.

Какво виждаш Какво правиш
Esperaba 5 intentos manuales, а има 0 Липсва setVariable tipo със стойност manual или си сложил опита в опашката, вместо да извикаш direct:intentar
Se reprocesó de más: la API y el ERP … pasaron de … a … intentos Заявката ти не филтрира по канал: взема трите операции на събитието
Rerun de la 4001 ya aceptada: contestó … Липсва клонът с 409 или не носи stop
Rerun sin motivo: esperaba 400 На filter-а от TODO 1 му липсва motivo или му липсва stop
de las 5 operaciones reprocesadas, … quedaron aceptadas Липсва direct:preparar преди direct:intentar: без него няма нито плик, нито контролен номер
No pude poner la API en modo lento Твоят API е отпреди: пресъздай го както в урок 20
El puerto 8080 está ocupado Услугите от друго пускане са останали вдигнати: DONDE=mio docker compose -f compose.yaml down

Какво учи това извън курса

Повторната обработка е още един опит, а не нова операция. Ако беше нова, всяка дестинация щеше да я види като друга поръчка. Тъй като е същата операция, излиза със същия ключ и същия контролен номер и всяка дестинация може да я разпознае.

Обработва се повторно стъпката, а не поръчката. Да пратиш всичко отново „за всеки случай“ пълни одитната следа с шум и залага на това, че всички дестинации издържат на повторение. Праща се това, което се е провалило, и се отказва на това, което е минало успешно.

Кой и защо не са бюрокрация. След месец някой ще пита защо 4005 има два опита. Без pedido_por и motivo отговорът е „не знам“; с тях — „поиска го поддръжката, защото API-то беше бавно“.

Излиза с днешното и това се записва. Rerun-ът не съживява миналото: използва действащия мапинг. Затова всеки опит пази своята версия и затова може да се разбере какво е получила дестинацията всеки път.

Упражнение: гишето за рекламации

С твоята завършена версия пусни ./verifica и после:

  1. Провери опитите на канала на партньора за 4001: SELECT n, tipo, pedido_por, motivo, desenlace, version_mapeo FROM intento i JOIN operacion p ON p.id = i.operacion WHERE p.orden = '4001' AND p.canal = 'edi' ORDER BY n; Разкажи историята на тази операция в три изречения, с това, което казва всеки ред.
  2. Поискай три rerun-а на ръка: един за поръчка, която не съществува (9999), един за 4001 в канала rest и един без pedido_por. Запиши какво отговаря всеки и защо.
  3. Представи си, че утре поправяш мапинга на партньора до версия 2 и правиш rerun на 850-ка, която се е провалила вчера. С коя версия излиза? Къде можеш да го провериш? Защо не би било по-добре да излезе с вчерашната версия?

Защо е направено така

Какво решихме в този урок, заедно с това, което отхвърлихме, и какво би ни накарало да си променим мнението:

  • Ръчната повторна обработка е още един опит, с име и мотив

Преговор

  1. Кои състояния на една операция могат да се обработят повторно и кои — не? Защо и паркираното — не?
  2. Защо rerun-ът чете операцията от базата и не се доверява на това, което казва тялото?
  3. Какво пречи на един rerun на 4005 да създаде още една поръчка в API-то?
  4. Защо без pedido_por или без motivo се отговаря с 400?
  5. Заключителният въпрос: rerun-ът излиза с действащата конфигурация и оставя записана версията си. Защо с днешната и каква е ползата да се записва?

Следва: в урок 24 проблемът не е, че дестинацията е паднала, а че я събаряш ти. С три реплики на int-bd колко извиквания едновременно получава ERP?

Да обсъдим вашия проект

Предпочитате имейл? Пишете ни на hola@habil.mx