Съдържание на курса
Урок 15 — Състоянието живее извън процеса
От Dorian Chávez · съосновател и 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. Предвиди
Отговори на лист хартия:
- Днес рутерът отговаря с 202, макар че
guardar-ordenне записва нищо. Какво според теб става с поръчката след 202? (Подсказка: разпределянето чете от базата чакащото.) - Ако 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
- На хартия нарисувай поръчка 4001 в трите таблици: една кутийка за нейния ред в
orden, по една за всякаoperacion(създаване и изпращане) и по една за всекиintento, със стрелки коя към коя сочи. - Напиши заявката, която ти казва за 4002 в какво състояние е всеки канал. Започни със
SELECT canal, estado FROM operacion WHERE orden = '4002'и ѝ добави събитието. - Какъв контролен номер има 850-ката на 4001 и какъв имаше в урок 06? Откъде идва всеки и защо този, който дава базата, не се повтаря, дори две поръчки да пристигнат по едно и също време?
Защо е направено така
Какво решихме в този урок, заедно с това, което отхвърлихме, и какво би ни накарало да си променим мнението:
- Записваме, преди да отговорим
- Контролния номер на X12 го присвоява рутерът
Преговор
- Какво пази всяка от трите таблици,
orden,operacionиintento? - Защо рутерът записва поръчката, преди да отговори с 202, а не след това?
- За какво е транзакцията в
guardar-orden? Какво би станало без нея, ако вторият INSERT се провали? - При паднал ERP какво получи магазинът и какво остана в базата? Какво ставаше със същата тази поръчка в урок 14?
- Заключителният въпрос: от днес контролния номер на X12 го присвоява рутерът. Откъде идваше той в урок 06 и какво се промени? Сравни с отговора си от урок 12 за това къде живее информацията за всяка поръчка.
Следва: в урок 16 идва третото събитие: куриерската фирма съобщава, че е доставила. Никой не я пита: обажда се сама, през webhook. Какво трябва да се случи в състоянието и на SFTP?
Предпочитате имейл? Пишете ни на hola@habil.mx