sicp/vaja/plan.org

• Plan za vajo
• predlogi
• tekstualna igra stavkov p
  • meta
  • homepage
  • seja igre
  • program
    • boilerplate
    • navodila za igro
      • v živo
      • na naši aplikaciji
  • Nova soba

Plan za vajo

predlogi

• tekstualna igra stavkov

  • tista s sestavljanjem povedi je pa iz une igre, mi smo dostkrat igral, neki v smislu, da mora igrat 6+ ljudi in pol vsak napise na vrh lista eno stvar in pol prepogne in list krozi – po vrsti grejo neki takega: kdo, kdaj, kje, zakaj, s cim, kaj dela … pol pa ven loh pridejo kr zabavni stavki … in da je odprto na spletni strani skos naslednje vprasanje, ko se odgovori zadnja stvar (kaj dela), se izpise poved med ze dokoncane, in se zacne nova

• igra v chickadee-ju

  • klon she-bo? (https://www.myabandonware.com/game/she-bo-a6f)
• igra v canvasu (preko hoot) - v brskalniku
• Command line tool za prevode - prepis ponsapi-cli v guile

• CI (continuous integration) sistem:

  • https://codeberg.org/jjba23/byggsteg
  • tegale bi lahko uporabili ^
  • ideja: imeti spletno stran, ki jo na njej sami lahko v zivo urejas (ima vgrajen urejevalnik) in v kolikor testi passajo, se kar sproti deploya

'

tekstualna igra stavkov p

meta

Sem pišemo plan za program igranja igre. Poskušamo kratko in jedrnato opisati prvi prototip, ki naj čimprej deluje in je zavoljo enostavnosti karseda podoben igranju v živo. Ob pisanju se poraja veliko idej, za katere je bolje, da se potencialno uvedejo kasneje, sicer se cilj delujočega prototipa sproti prehitro oddaljuje.

homepage

Na home page imamo kratka navodila in formo nova igra s poljem stevilo igralcev. Submitanje forme te pelje na zgeneriran link, ki ga posljes soigralcem.

Na tem koraku se generira seja glede na število igralcev.

seja igre

Meta Podatki

• hash, ki je url
• stevilo igralcev

Vsak igralec dobi svoj id (in session). Nato se mu po vrsti prikazujejo vprasanja in on izpolnjuje vprasanja. Novo vprasanje se ti pojavi, ko vsi odgovorijo na trenutno vprasanje (lahko imamo nek semaforcek, kdo je ze odgovoril).

Igra "prepozna" obiskovalca nekako unikatno - lahko je session in cookie (kar se uporablja za user tracking), lahko pa je nek ID v browser local storage, ki zavaruje uporabnika pred cross-site trackingom. (@TODO tole je manjša komplikacija). Unikatna prepoznava je pomembna za deterministično prelivanje odgovorov.

Ko oddaš odgovore, te pelje na link za rezlultate, kjer piše, koliko odgovorov igralcov še čakamo. Ko so vsi oddali odgovore, se ti izpiše stavek, ki ga lahko prebereš ostalim igralcem.

program

Izbrali smo artanis web framework: https://artanis.dev/ Namestitev:

• GNU guix: guix install artanis
• Debian: apt install guix; guix install artanis

boilerplate

Artanis ima orodje za terminal, imenovano art. Z orodje mdr. pripravimo skelet novega projekta: art create igra-stavkov.

Strežnik potem lahko poženemo z ukazoma:

• cd igra-stavkov
• art work

Strežnik se nam odpre na naslovu http://127.0.0.1:3000

Stran tako deluje samo lokalno, če jo želimo deliti z drugimi na omrežju, spremenimo konfiguracijo; v datoteki conf/artanis.conf spremenimo host.addr = 127.0.0.1 v lasten IP naslov (v mojem primeru host.addr = 10.27.3.12) Drugi potem stran vidijo na naslovu http://<ip_naslov>:3000, v času in kraju pisanja tega dokumenta je to http://10.27.3.12:3000 (deluje pa samo CTK wifi omrežju, na katerega sem trenutno povezan).

navodila za igro

Igro lahko igrata dva ali več igralcev. Igralci skupaj sestavljajo stavke, tako da vnaprej odgovarjajo na vprašanja:

• Kdo?
• Kdaj?
• Kje?
• zakaj?
• S čim?
• Kaj dela?

v živo

Vsak igralec potrebuje listek in pisalo. Igralci skupaj odgovarjajo na vprašanja, po vsakem odgovoru pa listek prepognejo in podajo naprej. Svoj naslednji odgovor nato napišejo pod prepognjen del in spet podajo listek naprej. Ko odogovorijo na vsa vprašanja, še enkrat podajo listek naprej naslednjemu igralcu in preberejo cel stavek.

na naši aplikaciji

Na naši aplikaciji je igra zelo podobna. Izberete število igralcev in ustvarite novo sobo za igranje. Povezavo do sobo pošljete soigralcem in po vrsti odgovarjate na vprašanja, dokler ne izpolnite vseh. Vsakemu igralcu se na koncu izpiše en sestavljen stavek.

Ustvarimo nov fajl na lokaciji pub/index.html:

   <html>
      <head>
        <meta charset="UTF-8"> 
        <meta name="viewport" content="width=device-width, initial-scale=1.0">
        <title>igra stavkov</title>
      </head>
      <body>
        <h1>igra stavkov</h1>

        <h2>v živo</h2>
        <p>
    Vsak igralec potrebuje listek in pisalo. Igralci skupaj odgovarjajo na
    vprašanja, po vsakem odgovoru pa listek prepognejo in podajo naprej. Svoj
    naslednji odgovor nato napišejo pod prepognjen del in spet podajo listek naprej.
    Ko odogovorijo na vsa vprašanja, še enkrat podajo listek naprej naslednjemu
    igralcu in preberejo cel stavek.
        </p>

        <h2>prek spleta (naša varianta)</h2>
        <p>
    Vsak igralec potrebuje računalnik z brskalnikom in internetno povezavo. Dobavna veriga obsega rudnike redkih kovin, silicij, proizvodnjo čipov, komunikacijsko mrežo, etcetera.
        </p>
        
        <p>
  Na naši aplikaciji je igra zelo podobna. Izberete število igralcev in ustvarite
  novo sobo za igranje. Povezavo do sobo pošljete soigralcem in po vrsti
  odgovarjate na vprašanja, dokler ne izpolnite vseh. Vsakemu igralcu se na koncu
  izpiše en sestavljen stavek.

        <form>
          <label for="num-of-players">Izberi število igralcev</label>
          <input type="number" min="1" name="num-of-players" id="num-of-players"></input>
          <input type="submit" value="igraj">
        </form>
      </body>
    </html>

Ker artanis privzeto ne prikazuje index.html datoteke, mu to zaukažemo z vnosom v fajlu ENTRY:

  (get "/" (lambda (rc) (redirect-to rc "index.html")))

Sprememba se ne zgodi "avtomatsko", ampak moramo prekiniti proces art work (Ctrl+C), in ga ponovno pognati (art work). Lahko ga pa poženemo tudi z art work -g, načinu za razhroščevanje, ki ponovno naloži izvorno kodo, ko se le ta spremeni.

Domača stran se nam zdaj naloži!

Nova soba

Zavoljo enostavnosti v conf/artanis.conf omogočimo podporo za sqlite3 bazo (ki je v fajlu in tako nismo odvisno od dodatne programske opreme za shranjevanje stanja):

db.dbd = sqlite3
db.enable = true

In ponovno poženemo strežnik: art work -g

Soba ima dve lastnosti; unikaten ID in število igralcev.

Ustvarimo model zanjo;