Hoppa till innehållet
POLARISAI ACADEMY
R02-401 · Navigatör

Fullstack-bygge för skarp drift

Efteråt kan du släppa igenom eller avvisa en session utifrån klockan och raden, ta ett köat jobb så att nästa arbetare ändrar 0 rader, godkänna 2 av 4 JSON-objekt och logga anropet på en rad med 5 nycklar, dela en SSE-ström och återuppta från senaste id, och räkna satser i en migrering plus anropen i en upstream-fallback.

Nivå
Navigatör
Tid
30 h (uppskattning)
Förkunskap
R02-301
Kurs 4 av 4
Hoppa till

Efter kursen kan du

Eleven kan bygga en full-stack-applikation med strömmande svar, databasmigreringar och automatisk upstream-failover som klarar end-to-end-integrationstester och fault-injection-tester.

Sessionsraden och cookien

Autentisering här är en rad i tabellen session plus cookien på förfrågan. Tabellen har tre kolumner: token, user_name och exp. exp är en hel minut på den här klockan. Hanteraren släpper igenom när en rad matchar cookien och now fortfarande ligger under exp. Exemplens rader är ab12 för ada med exp 1800, och cd34 för bo med exp 1700, så tabellen börjar med 2 rader. Klockan står på 1730. Cookie sid=ab12 träffar ada. 1800 minus 1730 är 70, alltså 70 minuter kvar, och hanteraren släpper igenom. Antalet rader stannar på 2. Cookie sid=cd34 träffar bo. 1730 minus 1700 är 30, så klockan har gått 30 minuter förbi exp. Hanteraren svarar status 401 och tar bort den raden. Kvar ligger 1 rad, ab12. Cookie sid=zz99 träffar 0 rader. Hanteraren svarar status 401 och tar bort 0 rader, så antalet stannar på 1.

En inloggning jämför två färdiga hashsträngar, tecken för tecken. adas lagrade hash är h7, 2 tecken. Kontrollen ger tillbaka h7 för lösenordet horse, och horse har 5 tecken. Hashsträngarna matchar, så hanteraren lägger in token ef56 med exp 1730 plus 60, alltså 1790. Tabellen har 2 rader igen. Kontrollen ger tillbaka h8 för lösenordet mule. h8 och h7 skiljer sig, så hanteraren lägger in 0 rader och svarar status 401. Lösenordet horse står i 0 sessionkolumner. Cookien vid träff är sid=ef56; HttpOnly; SameSite=Lax. HttpOnly håller den cookien borta från sidans skript. Med SameSite=Lax skickar webbläsaren cookien på en same-site-förfrågan och på en toppnivå-GET från en annan sajt, och den håller inne cookien på en cross-site-POST. Av de tre skicken går cookien med på 2.

Ta ett köat jobb

Kön för bakgrundsjobb (background job queue) är tabellen job. Varje rad har id, note_id och state. state är queued, run eller done. Exemplens rader är id 1 queued, id 2 run och id 3 queued, så antalet queued börjar på 2. Anspråket är UPDATE job SET state = 'run' WHERE id = ? AND state = 'queued', med id bundet vid frågetecknet. SQLite tar en skrivning i taget. Arbetare A tar id 1 och satsen ändrar 1 rad. id 1 står då som run, och antalet queued är 1, den kvarvarande id 3. Arbetare B kör samma sats för id 1 och den ändrar 0 rader, eftersom WHERE fortfarande kräver queued. B lämnar modellanropet åt A. Arbetare A tar id 3 och satsen ändrar 1 rad. Antalet queued är 0 och antalet run är 3. Ett anspråk på id 2 ändrar 0 rader, eftersom id 2 redan var run.

Avslutningen är UPDATE job SET state = 'done' WHERE id = ? AND state = 'run'. Arbetare A avslutar id 1 och satsen ändrar 1 rad. Antalet run är 2 och antalet done är 1. En avslutning mot ett id som fortfarande är queued ändrar 0 rader, eftersom det WHERE kräver run. Heltalet du skriver upp är rader ändrade. 1 betyder att den här arbetaren tog steget. 0 betyder att raden redan hade passerat det state satsen namnger.

Fyra objekt och en loggrad

