4. tēma: 4.5 CYOA stāsta zaru plānošana

Tavs šīs stundas izaicinājums: Analizēt teksta piedzīvojumu spēles gaitu, izstrādāt vizuālu algoritma shēmu un strukturēt spēles loģiku pirms reālā koda rakstīšanas.

2.4.1. Analizē problēmu, identificē datus un veic decompozīciju.
2.4.6. Plāno un dokumentē programmatūras izstrādes procesu.

Teorija: Algoritmu shēmu simboli un to nozīme kodā

Pirms programmēšanas sarežģīta spēles loģika (Kā spēlētājs pārvietosies starp telpām?) ir jāvizualizē. Izstrādē tam izmanto standartizētus algoritmu shēmu simbolus, kuriem ir tieša saistība ar Python sintaksi.

Oval (Ovāls): Sākuma vai beigu punkts ("Game Over" vai "Uzvara").

# Beigu punkts kodā bieži nozīmē vienkārši funkcijas beigas
print("Spēle beigusies! Tu uzvarēji!")
return

Rectangle (Taisnstūris): Process vai darbība. Mūsu spēlē katra istaba vai lokācija būs atsevišķa funkcija.
```
# Taisnstūris shēmā = Funkcija kodā
def pils_varti():
    print("Tu stāvi pie lieliem dzelzs vārtiem.")
```

Diamond (Rombs): Lēmuma pieņemšanas punkts. Lietotājam tiek uzdots jautājums.

# Rombs shēmā = Input un If/Else zarošanās
izvele = input("Atvērt vārtus (A) vai bēgt (B)? ")
if izvele == "A":
    # Iet tālāk...

Arrow (Bulta): Plūsmas virziens. Norāda, kura koda daļa vai funkcija tiks izsaukta nākamā.
```
# Bulta shēmā = Funkcijas izsaukšana
pils_pagrabs() # Pāreja uz nākamo lokāciju
```

1. uzdevums: Mini-zara skice

Sagatavo vienkāršu algoritma shēmu ar vienu lēmuma punktu un diviem iznākumiem, izmantojot pareizos simbolus.

Izpildes soļi:

Izmanto digitālu rīku (piemēram, bezmaksas atvērtā pirmkoda rīku Draw.io pārlūkprogrammā) vai lapu un zīmuli.
Uzzīmē sākuma punktu "Meža mala" (izmanto Taisnstūri vai Ovālu atkarībā no tā, vai tas ir stāsta pats sākums).
Pievieno lēmuma punktu, uzzīmējot rombu: "Iet alā vai kāpt kalnā?".
No romba izvelc divas bultas uz diviem atšķirīgiem beigu punktiem (Ovāliem): "Atradi dārgumus" (Uzvara) un "Iekriti bedrē" (Zaudējums).
Saglabā shēmu savā datorā.

2. uzdevums: Lielā piedzīvojuma karte

Projektē sarežģītāku spēles plūsmu, savienojot vairākas lokācijas vienotā tīklā, lai izvairītos no loģikas kļūdām.

Izpildes soļi:

Izplāno stāstu, uzzīmējot vismaz 5 dažādas lokācijas kā taisnstūrus (piem., "Sākums", "Gaitenis", "Sarga istaba", "Dārgumu zāle", "Lamatas").
Nodrošini vismaz divus dažādus veidus, kā spēlē zaudēt, un vienu ceļu uz uzvaru.
Iekļauj vismaz vienu "atgriešanās" punktu — vietu, kur divi dažādi lēmumi (bultas) aizved uz vienu un to pašu lokāciju.
Pārliecinies, ka no katra taisnstūra iziet vismaz viena bulta uz nākamo lēmumu (vai uz beigu ovālu).

3. uzdevums: Tehniskais projekts (Shēmas sasaiste ar kodu)

Sasaisti izveidoto vizuālo plānu ar reāliem Python elementiem — topošajām funkcijām un mainīgajiem.

Izpildes soļi:

Blakus katram taisnstūrim shēmā pieraksti Python funkcijas nosaukumu, izmantojot Snake Case (piemēram, def sarga_istaba():).
Identificē, vai spēlē būs nepieciešams priekšmets (piemēram, atslēga). Atzīmē shēmā, kurā telpā šis mainīgais tiks iegūts (piem., pievieno tekstu ir_atslega = True).
Atzīmē rombu (Lēmumu), kurā šī atslēga tiks pārbaudīta (piem., if ir_atslega:).
Iesūtīt uzdevuma github saiti e-klasē.

Papildus uzdevums: Nebeidzamais cikls (Loop) shēmā

Izveido plānu situācijai, kur spēlētājs var iestrēgt un mēģināt atkal, līdz atrisina mīklu.

Izpildes soļi:

Pievieno savai shēmai jaunu lokāciju "Sfinksas mīkla".
Izveido Rombu ar jautājumu.
Ja atbilde ir nepareiza, izvelc bultu atpakaļ uz pašu "Sfinksas mīkla" taisnstūri (vizuāli attēlojot while ciklu vai funkcijas atkārtotu izsaukšanu).
Ja atbilde ir pareiza, bulta ved uz nākamo istabu. Apraksti šo loģiku ar īsu pseidokodu blakus shēmai.

Biežākās kļūdas (un kā tās labot):

Aklie zari (Dead ends): Situācija, kad funkcija (istaba) beidzas, bet nepiedāvā pāreju uz citu funkciju un nav arī "Game Over". Programma vienkārši apstājas.

# Slikti: Spēlētājs izlasa tekstu un programma aizveras
def tuksa_istaba():
    print("Šeit nekā nav.")
    # Trūkst turpinājuma!

# Labi: Spēlētājs tiek nosūtīts atpakaļ
def tuksa_istaba():
    print("Šeit nekā nav. Tu atgriezies gaitenī.")
    gaitenis()

Neiespējami nosacījumi: Izveidots ceļš, kas pārbauda mainīgo (piemēram, atslēgu), kurš programmā vēl nav definēts, izraisot NameError. Mainīgie vienmēr jādefinē stāsta pašā sākumā.

# Slikti: Mainīgais tiek radīts tikai 1. istabā
def otra_istaba():
    if ir_atslega: # Ja spēlētājs šeit nonāk pirms 1. istabas, spēle sabruks!
        print("Atvērts")

# Labi: Mainīgais tiek definēts globāli pirms spēles sākuma
ir_atslega = False

Koda piemērs: No shēmas uz kodu

# 1. Taisnstūris: Sākuma lokācija
def meza_taka():
    print("Tu stāvi uz sūnainas takas.")
    
    # 2. Rombs: Izvēle
    izvele = input("Iet (A)ugšup vai (L)ejup? ").upper()
    
    # 3. Bultas: Pārejas (Plūsma uz citām funkcijām)
    if izvele == "A":
        kalna_virsotne()
    elif izvele == "L":
        upes_leja()
    else:
        print("Nesapratu.")
        meza_taka() # Atgriežas sākumā (Cikls)

Tu stāvi uz sūnainas takas.
Iet (A)ugšup vai (L)ejup? A