Съдържание на курса
Урок 25 — Изчакване на каналите
От Dorian Chávez · съосновател и Chief Executive Officer на Hábil ·
Какво ще постигнеш: да знаеш кога една поръчка е завършена: когато всеки канал, който ѝ се полага, е стигнал до това, което се очаква от него, включително 997 от партньора. И за канал, който се бави прекалено, да се сигнализира, без поръчката да се затваря, така че закъснялото все още да я завърши, дори рутерът да се е рестартирал междувременно.
Преди да започнеш, ти трябват: завършени уроци 21 и 22 и включена средата от урок 00.
Новото днес, в едно изречение
От урок 10 рутерът разпръсква: праща всяко събитие от жизнения цикъл на поръчката към нейните канали. Никога не го събира: няма място, което да казва „тази поръчка вече приключи“. А в урок 21 видя, че „да приключиш“ не е едно и също за всички: API-то и ERP приключват, когато приемат, а партньорът — когато прати своя 997. Да разпръснеш и после да събереш отговорите е шаблон с име, Scatter-Gather, а частта със събирането се нарича Aggregator. Днес го строиш, с една идея, която идва от урок 15: това, което трябва да се събере, вече е в базата.
Картината: организирането на новогодишната вечеря с трима братовчеди, които носят по нещо. Лелята не обявява вечерята за готова, когато всеки братовчед е казал „идвам“: обявява я за готова, когато храната е на масата. Ако в девет този с десерта не е дошъл, лелята не зачерква десерта и не обявява вечерята за завършена: звъни му да пита. А ако десертът пристигне в девет и половина, вечерята е завършена тогава. Ако лелята излезе за малко на двора, не губи сметката: масата си стои там с това, което вече е пристигнало.
1. Подготви папката си
cd lecciones/25-esperar-a-los-canales
cp -R inicio mio
Отвори първо mio/orden-router/reglas/maquina-de-estados.yaml и намери секцията completa. Там е това, което се
очаква от всеки канал, и колко се чака за него:
| Канал | llega_a |
plazo_s |
Защо |
|---|---|---|---|
rest (API-то) |
aceptada |
10 | Неговото „да“ пристига в същото извикване |
bd (ERP) |
aceptada |
10 | Същото |
edi (партньорът) |
confirmada |
20 | Неговото „да“ е 997 и пристига по-късно (урок 21) |
Сега отвори mio/orden-router/juntar.camel.yaml. Отгоре има рисунка на 4001 по средата на пътя: API-то и ERP вече
са стигнали, партньорът още не. И има един маршрут, vigilar, вече готов: часовник (timer), който на всеки 2 секунди чете
правилата и вика два маршрута:
| Маршрут | Какво прави | Къде го записва |
|---|---|---|
juntar |
Обявява за ЗАВЪРШЕНО всяко събитие, чиито канали всички са стигнали до своето llega_a |
Таблица completitud, един ред на поръчка и събитие |
vencidos |
Сигнализира за всеки канал, който е минал срока си, без да стигне | Таблица alerta и един WARN в лога |
Защо часовник, а не да чакаме нещо да съобщи? Защото това, което не пристига, не съобщава. Един 997, който никога не идва, не предизвиква никакво събитие. Някой трябва да гледа часовника.
Обърни внимание какво липсва: няма агрегатор, който да пази в паметта на рутера кои канали вече са отговорили. Всяка
операция и нейното състояние живеят в таблицата operacion от урок 15. Да събереш значи да попиташ базата.
2. Предвиди
Отговори на лист хартия:
- API-то и ERP приеха 4001, а 850-ката беше оставена. Партньорът не е пратил 997. Завършена ли е поръчката?
- 3001 е от собствен магазин: не носи EDI (урок 11). Кога е завършена?
- Минават 20 секунди, а 997 на 4002 не пристига. Кое е по-добре: да обявиш поръчката за завършена, за да спре да пречи, или да сигнализираш и да я оставиш отворена? Какво става във всеки от случаите, ако 997 пристигне на 30-ата секунда?
- Рестартираш рутера, докато 4002 чака своя 997. Губи ли се това, което вече беше събрано?
Виж какво е положението днес:
./verifica inicio
Излиза зле още от първата отметка: 4001 става COMPLETA преди своя 997, защото версията от inicio/ обявява
едно събитие за завършено, когато никой канал не е останал pendiente, а една оставена 850-ка е aceptada. А 4002, когато срокът ѝ изтече,
се затваря насила: става завършена, без партньорът да е отговорил каквото и да е.
3. Събирай и наблюдавай
В juntar.camel.yaml има две TODO, по едно във всеки маршрут. И двете са SQL заявка, която вече е почти цяла.
TODO 1: завършена значи „всеки канал е стигнал до своето“
Заявката на juntar свързва всяка операция с правилото на нейния канал и групира по поръчка и събитие:
INSERT INTO completitud (orden, momento)
SELECT p.orden, p.momento
FROM operacion p JOIN jsonb_each(CAST(:#${variable.reglas} AS jsonb)) AS r(canal, regla) ON r.canal = p.canal
WHERE NOT EXISTS (SELECT 1 FROM completitud c WHERE c.orden = p.orden AND c.momento = p.momento)
GROUP BY p.orden, p.momento
HAVING bool_and(p.estado NOT IN ('pendiente', 'estacionada')) -- ← esta condición
ON CONFLICT DO NOTHING
RETURNING orden, momento
Чете се така:
| Част | Какво прави |
|---|---|
jsonb_each(…) AS r(canal, regla) |
Превръща правилата в редове: по един на канал, с неговото llega_a и неговия plazo_s |
JOIN … ON r.canal = p.canal |
Към всяка операция закача правилото на нейния канал |
GROUP BY p.orden, p.momento |
Събира операциите на всяко събитие от всяка поръчка |
HAVING bool_and(…) |
Събитието минава само ако условието е вярно за всички негови операции |
ON CONFLICT DO NOTHING |
Едно събитие се завършва само веднъж |
Твоята работа е условието в HAVING. Днес то казва „никоя не е останала чакаща или паркирана“. Трябва да казва „всяка
е в състояние от своето llega_a“:
HAVING bool_and(jsonb_contains(r.regla -> 'llega_a', to_jsonb(p.estado)))
r.regla -> 'llega_a' е списъкът от правилото, например ["confirmada"]; to_jsonb(p.estado) е състоянието на
операцията като JSON стойност; jsonb_contains пита дали второто е в първото.
Обърни внимание на нещо, което идва безплатно: 3001 няма операция edi, защото е от собствен магазин. Щом няма
ред, не се брои: никой не чака 997, който не ѝ се полага.
TODO 2: просроченото сигнализира и не затваря
Заявката на vencidos днес пише в completitud: затваря събитието, когато срокът изтече. Промени я така, че да пише
сигнал в alerta, по веднъж на канал:
| Промяна | Какво пишеш |
|---|---|
| Къде | INSERT INTO alerta (orden, momento, canal, tipo, estado, espera) |
| Какво | SELECT p.orden, p.momento, p.canal, 'vencido', p.estado, r.regla ->> 'llega_a' (без DISTINCT) |
| Кои | Добави към WHERE: NOT jsonb_contains(r.regla -> 'llega_a', to_jsonb(p.estado)), за да сигнализираш само за каналите, които не са стигнали |
| Веднъж | Остави ON CONFLICT DO NOTHING: таблицата alerta има UNIQUE (orden, momento, canal, tipo) |
| За лога | Добави RETURNING orden, momento, canal, estado, espera и outputType: SelectList |
А след заявката — един split върху ${body} с log на ниво WARN за всеки нов сигнал, като split-а на
juntar. Съобщението започва с VENCIDO orden ${body[orden]} momento ${body[momento]} canal ${body[canal]}.
4. Счупи едно нарочно
С всичко завършено махни от WHERE на vencidos условието NOT jsonb_contains(…). Пусни ./verifica.
Преди това предвиди: 4002 чака своя 997 повече от 20 секунди. API-то и ERP я приеха за няколко секунди. Колко сигнала очакваш?
Три вместо един. Без това условие часовникът сигнализира за всеки канал, който е надхвърлил срока си, независимо дали е стигнал, или не: API-то и ERP, които вече са приели, също излизат като просрочени. Излиза в червено отметката за сигнала на 4002. Сигнал, който се включва за нещо, което е наред, учи хората да пренебрегват сигналите и тогава важният се губи. Върни условието.
5. Провери
./verifica
verifica праща една поръчка от собствен магазин и една от франчайз, чака 997; после изключва системата на партньора и
праща 4002, изчаква срокът да изтече, рестартира рутера и включва отново партньора. Урокът е завършен, когато видиш
седемте зелени отметки:
✅ Arrancaron el router (con su reloj que junta y vigila), los tres canales y el sondeo
✅ La 4001: API y ERP aceptada y el 850 depositado, pero sin 997 todavía no está COMPLETA
✅ La 3001 (tienda propia): COMPLETA con la API y el ERP; el socio no le toca y no se le espera
✅ La 4001: llegó el 997, el socio quedó confirmada y la orden COMPLETA
✅ La 4002 sin 997 pasó su plazo: un solo aviso (vencido, en «aceptada», se espera confirmada) y sigue abierta
✅ Log: el aviso del vencido está en el log del router
✅ Tras reiniciar el router, el 997 tardío confirmó al socio y la 4002 quedó COMPLETA, con su único aviso como historia
Прочети последната спокойно. Рутерът се рестартира по средата на чакането, а 4002 се завърши въпреки това. Не си писал нищо за това: това, което се събираше, никога не е живяло в паметта на рутера — живееше в базата. Когато се върна, часовникът попита отново и намери същото, плюс 997, който току-що беше пристигнал.
Виж двете таблици:
docker compose -f ../../infra/compose.yaml exec estado psql -U router -d estado \
-c "SELECT * FROM completitud ORDER BY completa" -c "SELECT orden, canal, estado, espera, creada FROM alerta"
Не тръгва? ./verifica solucion тества нашето решение, а
diff mio/orden-router/juntar.camel.yaml solucion/orden-router/juntar.camel.yaml ти казва по какво се различават.
| Какво виждаш | Какво правиш |
|---|---|
La 4001 con el socio en «aceptada» ya quedó COMPLETA |
HAVING още е с условието от inicio/: смени го с jsonb_contains |
La 3001 (tienda propia) no quedó COMPLETA |
Липсва JOIN с правилата или си сменил bool_and с нещо друго |
La 4002 sin 997: hay 0 avisos и completa=1 |
vencidos продължава да пише в completitud: трябва да е в alerta |
La 4002 sin 997: hay 3 avisos |
Липсва NOT jsonb_contains(…) в WHERE на vencidos |
no está el WARN del vencido de la 4002 |
Липсва RETURNING с outputType: SelectList или split с неговия log на ниво WARN |
No está arriba socio-bot |
Вдигни средата: docker compose -f infra/compose.yaml up -d --wait |
El puerto 8080 está ocupado |
Услугите от друго пускане са останали вдигнати: DONDE=mio docker compose -f compose.yaml down |
Какво учи това извън курса
Да разпръснеш е лесно; работата е в събирането. Да пратиш нещо към няколко дестинации го прави всеки multicast. Да знаеш кога всички са приключили, всеки със собствената си представа за „приключих“, е това, което казва на бизнеса, че поръчката вече е навсякъде.
Това, което не пристига, не съобщава. Система, която само реагира на събития, никога не научава какво липсва. Трябва нещо, което гледа часовника и пита.
Да сигнализираш не значи да затвориш. Затварянето насила при изтичане на срока казва „приключи“ за нещо, което не е приключило, а ако липсващото пристигне късно, вече не променя нищо. Сигналът оставя човек да реши и оставя закъснялото все още да се брои.
Ако състоянието живее извън процеса, рестартът не е проблем. В урок 15 го казахме като теория; днес го видя: рутерът се рестартира по средата на чакането и не загуби нищо, без нито един допълнителен ред код.
Упражнение: новогодишната вечеря
- Преди да пускаш каквото и да е, запиши на хартия предвиждането си за въпрос 4 по-горе: губи ли се събраното при
рестарт? След като пуснеш
./verifica, сравни го със случилото се и напиши къде живееше събраното. - Смени в правилата
plazo_sна партньора на5и пусни./verifica. Кои отметки се променят и защо? Какво би станало с хората, които обслужват сигналите, ако срокът беше толкова кратък в реалния живот? Върни го на20. - Представи си, че рутерът имаше три реплики, всяка със свой часовник. Щеше ли една поръчка да се завърши три пъти? Щеше ли да се сигнализира
три пъти за едно просрочие? (Подсказка: потърси двете
UNIQUEиON CONFLICT.)
Защо е направено така
Какво решихме в този урок, заедно с това, което отхвърлихме, и какво би ни накарало да си променим мнението:
- Да събереш значи да попиташ базата, а просроченото сигнализира, без да затваря
Преговор
- Какво е Scatter-Gather? Коя част от курса разпръсква и коя събира?
- Какво чака всеки канал, за да се смята за приключил, и къде е записано това?
- Защо е нужен часовник, за да се събира?
- Защо 3001 се завършва без 997?
- Заключителният въпрос: когато срокът на партньора изтече, рутерът сигнализира и оставя поръчката отворена. Защо затварянето ѝ насила би било по-лошо? Използвай закъснелия 997 на 4002 в отговора си.
Следва: в урок 26 един клиент казва, че поръчката му не е пристигнала. Имаш базата, лога и дестинациите. Какво проверяваш първо и как възстановяваш цялото пътуване на една поръчка?
Предпочитате имейл? Пишете ни на hola@habil.mx