Strukturerad output är här ett JSON-objekt med ett fast schema. Objektet ska ha nycklarna sku och qty, och varje annan nyckel underkänns. sku är en sträng med längd 1 till och med 8, och varje tecken är en versal eller en siffra. qty är ett heltal från 0 till och med 99, skrivet med siffror och med decimaltecken ingenstans i token. Objekt 1 är {"sku":"OATS","qty":2}. sku har längd 4 och qty är 2, så det går igenom. Objekt 2 är {"sku":"OATS","qty":"2"}. qty är en sträng, så objektet underkänns. Objekt 3 är {"sku":"OATMEAL1","qty":0}. OATMEAL1 har längd 8, sista tecknet är en siffra, och qty är 0, så det går igenom. Objekt 4 är {"sku":"OATS","qty":2,"note":"x"}. Det objektet har 3 nycklar, så det underkänns. Av de 4 objekten går 2 igenom.

Strukturerad JSON-loggning skriver ett JSON-objekt på en egen rad för varje upstream-försök. Raden har precis nycklarna ts, level, event, status och calls, alltså 5 nycklar. Ett godkänt anrop mot primärvärden skriver {"ts":"2026-11-14T17:00:00Z","level":"info","event":"upstream","status":200,"calls":1}. Värdet OATS står 0 gånger på den raden. Svarets kropp ligger kvar i responsen. Raden bokför anropet. Status 200 vars objekt faller på schemat skriver level error och event parse, med status fortfarande 200 och calls 1. Värdet parse har 5 tecken, och värdet error har 5 tecken.

Tre skickade SSE-händelser

Server-Sent Events, SSE, är blockströmmen här under. En tom rad avslutar ett block. Block 1 har raderna id: 1, retry: 3000 och data: oat. Block 2 har id: 2 och data: s. Block 3 har : ping. Block 4 har id: 3, event: done och data: {"sku":"OATS","qty":2}. En rad som börjar med kolon är en kommentar och lägger inget i databufferten. id-raden sätter id-bufferten sedan ett inledande mellanslag efter kolonet tagits bort, så id: 1 lagrar strängen 1, ett tecken. retry: 3000 sätter väntan vid återanslutning till 3000 millisekunder, alltså 3 sekunder, eftersom värdet bara är siffror. data: oat bidrar med oat, 3 tecken, och data: s bidrar med s, 1 tecken. Ett inledande mellanslag efter kolonet tas bort, och resten av värdet blir kvar.

En tom rad skickar en händelse när databufferten har text, och tömmer sedan bufferten. Den skickade händelsen tar id-bufferten som senaste händelse-id. En tom buffert skickar 0 händelser, och det är vad block 3 gör. Block 1 och 2 saknar event-rad, så båda skickas med typen message. Block 4 sätter typen till done. Strömmen skickar 3 händelser. Hanteraren fogar sedan ihop data från varje message-händelse i id-ordning, som ett eget steg, medan tråden håller händelserna åtskilda. oat följt av s blir oats, 4 tecken. Data i done är {"sku":"OATS","qty":2}, 22 tecken, samma text som objekt 1. Efter hela strömmen är senaste händelse-id 3. När socketen stänger efter den andra skickningen är senaste händelse-id 2. Återanslutningen bär headern Last-Event-ID med värdet 2, och klienten väntar 3000 millisekunder först. Den här servern skickar sedan bara block vars id, läst som heltal, är större än 2. Den skickar block 4, och klienten tar emot 1 ny händelse. Den ihopfogade message-texten förblir oats.

Upp, ned och reservvärden

Databasmigreringar är de numrerade SQL-filerna. Du kör den lägsta version som saknas, och du backar den högsta versionen. 001_up.sql har 3 satser: skapa schema_migration med version som heltalsnyckel, skapa note med id och body, lägg in version 1. 001_down.sql har 2 satser: släpp note, släpp schema_migration. 002_up.sql har 2 satser: skapa job med id, note_id och state, lägg in version 2. 002_down.sql har 2 satser: släpp job, ta bort raden vars version är 2. 003_up.sql har 2 satser: skapa note_sku med note_id och sku, lägg in version 3. 003_down.sql har 2 satser: släpp note_sku, ta bort raden vars version är 3. På en tom fil kör upp genom 3 sammanlagt 3 plus 2 plus 2 satser, alltså 7. MAX(version) är 3, och tabellerna är schema_migration, note, job och note_sku, alltså 4. Ned från 3 till en tom fil kör 2 plus 2 plus 2 satser, alltså 6, och antalet tabeller är 0, så versionen du läser tillbaka är 0. När version 1 och 2 redan ligger inne är MAX(version) 2 och antalet tabeller 3. Nästa upp kör bara 003, 2 satser, MAX(version) blir 3, och antalet tabeller blir 4. Ett steg ned från 3 kör 2 satser, MAX(version) går tillbaka till 2, och antalet tabeller går tillbaka till 3. Att ändra 001_up.sql sedan version 1 och 2 är sparade ändrar 0 sparade rader. Nästa ändring är en ny fil.

