Съдържание на курса
Урок 26 — Проследяване на поръчка
От Dorian Chávez · съосновател и Chief Executive Officer на Hábil ·
Какво ще постигнеш: да отговориш на „какво стана с поръчка 4006?“ с една-единствена заявка: всеки канал, всеки опит, какво е излязло при всеки — изцяло, какво е отговорил партньорът и дали поръчката е завършена. И да поднесеш този отговор по HTTP, като търсиш по номера на поръчката.
Преди да започнеш, ти трябват: завършени уроци 15 и 25 и включена средата от урок 00.
Новото днес, в едно изречение
Вече единайсет урока записваш неща в базата на състоянието: поръчката (15), всяка операция и всеки опит (15), конфликтите (18), потвържденията на партньора (21), сигналите и завършеното (25). Всяка част отговаря на един малък въпрос. Днес ги събираш, за да отговориш на големия — този, който задава клиент или някой от поддръжката: „поръчката ми не пристигна, какво стана с нея?“. И отговаряш по бизнес ключа, номера на поръчката, който е единственото, което носи питащият.
Картината: проследяването на пратка в сайта на куриерска фирма. Въвеждаш номера на товарителницата и виждаш цялата история: приета в офис, в транзит, неуспешен опит за доставка, защото е нямало никого, доставена. Не виждаш само днешното състояние: виждаш всяка стъпка, с часа ѝ. Ако казваше само „доставена“, нямаше да знаеш, че е имало неуспешен опит, нито защо се е забавила два дни.
1. Подготви папката си
cd lecciones/26-seguir-una-orden
cp -R inicio mio
Рутерът има два нови файла:
| Файл | Какво е | Пишеш ли го? |
|---|---|---|
orden-router/recorrido.camel.yaml |
При стартиране декларира изгледа с това, което казва recorrido.sql. И обслужва GET /ordenes/{orden}/recorrido |
Не, прочети го |
orden-router/recorrido.sql |
Изгледът recorrido в базата на състоянието |
Да |
Изгледът е запазена заявка с име. Чете се, сякаш е таблица (SELECT * FROM recorrido WHERE orden = '4006'), но не пази нищо свое: всеки път, когато го четеш, събира отново истинските таблици. Затова не
остарява.
И от днес има нова таблица, payload. Всеки опит пази в intento своя отпечатък (sha256) и своя
размер, а цялото тяло на това, което е излязло, живее в payload, по веднъж на отпечатък. Ако два опита са пратили
едно и също, споделят реда.
Отвори infra/postgres/01-estado.sql и намери таблиците, които ще събираш: operacion, intento, payload, acuse,
alerta и completitud.
2. Предвиди
Отговори на лист хартия:
- Един клиент казва, че 4006 не е пристигнала. Какво проверяваш първо: лога на рутера, API-то, ERP или базата на състоянието? Защо?
- API-то беше паднало, когато пристигна 4006; после някой направи rerun. Ако изгледът показва само последния опит на всеки канал, коя част от историята се губи?
- 4007 носи 150 реда. Показва ли я логът на рутера цялата?
Виж какво е положението днес:
./verifica inicio
Изгледът съществува и GET отговаря, но това е табло на днешния ден: един ред на операция, с последния ѝ опит.
Историята на канала rest за 4006 се вижда като едно-единствено aceptada, без първия опит, при който не се разбра, и без това кой е направил
rerun-а. А колоната cuerpo излиза празна: не казва какво е излязло.
3. Сглоби пътя на поръчката
Отвори mio/orden-router/recorrido.sql. Това е CREATE VIEW със SELECT, който вече носи колоните с окончателните им
имена; някои засега излизат NULL. Има три TODO:
| TODO | Какво променяш | За какво |
|---|---|---|
| 1 | LEFT JOIN LATERAL (… LIMIT 1) u с LEFT JOIN intento i ON i.operacion = p.id, а колоните u. с i. |
Един ред за всеки опит, а не само за последния |
| 2 | Един LEFT JOIN payload d ON d.sha256 = i.sha256, а cuerpo идва от d.cuerpo |
Това, което е излязло при всеки опит, изцяло |
| 3 | Три колони, които днес са NULL: acuses, alertas и completa |
Това, което е дошло след изпращането |
За TODO 3 две от колоните са подзаявка, която събира няколко реда в един текст със string_agg:
(SELECT string_agg(a.codigo, ',' ORDER BY a.id) FROM acuse a WHERE a.operacion = p.id) AS acuses,
Тя дава например A или R: какво е казал партньорът за тази операция. Тази за alertas е същата, върху таблицата
alerta, за същата поръчка, същото събитие и същия канал, с l.tipo || ' en ' || l.estado. А completa
идва от LEFT JOIN completitud c ON c.orden = p.orden AND c.momento = p.momento, с c.completa.
Защо LEFT JOIN, а не JOIN? Защото операция, която още няма опити, или опит без потвърждение, или
събитие, което не е завършено, също трябва да излезе. С JOIN те биха изчезнали, а липсващото е точно
това, което е най-важно при проследяването на една поръчка.
А защо подзаявки за потвържденията и сигналите, а не още JOIN? Защото JOIN срещу таблица с няколко реда на
операция умножава редовете: всеки опит би излязъл по веднъж за всяко потвърждение. Подзаявката ги събира в една-единствена
клетка.
Остави имената на колоните както са: GET ги използва.
4. Счупи едно нарочно
С твоя завършен изглед махни LEFT JOIN completitud и остави completa като CAST(NULL AS timestamptz). Пусни
./verifica.
Преди това предвиди: 4007 е завършена. Какво казва изгледът?
Че не е. Излиза в червено последната отметка: изгледът казва, че нито 4007, нито 4006 са завършени. Нищо не се е провалило:
изгледът просто не гледаше тази таблица, а празна клетка се чете като „не се е случило“. Това, че едно проследяване не показва нещо,
не доказва, че то не се е случило. Затова се сглобява с LEFT JOIN срещу всичко, което базата знае. Върни реда.
5. Провери
./verifica
verifica изключва API-то, праща 4006 (която иска продукт, непознат на партньора) и 4007 (голяма, със 150
реда); включва отново API-то, прави rerun на канала rest за двете и иска пътя им. Урокът е завършен,
когато видиш осемте зелени отметки:
✅ Arrancaron el router (con su GET /ordenes/{orden}/recorrido), los tres canales y el sondeo
✅ El router declaró la vista recorrido al arrancar
✅ GET /ordenes/4006/recorrido: (…) filas, una por cada intento de la 4006
✅ El canal rest de la 4006 cuenta su historia: (…)
✅ El canal del socio de la 4006: rechazada, con su 997 de rechazo (R) en el recorrido
✅ Cada intento del recorrido trae lo que salió en él (cuerpo)
✅ La 4007 (grande): su cuerpo está entero en el recorrido, (…) bytes con su huella y sus 150 renglones
✅ El recorrido dice que la 4007 quedó COMPLETA y la 4006 no
Поискай пътя на поръчката сам:
curl -s localhost:8080/ordenes/4006/recorrido | python3 -m json.tool | less
Не тръгва? ./verifica solucion тества нашето решение, а
diff mio/orden-router/recorrido.sql solucion/orden-router/recorrido.sql ти казва по какво се различават.
| Какво виждаш | Какво правиш |
|---|---|
No existe la vista recorrido |
Твоят recorrido.sql има SQL грешка: рутерът я казва в лога, под тази отметка |
la vista tiene … y la 4006 tiene … intentos |
Още стои LATERAL … LIMIT 1 или JOIN на потвърждение е умножил редовете |
El canal rest de la 4006 en el recorrido: «aceptada/manual» без предишното |
Виждаш само последния опит: липсва TODO 1 |
intentos del recorrido sin su cuerpo |
Липсва LEFT JOIN payload или свързва по друга колона: трябва да е sha256 |
El canal del socio de la 4006 … (esperaba «rechazada R») |
Колоната acuses още е NULL |
Completa en el recorrido |
Липсва LEFT JOIN completitud |
El puerto 8080 está ocupado |
Услугите от друго пускане са останали вдигнати: DONDE=mio docker compose -f compose.yaml down |
Ако промениш recorrido.sql, докато услугите са вдигнати, рестартирай рутера: изгледът се декларира при стартиране.
Какво учи това извън курса
Търси се по това, което носи питащият. Никой от поддръжката не знае id на една операция, нито контролния номер
на един X12. Знае номера на поръчката. Проследяването се сглобява оттам.
Логът не е регистърът. Логът реже големите тела, смесва се с този на други поръчки и си отива заедно с контейнера. Базата пази всеки опит с това, което е излязло, изцяло, докато някой не го изтрие нарочно.
Историята струва повече от състоянието. „Приета“ казва как е завършило; историята казва, че първо не се е разбрало, че
прекъсвачът не я е пратил (урок 22), че някой от контролния център е направил rerun и че API-то е отговорило с 201. Във
verifica това изглежда така: no_se_sabe/auto no_enviado/auto aceptada/manual. С това се
обяснява защо се е забавила.
Изгледът не остарява. Не копира данните: събира ги отново всеки път. Това е най-евтиният начин да имаш пресен отговор без втори източник на истина.
Упражнение: проблемната поръчка
С твоята завършена версия пусни ./verifica и после:
- Поискай пътя на 4006 и само с него напиши един абзац за клиента, който казва, че поръчката му „не е пристигнала“. Стигнала ли е до API-то? До ERP? До партньора? Какво е станало при партньора, на кой ред и с кой продукт? (Подсказка: тялото на опита към партньора и 997 от урок 21.)
- Потърси 4007 в лога на рутера:
DONDE=mio docker compose -f compose.yaml logs orden-router | grep 4007. Виждаш ли нейните 150 реда? Сравни с колонатаtamanoв изгледа. - Напиши заявката, която би дал на някого от поддръжката, за да види само каналите, които не са приключили добре, за една
поръчка, с последния им резултат. Започни със
SELECT canal, estado_canal, … FROM recorrido WHERE orden = '4006'.
Защо е направено така
Какво решихме в този урок, заедно с това, което отхвърлихме, и какво би ни накарало да си променим мнението:
- Пътят на поръчката е изглед
Преговор
- Какво е изглед и защо не остарява?
- Защо пътят на поръчката се търси по нейния номер?
- Какво пази таблицата
payloadи как се свързва с всеки опит? - Защо
LEFT JOIN, а неJOIN? Защо подзаявки за потвържденията? - Заключителният въпрос: един клиент казва, че поръчката му не е пристигнала. Какво проверяваш първо и защо пътя на поръчката, а не лога?
Следва: в урок 27 погледни отново пътя на 4008. Той носи името, адреса, телефона и имейла на един човек. Кой трябва да може да ги вижда?
Предпочитате имейл? Пишете ни на hola@habil.mx