Dodaci

Šta učimo ovog semestra

Dodaci: rječnik, formule, Mermaid, SQL, HTTP, šabloni, ispitni zadaci i izvori priča.

Zašto ovo poglavlje

Dodaci su priručnik za brzo ponavljanje i za rad na projektu: rječnik pojmova, sve formule na jednom mjestu, podsjetnici za Mermaid, SQL i HTTP, šabloni dokumenata, ispitni zadaci s rješenjima i izvori istinitih priča iz knjige.

A. Rječnik

B. Formule

C. DeliveryApp na jednom mjestu

Pravila: PP-1 najmanja narudžba 5,00 €; PP-2 dostava 2,00 € do 3 km, plus 0,50 € za svaki započeti km preko 3 km; PP-3 najdalje 10 km; PP-4 od 30,00 € dostava besplatna; PP-5 STUDENT10 daje 10 % na artikle, najviše 5,00 €; PP-6 otkazivanje samo u stanju NOVA ili PRIHVAĆENA.

Nefunkcionalni zahtjevi: NZ-1 95 % odgovora ≤ 2 s pri 200 korisnika; NZ-2 dostupnost 99,5 % (≤ 3,6 h u 30 dana); NZ-3 lozinke kao heš, restoran dvofaktorski; NZ-4 prva narudžba ≤ 3 min, kontrast ≥ 4,5 : 1; NZ-5 adresa i telefon se brišu 12 mjeseci poslije posljednje narudžbe.

Narudžbe: N-1001 = 24,50 € (sa STUDENT10 22,35 €); N-1002 = 32,00 €; N-1003 odbijena (4,50 €); N-1004 odbijena (11 km); N-1005 = 25,60 €.

Stanja: NOVA, PRIHVAĆENA, ODBIJENA, U_PRIPREMI, NA_PUTU, ISPORUČENA, OTKAZANA; 7 dozvoljenih i 42 nedozvoljena prelaza.

C. DeliveryApp na jednom mjestu

Fajlovi u primjeri/deliveryapp/: deliveryapp.py (pravila i stanja), model.py (klase), schema.sql i podaci.sql (baza), baza.py, api.py i openapi.yaml (API), hladnjak.py (realno vrijeme), test_deliveryapp.py (testovi), Dockerfile i requirements.txt (kontejner); primjeri/ci/ci.yml (GitHub Actions); primjeri/mermaid/ (izvori dijagrama).

D. Podsjetnik: Mermaid

