sicp/vaja/plan.org

* 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 [[https://dthompson.us/projects/chickadee.html][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 [[https://git.kompot.si/lio/PonsapiCli][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

[[file:./igra-stavkov-1.png]]

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~:

#+begin_src html :tangle ./igra-stavkov/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>
#+end_src

Ker artanis privzeto ne prikazuje ~index.html~ datoteke, mu to zaukažemo z vnosom v fajlu ~ENTRY~:
#+begin_src scheme
  (get "/" (lambda (rc) (redirect-to rc "index.html")))
#+end_src

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!

[[file:igra-stavkov-2.png]]

** 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):

#+begin_src conf
db.dbd = sqlite3
db.enable = true
#+end_src

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

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

Ustvarimo model zanjo;