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

Урок 15 — Състоянието живее извън процеса

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

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

Преди да започнеш, ти трябват: завършен урок 14, включена средата от урок 00 (базата на състоянието, estado, е тази, която вдигна още първия ден и която досега не се използваше) и твоят отговор на заключителния въпрос от урок 12.

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

До урок 14 рутерът получаваше поръчката, викаше трите канала, чакаше и отговаряше на магазина какво е казал всеки. Ако рутерът паднеше по средата, никой не знаеше кои дестинации вече имат поръчката. От днес рутерът първо записва, а после разпределя: запазва поръчката в PostgreSQL, отговаря на магазина 202 recibida („получена“) и едва когато магазинът е спокоен, тръгва да разпределя.

Картината: гишето на куриерска фирма. Приемат ти пратката, регистрират я в системата и ти дават разписка. Не стоиш на гишето, докато тя стигне до местоназначението си. Разписката важи, защото пратката вече е регистрирана, а не защото служителят те помни. Ако смяната се смени, този, който идва, чете регистъра.

Върни се към отговора си от урок 12: „ако рутерът имаше реплики, къде щеше да живее информацията за всяка поръчка?“. Днес отговаряме: извън процеса, в база. Така всяка реплика на рутера може да я прочете, а ако една падне, записаното остава там.


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

cd lecciones/15-el-estado-vive-fuera-del-proceso
cp -R inicio mio

Рутерът вече има три файла. Отвори ги в този ред:

Файл Какво прави Пишеш ли го?
orden-router.camel.yaml Получава поръчката или пратката, нарежда да се запише, отговаря с 202 и слага разпределянето на опашка Не, прочети го
estado.camel.yaml Записва в базата. Тук е guardar-orden, твоята работа Да
reparto.camel.yaml Чете от базата чакащото, записва опита, вика канала и записва как е минало Не, прочети го

И отвори схемата на базата, infra/postgres/01-estado.sql. Днес са важни три таблици:

Таблица Един ред за… Важното
orden поръчка На кое събитие от жизнения цикъл е (creada, embarcada, entregada) и нейните datos — поръчката такава, каквато е пристигнала
operacion поръчка, събитие и канал Какво трябва да се направи във всяка дестинация и как е завършило (estado: pendiente, aceptada, rechazada, no_se_sabe)
intento всеки път, когато е опитана една операция Отпечатъкът на това, което е излязло, версията на мапинга и резултатът

Една поръчка от франчайз при създаването си оставя един ред в orden и три в operacion: rest, bd и edi.

2. Предвиди

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

  1. Днес рутерът отговаря с 202, макар че guardar-orden не записва нищо. Какво според теб става с поръчката след 202? (Подсказка: разпределянето чете от базата чакащото.)
  2. Ако ERP е изключен, когато пристигне поръчката, какво трябва да отговори рутерът на магазина? И какво трябва да остане в базата?

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

./verifica inicio

Магазинът получава своето 202, а после не се случва нищо: базата няма поръчката и никоя дестинация не я получава. Рутерът обеща нещо, което не изпълни. Това е най-лошата грешка в този курс, защото магазинът вярва, че всичко е минало добре.

3. Запиши, преди да отговориш

Отвори mio/orden-router/estado.camel.yaml и намери guardar-orden. Има три TODO. Образецът ти е точно отдолу: guardar-momento прави същото за пратката. Прочети го целия, преди да пишеш.

TODO Какво пишеш За какво
1 transacted с ref: todoONada Поръчката и операциите ѝ да останат всички или нито една (същата идея от урок 05, сега в състоянието)
2 Един to със sql:INSERT INTO orden (orden, momento, datos) VALUES (…) Редът на поръчката: номерът ѝ, събитието 'creada' и цялата поръчка като jsonb
3 Един split върху ${variable.canales.split(',')} с INSERT INTO operacion … вътре По една операция на канал, в 'pendiente', със своята нишка. Тази на партньора — със своя контролен номер