Fallback mot upstream anropar primärvärden, sedan högst en reservvärd. Status 200 med ett objekt som klarar schemat stannar på primärvärden: antalet anrop är 1 och utfallet är primary. Status 429 eller status 500 anropar reservvärden en gång. Reservvärd med status 200 och ett godkänt objekt slutar på 2 anrop och utfallet backup. Reservvärd med status 429 eller 500 slutar på 2 anrop och utfallet failed. Status 400 stannar på primärvärden: antalet anrop är 1 och reservvärden anropas 0 gånger. Status 200 med ett underkänt objekt stannar också på primärvärden: antalet anrop är 1, reservvärden anropas 0 gånger, och utfallet är parse. Exemplets omgång har fyra förfrågningar. Förfrågan A är primär 200 med objekt 1: anrop 1, utfall primary. Förfrågan B är primär 429, sedan reserv 200 med objekt 3: anrop 2, utfall backup. Förfrågan C är primär 500, sedan reserv 500: anrop 2, utfall failed. Förfrågan D är primär 200 med objekt 2: anrop 1, utfall parse. De fyra anropsantalen är 1, 2, 2 och 1, och de blir 6 tillsammans. Reservvärden används i 2 av de 4 förfrågningarna.

Ett exempel

En eftermiddag, räknad på papper

Börja vid minut 1730 med de två sessionsraderna och de tre jobbraderna. Cookie sid=ab12 träffar ada, 70 minuter återstår, och hanteraren släpper igenom. Anspråket på id 1 ändrar 1 rad. Primärvärden svarar med de fyra SSE-blocken och status 200. Strömmen skickar 3 händelser, hanteraren fogar ihop message-datan till oats, 4 tecken, och done-blocket bär objekt 1, 22 tecken, som klarar schemat. Upstream-anropen stannar på 1, utfallet är primary, och loggraden har 5 nycklar med värdet OATS 0 gånger. Databasen har redan version 1 och 2, så den här förfrågan kör 0 migreringssatser och MAX(version) stannar på 2.

Fortsätt på samma blad. Cookie sid=cd34 ligger 30 minuter förbi exp 1700, så hanteraren svarar 401 och sessionstabellen har 1 rad. Arbetare B tar id 1 och ändrar 0 rader. När A också har tagit id 3 är antalet queued 0. Objekt 2 faller på schemat, och den kroppen är förfrågan D: anrop 1, utfall parse, reservanrop 0. Förfrågan B, primär 429 och sedan reserv 200 med objekt 3, använder 2 anrop. Förfrågan C, primär 500 och sedan reserv 500, använder 2 anrop och utfallet är failed. Omgången blir 1 plus 2 plus 2 plus 1, alltså 6. Från version 2 kör 003_up.sql 2 satser och MAX(version) blir 3, med 4 tabeller.

Skriv en rad markeringar du kan räkna om. Minuter kvar på ab12: 70. Status för cd34: 401. Sessionsrader efter den borttagningen: 1. Rader som andra anspråket på id 1 ändrar: 0. Objekt som går igenom: 2 av 4. Nycklar på loggraden: 5. Kopior av OATS på den raden: 0. SSE-händelser som skickas: 3. Last-Event-ID efter avbrott när id 2 har skickats: 2. Nya händelser från den här servern: 1. Satser i nästa upp från version 2: 2. Anrop i omgången: 6. Gånger reservvärden används: 2.

Övning

Kolla på papper

