Съдържание на курса
Урок 23 — Повторна обработка на провалилото се
От Dorian Chávez · съосновател и 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. Предвиди
Отговори на лист хартия:
- SFTP на партньора се връща. Ако обработиш повторно цялата поръчка (трите канала) на 4001, какво става с API-то и с ERP, които вече я имаха?
- API-то се забави и каналът прекъсна: 4005 остана, без да се знае как е минала. Правиш rerun. Създава ли се още една поръчка в API-то? (Подсказка: уроци 02 и 18.)
- Някой иска 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: един опит, тук и сега
Това е трудното днес. Повторната обработка не се хвърля в опашката: прави се един опит в същия този миг, със същите маршрути, които използва разпределянето.
- Един
setVariabletipoсconstantmanual. С товаINSERT-ът наintentarзаписва кой и защо (променливитеpedido_porиmotivoвече съществуват). - Един
toкъмdirect:preparar, с реда в тялото. Сглобява плика, отпечатъка и контролния номер така, както го прави разпределянето. - Един
doTryсtoкъмdirect:intentar. В неговияdoCatchзаjava.io.IOException(онова „не можа да се разбере“ от урок 20) — единUPDATE operacion SET estado = 'conciliacion_pendiente' WHERE id = :#${variable.operacion}: ръчният опит не се повтаря сам, връща се пред очите на този, който го е поискал. - Един
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 и после:
- Провери опитите на канала на партньора за 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;Разкажи историята на тази операция в три изречения, с това, което казва всеки ред. - Поискай три rerun-а на ръка: един за поръчка, която не съществува (
9999), един за 4001 в каналаrestи един безpedido_por. Запиши какво отговаря всеки и защо. - Представи си, че утре поправяш мапинга на партньора до версия 2 и правиш rerun на 850-ка, която се е провалила вчера. С коя версия излиза? Къде можеш да го провериш? Защо не би било по-добре да излезе с вчерашната версия?
Защо е направено така
Какво решихме в този урок, заедно с това, което отхвърлихме, и какво би ни накарало да си променим мнението:
- Ръчната повторна обработка е още един опит, с име и мотив
Преговор
- Кои състояния на една операция могат да се обработят повторно и кои — не? Защо и паркираното — не?
- Защо rerun-ът чете операцията от базата и не се доверява на това, което казва тялото?
- Какво пречи на един rerun на 4005 да създаде още една поръчка в API-то?
- Защо без
pedido_porили безmotivoсе отговаря с 400? - Заключителният въпрос: rerun-ът излиза с действащата конфигурация и оставя записана версията си. Защо с днешната и каква е ползата да се записва?
Следва: в урок 24 проблемът не е, че дестинацията е паднала, а че я събаряш ти. С три реплики на int-bd колко извиквания едновременно получава ERP?
Предпочитате имейл? Пишете ни на hola@habil.mx