Три подсказки:

  • Променливите, които ти трябват, вече съществуват, когато се вика този маршрут: orden, canales и correlacion. Тялото е поръчката, както я е пратил магазинът.
  • За да запишеш тялото като jsonb: CAST(:#${body} AS jsonb). :#${…} е начинът, по който компонентът sql подава стойност като параметър, без да я лепи към текста на SQL-а.
  • INSERT INTO operacion от guardar-momento върши почти същата работа: променя се събитието.

Обърни внимание на реда с контролния номер: CASE WHEN :#${body} = 'edi' THEN CAST(nextval('numero_control_seq') AS text) END. Само операцията на партньора иска номер от секвенцията. От днес контролния номер на X12 го присвоява рутерът, той вече не идва от номера на поръчката, както в уроци 06 и 13.

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

С твоя завършен guardar-orden изключи базата на състоянието и прати една поръчка на рутера:

DONDE=mio docker compose -f compose.yaml up -d
docker compose -f ../../infra/compose.yaml stop estado
curl -i -XPOST localhost:8080/ordenes -H 'Content-Type: application/json' -d @../../datos/ordenes/tramo-2/orden-4003.json

Преди да я пратиш, предвиди: отговаря ли рутерът с 202?

Не отговаря: връща грешка. Без база не може да запише, а без да запише, не обещава. Магазинът вижда грешката и знае, че трябва да опита отново. Точно обратното на inicio/, който отговаряше с 202, без да записва. Включи всичко отново:

docker compose -f ../../infra/compose.yaml start estado
DONDE=mio docker compose -f compose.yaml down

5. Провери

./verifica

verifica праща 4001 и нейната пратка, проверява базата и дестинациите, а накрая изключва ERP и праща 4002. Урокът е завършен, когато видиш дванайсетте зелени отметки:

✅ Arrancaron el router (con su base de estado), los tres canales y el sondeo
✅ La tienda mandó la 4001 y el router contestó 202 «recibida»
✅ Estado: una fila de la orden 4001, con sus datos
✅ Estado: tres operaciones de la 4001, una por canal, y las tres aceptadas
✅ Estado: cada operación tiene su intento, con huella sha256, versión del mapeo y desenlace
✅ Destinos: la API tiene la 4001 CREADO y el ERP REGISTRADO
✅ Socio: el 850 de la 4001 lleva en el ISA el número de control de la base (…)
✅ Estado: el embarque de la 4001 tiene sus tres operaciones aceptadas y la orden va en «embarcada»
✅ Socio: el 856 lleva su propio número de control (…), distinto del 850 (…)
✅ Destinos: la API tiene la 4001 EMBARCADO
✅ Con el ERP caído, la tienda recibió su 202 por la 4002
✅ Estado: la operación del ERP quedó sin aceptar y está guardada (…); las otras dos siguieron

Контролните номера се променят при всяко пускане: дава ги секвенцията.

Виж последните две. При паднал ERP магазинът все пак получи своето 202, защото рутерът записа, а това, което не излезе, остана записано: операцията bd на 4002 е в no_se_sabe или rechazada, докато API-то и партньорът вече я имат. В урок 14 това се губеше в някой лог. Днес е в ред, който може да се провери.

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

Какво виждаш Какво правиш
no está la fila de la orden 4001 Липсва INSERT-ът в orden или не носи dataSource: "#estado"
esperaba «bd=aceptada edi=aceptada rest=aceptada» y hay «nada» Липсва split за операциите или INSERT-ите са останали извън него
column "datos" is of type jsonb but expression is of type… Пропуснал си CAST(:#${body} AS jsonb)
el 850 … no lleva el número de control de la base Операцията edi е записана без numero_control: провери CASE WHEN
El puerto 8080 está ocupado Услугите от стъпка 4 са останали вдигнати: DONDE=mio docker compose -f compose.yaml down

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

Да отговориш „получено“ е обещание и то се изпълнява само ако вече е записано. Затова рутерът първо записва. Същото прави банката с един превод: дава ти референтния номер, когато той вече е в книгата ѝ, а не когато преводът е пристигнал.

Състоянието извън процеса е това, което позволява на рутера да расте. Процес, който помни в паметта си, не може да се размножи: всяка реплика би помнила различни неща, а при рестарт би забравила. С базата всяка реплика чете едно и също.

Разделянето на „получих“ от „доставих“ променя разговора. Магазинът вече не чака да отговорят трите дестинации. В замяна някой трябва да гледа какво е останало чакащо: точно това строи част 3.

Упражнение: поръчката в три таблици

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

docker compose -f ../../infra/compose.yaml exec estado psql -U router -d estado
  1. На хартия нарисувай поръчка 4001 в трите таблици: една кутийка за нейния ред в orden, по една за всяка operacion (създаване и изпращане) и по една за всеки intento, със стрелки коя към коя сочи.
  2. Напиши заявката, която ти казва за 4002 в какво състояние е всеки канал. Започни със SELECT canal, estado FROM operacion WHERE orden = '4002' и ѝ добави събитието.
  3. Какъв контролен номер има 850-ката на 4001 и какъв имаше в урок 06? Откъде идва всеки и защо този, който дава базата, не се повтаря, дори две поръчки да пристигнат по едно и също време?

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

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

  • Записваме, преди да отговорим
  • Контролния номер на X12 го присвоява рутерът

Преговор

  1. Какво пази всяка от трите таблици, orden, operacion и intento?
  2. Защо рутерът записва поръчката, преди да отговори с 202, а не след това?
  3. За какво е транзакцията в guardar-orden? Какво би станало без нея, ако вторият INSERT се провали?
  4. При паднал ERP какво получи магазинът и какво остана в базата? Какво ставаше със същата тази поръчка в урок 14?
  5. Заключителният въпрос: от днес контролния номер на X12 го присвоява рутерът. Откъде идваше той в урок 06 и какво се промени? Сравни с отговора си от урок 12 за това къде живее информацията за всяка поръчка.

Следва: в урок 16 идва третото събитие: куриерската фирма съобщава, че е доставила. Никой не я пита: обажда се сама, през webhook. Какво трябва да се случи в състоянието и на SFTP?

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

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