Klockan står på 200. Sessionsraderna är k1 med exp 200, och k2 med exp 260. Med samma regel, now ska ligga under exp, skriv status för k1 och status för k2, och skriv hur många rader som återstår när den utgångna raden tagits bort. Den lagrade hashen är qq och kontrollen ger tillbaka qq. Skriv det exp du sparar på den nya raden när du lägger 60 minuter till 200, och skriv radantalet efter den insättningen. Jobb 4, 5 och 6 är queued. En arbetare tar 4, sedan 5. En andra arbetare tar 4. Skriv rader ändrade för var och en av de tre satserna, och skriv antalet queued på slutet. Säg vad schemat gör med {"sku":"BEEF","qty":99}, med {"sku":"BEEF","qty":99.0} och med {"sku":"beef","qty":1}. En SSE-ström har id: 1 med data: be, id: 2 med data: ef, och id: 3 med event: done och data: {"sku":"BEEF","qty":99}. Skriv den ihopfogade message-texten. Socketen stänger efter första skickningen. Skriv värdet på Last-Event-ID och hur många händelser den här servern skickar härnäst. MAX(version) är 1. Skriv antalet satser när du bara kör 002_up.sql, nya MAX(version) och antalet tabeller. Primärvärden svarar 500 och reservvärden svarar 200 med BEEF-objektet som går igenom. Skriv antalet anrop och utfallet. Skriv sedan antalet anrop och antalet reservanrop för primärstatus 400.

k1 får status 401, eftersom now är lika med exp, och k2 släpps igenom, eftersom 260 minus 200 är 60. Efter borttagningen återstår 1 rad. Nya exp är 260, och tabellen har 2 rader efter insättningen. Anspråken ändrar 1 rad, sedan 1 rad, sedan 0 rader, och antalet queued slutar på 1. {"sku":"BEEF","qty":99} går igenom. {"sku":"BEEF","qty":99.0} underkänns eftersom qty-token innehåller ett decimaltecken. {"sku":"beef","qty":1} underkänns eftersom sku har gemener. Den ihopfogade message-texten är beef, 4 tecken. Last-Event-ID är 1, och den här servern skickar 2 händelser, blocket med id 2 och blocket med id 3. 002_up.sql kör 2 satser, MAX(version) blir 2, och tabellerna är schema_migration, note och job, alltså 3. Vägen 500 sedan 200 använder 2 anrop och utfallet är backup. Primärstatus 400 använder 1 anrop, och reservvärden anropas 0 gånger.

Kontrollfrågor

Svara själv först. Öppna sedan frågan för att se svaret.

Vid minut 1730, vilken status får cookie sid=cd34, och hur många sessionsrader återstår efter den borttagningen?

Status 401. Klockan har gått 30 minuter förbi exp 1700, raden tas bort, och 1 sessionsrad återstår.

id 1 börjar som queued. Arbetare A tar det, sedan kör arbetare B samma anspråk. Hur många rader ändrar varje sats, och vad är antalet queued sedan A också tagit id 3?

A ändrar 1 rad och B ändrar 0 rader. När A också tagit id 3 är antalet queued 0.

Hur många av de fyra exemplens objekt klarar schemat, och hur många gånger står OATS på info-loggraden?

2 av de 4 objekten går igenom. Loggraden har 5 nycklar, och OATS står 0 gånger på den.

SSE-socketen stänger sedan id 2 har skickats. Vad är Last-Event-ID, hur många nya händelser skickar den här servern, och hur många anrop gör förfrågan B?

Last-Event-ID är 2, och den här servern skickar 1 ny händelse. Förfrågan B, primär 429 och sedan en godkänd reserv, gör 2 anrop.

Ta med dig

Sätt poäng på förfrågan med klockan mot exp, raderna ett anspråk ändrar, objekten som går igenom, de 5 nycklarna på loggraden, SSE-händelserna och senaste id, satserna i nästa migreringsfil, och anropen innan reservvärden används.

Slutuppgift

Lämna in en container/bundle för en full-stack-webbapplikation som klarar 50 automatiska end-to-end-tester, inklusive simulerade upstream-svar 500/429, återhämtning av SSE-ström och SQL-migreringar som går rent upp och ned. (Valfri Portfolio-post: publik livedemo).

Slutuppgiften rättas av fasta facit och automatiska tester när proven öppnar.

Begrepp i kursen

Kursen har inga egna begrepp i ordlistan ännu. Begrepp från tidigare kurser används här också.

Fler lektioner kommer

Första lektionen är öppen att läsa. Resten av kursens lektioner skrivs, och prov och diplom kommer senare. Till väntelistan