U vlastitom Markdown fajlu blok počinje sa ``` `mermaid ``. Natpise sa razmacima, zagradama, dvotačkom ili znakovima < i >` stavite pod navodnike.

flowchart LR                          dijagram toka (LR lijevo-desno, TD odozgo)
    A["Kupac"] -->|narudžba| B(("DeliveryApp"))
    C{"Iznos ≥ 30 €?"} -- da --> D["0,00 €"]

classDiagram                          klase
    class Narudzba { +broj: str  -stanje: str  +ukupno() int }
    Kupac "1" --> "0..*" Narudzba : pravi
    Narudzba "1" *-- "1..*" Stavka : sadrži
    Korisnik <|-- Kupac

sequenceDiagram                       sekvence
    actor K as Kupac
    K->>S: zahtjev
    S-->>K: odgovor
    alt uslov
    else drugi uslov
    end

stateDiagram-v2                       stanja
    state "PRIHVAĆENA" as PRIHVACENA
    [*] --> NOVA
    NOVA --> PRIHVACENA: restoran prihvati

erDiagram                             baza
    KUPAC ||--o{ NARUDZBA : pravi

C4Context                             arhitektura
    Person(kupac, "Kupac", "opis")
    System(z, "DeliveryApp", "opis")
    Rel(kupac, z, "naručuje")

E. Podsjetnik: SQL

CREATE TABLE stavka (
    narudzba TEXT NOT NULL REFERENCES narudzba(broj) ON DELETE CASCADE,
    jelo     INTEGER NOT NULL REFERENCES jelo(id),
    kolicina INTEGER NOT NULL CHECK (kolicina > 0),
    PRIMARY KEY (narudzba, jelo)
);
INSERT INTO stavka VALUES ('N-1001', 1, 2);
SELECT n.broj, SUM(s.kolicina * s.cijena_u_trenutku) AS artikli
FROM narudzba n JOIN stavka s ON s.narudzba = n.broj
WHERE n.kupac = ?                    -- parametar, nikad zalijepljen tekst
GROUP BY n.broj ORDER BY n.broj;
UPDATE narudzba SET stanje = 'PRIHVAĆENA' WHERE broj = 'N-1001';
DELETE FROM adresa WHERE kupac IN (...);
BEGIN; ... COMMIT;                   -- ili ROLLBACK;
CREATE INDEX ix_narudzba_restoran ON narudzba(restoran);

U SQLiteu: PRAGMA foreign_keys = ON; uključuje provjeru stranih ključeva. Prazna vrijednost se provjerava sa IS NULL.

F. Podsjetnik: HTTP

F. Podsjetnik: HTTP

HTTPie: http GET :8000/v1/jela restoran==R-1 (parametar u adresi), http POST :8000/v1/cijena kupac=K-01 udaljenost_km:=4.2 (= tekst, := broj ili JSON), http PATCH … X-Kupac:K-01 (zaglavlje).

G. Šabloni dokumenata

Vizija

# Vizija – <sistem>
## Problem
## Za koga
## Rješenje u jednoj rečenici
Za … koji …, <sistem> je … koji … . Za razliku od …, … .
## Kako mjerimo uspjeh
## Pravila posla
## Šta nije u prvoj verziji

Korisnička priča (GitHub Issue)

Kao <uloga>, želim <nešto>, da bih <korist>.

Kriteriji prihvatanja
1. Dato … Kada … Tada …
2. Dato … Kada … Tada …

Prioritet: M / S / C / W · Veličina: … bodova · Pripada: UC-…

G. Šabloni dokumenata

Specifikacija slučaja korištenja

# UC-<broj> <Naziv>
| Polje | Sadržaj |
| --- | --- |
| Primarni akter | |
| Sekundarni akteri | |
| Cilj | |
| Preduslovi | |
| Okidač | |
| Postuslov (uspjeh) | |
| Postuslov (neuspjeh) | |
| Poslovna pravila | |
## Glavni tok
1. …
## Alternativni tokovi
- 3a. …

ADR

# ADR-<broj>: <Odluka>
- Status: predloženo / prihvaćeno / zamijenjeno ADR-…
- Datum:
## Kontekst
## Odluka
## Posljedice
+ …
− …
## Razmotrene opcije

G. Šabloni dokumenata

Red modela prijetnji

| Element | STRIDE | Prijetnja | V | U | Rizik | Odbrana |

Dnevnik AI pomoći

| Datum | Alat | Zadatak | Šta je predloženo | Šta je prihvaćeno | Kako je provjereno |

H. Ispitni zadaci s rješenjima

Zadaci su na proširenju DeliveryApp. Udruženje dodaje četvrti restoran, R-4 Pekara, s jelima: burek 3,50 €, jogurt 1,20 €, kroasan 2,00 €. Pekara radi od 6 do 14 h i nudi novo pravilo PP-7: narudžbe primljene prije 8 h imaju dostavu 1,00 € jeftiniju (ali ne ispod 0,00 €).

Zadatak 1 – zahtjevi. Napišite PP-7 kao korisničku priču i dva kriterija prihvatanja s brojevima. Postavite jedno pitanje koje otkriva nejasnoću pravila.

Rješenje. „Kao kupac koji naručuje doručak, želim jeftiniju dostavu prije 8 h, da bih platio manje.” Kriterij 1: Dato su 2 bureka i 1 jogurt (8,20 €), 4,2 km, narudžba u 7:30; Kada kupac otvori pregled; Tada vidi dostavu 3,00 − 1,00 = 2,00 € i ukupno 10,20 €. Kriterij 2: isto u 8:15 → dostava 3,00 €, ukupno 11,20 €. Pitanje: računa li se vrijeme narudžbe ili vrijeme plaćanja, i šta je s narudžbom u tačno 8:00? (Nejasnoća granice, kao „započeti kilometar” u PP-2.)

Zadatak 2 – proces i stanja. Pekara želi da kupac može naručiti uveče „za sutra u 7 h”. Koje novo stanje treba mašini stanja i koji prelazi? Da li se PP-6 mijenja?

H. Ispitni zadaci s rješenjima

Rješenje. Novo stanje ZAKAZANA: [*] → ZAKAZANA (plaćanje odobreno, termin u budućnosti); ZAKAZANA → NOVA (vremenski događaj: 30 min prije termina); ZAKAZANA → OTKAZANA (kupac otkaže / vrati novac). PP-6 treba proširiti: otkazivanje je dozvoljeno i u stanju ZAKAZANA. U tabeli prelaza sada je 8 stanja (64 para) i 9 dozvoljenih prelaza (sedam starih i dva nova; ulaz iz početnog čvora se ne broji kao par stanja).

Zadatak 3 – baza. Šta treba dodati u šemu iz poglavlja 8 za R-4 i PP-7? Napišite SQL za izmjenu.

Rješenje. Radno vrijeme restorana i vrijeme termina narudžbe: ALTER TABLE restoran ADD COLUMN otvara TEXT; ALTER TABLE restoran ADD COLUMN zatvara TEXT; ALTER TABLE narudzba ADD COLUMN termin TEXT; i u CHECK za stanje dodati 'ZAKAZANA'. Popust iz PP-7 se ne čuva posebno, jer kolona dostava već pamti obračunati iznos u trenutku narudžbe. Jela R-4 su novi redovi u tabeli jelo.

Zadatak 4 – dostupnost. Pekara prima narudžbe od 6 h, kad je i redovno održavanje servera (30 minuta svake srijede od 6:00). Koliko to zastoja daje mjesečno (4 srijede) i kako se uklapa u NZ-2?

H. Ispitni zadaci s rješenjima

Rješenje. 4 × 30 min = 2 h mjesečno od 3,6 h budžeta; ostaje 1,6 h za sve ostale kvarove. Bolje je održavanje pomjeriti na noć (npr. 3:00), kad nema ni jednog otvorenog restorana, ili ga raditi bez zastoja (plavo–zelena isporuka, poglavlje 14).

Zadatak 5 – API. Koji statusni kod vraća POST /v1/narudzbe za narudžbu iz R-4 u 15:00? Napišite poruku za korisnika.

Rješenje. 422 (zahtjev je ispravan JSON, ali krši pravilo radnog vremena), ili 409 ako se zatvoren restoran shvata kao sukob sa stanjem; tim bira i zapisuje u OpenAPI. Poruka: „Pekara radi od 6 do 14 h. Možete zakazati narudžbu za sutra od 6 h.”

Zadatak 6 – sigurnost. Navedite dvije prijetnje STRIDE za novu funkciju zakazivanja i odbranu.

Rješenje. T: kupac promijeni vrijeme narudžbe u zahtjevu na 7:30 da dobije PP-7, iako naručuje u 9:00 → server popust računa po vremenu servera, ne po vremenu iz zahtjeva. D: napadač zakaže hiljade lažnih narudžbi za sutra → plaćanje unaprijed, ograničenje broja zakazanih narudžbi po kupcu i ograničenje broja zahtjeva.

H. Ispitni zadaci s rješenjima

Zadatak 7 – testovi. Napišite bar tri jedinična testa za PP-7 (opis ulaza i očekivanog izlaza).

Rješenje. (1) 8,20 €, 4,2 km, 7:30 → dostava 200 centi. (2) isto u 8:15 → 300 centi. (3) 8,20 €, 2 km, 7:00 → osnovna dostava 200 − 100 = 100 centi; (4) granica: 30,00 € u 7:00 → 0 centi (ne −100), jer PP-7 kaže „ne ispod 0,00 €”.

Zadatak 8 – realno vrijeme. Pekara ima peć s tri senzora temperature i glasanjem dva od tri. Senzori pokazuju 182 °C, 180 °C i 25 °C. Šta glasač vraća i šta sistem treba uraditi?

Rješenje. Dva senzora se slažu (oko 181 °C), pa glasač vraća njihov prosjek, 181 °C. Treći senzor (25 °C) je vjerovatno pokvaren: sistem nastavlja rad, ali pali upozorenje za održavanje, jer sada nema rezerve: ako otkaže još jedan, glasanje više nije moguće.

I. Izvori priča

Brojevi u pričama provjereni su u ovim izvorima (oktobar 2026). Gdje se izvori razilaze, u tekstu je napisana opreznija vrijednost („oko”, „više od”).

I. Izvori priča

I. Izvori priča

Za Netflixovu priču o 2008. i za podatke o Knight Capitalu (osam servera, ponovo upotrijebljena oznaka) korišteni su i izvještaji s kraja tih godina; ako se kasnije pojave precizniji podaci, okviri se usklađuju s njima.