TMCandClaude Opus 5.5 6ecb844ae2
Release / build (push) Successful in 4m45s
Server: keep open rooms across restarts
A redeploy no longer ends the games in progress. The server writes the open
rooms (players, tokens, host, and each game as its seed and moves) to
$DATA_DIR/rooms.json every few seconds when something changed and once more
on shutdown (SIGTERM via Ktor's shutdown hook), and loads them before it
accepts connections. Clients reconnect with their saved token and get the
same table back; bots wait 30 s for them after a restart. Saves older than
10 minutes are ignored, and a game the new rules cannot replay leaves the
room in the lobby.

The image sets DATA_DIR=/data (owned by the bela user) and the compose file
mounts the bela-data named volume on it.

Also fixes a flaky test: the guest ignored its first table, so the game
waited forever whenever the random dealer made the guest call first.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-16 08:32:26 +01:00

Bela

Hrvatska Bela do 1001 za Android i web. Igra se lokalno (ti i partner protiv računala) ili online s prijateljima: netko otvori sobu, ostali uđu s kodom sobe, a prazna mjesta igra računalo. Web (https://bela.mariosem.es) je ujedno i server na koji se spajaju i Android aplikacija i preglednik.

Struktura

Modul Što je u njemu
engine/ Kotlin Multiplatform (JVM i Wasm): karte, pravila, zvanja, bodovanje, bot, pogled igrača na stol (TableView) i protokol za online igru (hr.bela.protocol). Isti kod vrti server, Android i preglednik.
shared/ Cijelo sučelje (Compose Multiplatform) za Android i web: ekrani, stol, dijalozi, trening, online predvorje i soba, view modeli.
app/ Android aplikacija: MainActivity, slike karata (2x), spremanje postavki, ažuriranje APK-a.
web/ Web aplikacija (Kotlin/Wasm): ulazna točka, index.html, slike karata (1x).
server/ Server (Ktor): sobe i online partije preko WebSocketa /ws, poslužuje i web aplikaciju.

Važne datoteke:

  • engine/.../Game.kt: tijek partije (dijeljenje, zvanje aduta, štihovi, obračun).
  • engine/.../Trick.kt: dozvoljeni potezi (praćenje boje, iber, sječenje).
  • engine/.../Declarations.kt: zvanja.
  • engine/.../RuleSet.kt: kućna pravila (do koliko se igra, štiglja, iber, belot, "visi").
  • engine/.../Bot.kt: heuristički bot.
  • shared/.../ui/CardArt.kt: sve što crta kartu, vidi niže.
  • shared/.../online/OnlineViewModel.kt: veza sa serverom, ponovno spajanje, animacija poteza.
  • server/.../Room.kt: jedna soba (igrači, botovi, tempo partije).

Build i pokretanje

gradlew :engine:jvmTest :server:test         # testovi pravila, simulacija 1000 partija, server (cijela online partija)
gradlew :app:assembleDebug                   # APK u app/build/outputs/apk/debug/
gradlew :app:installDebug                    # instalacija na spojeni uređaj ili emulator
gradlew :web:wasmJsBrowserDistribution       # web u web/build/dist/wasmJs/productionExecutable/
gradlew :server:run                          # server na http://localhost:8080 (s gornjim webom)

Android aplikacija se spaja na wss://bela.mariosem.es/ws. Za lokalni server s emulatora: gradlew :app:installDebug -PbelaServer=ws://10.0.2.2:8080/ws.

Bez Android SDK-a (npr. u Dockeru) build se pokreće s -PbelaNoAndroid=true: tada se grade samo engine, shared (web), web i server. Kotlin/Wasm sam preuzima Node.js; na računalu gdje sigurnosni softver blokira novo preuzeti node.exe, u ~/.gradle/gradle.properties stoji belaDownloadNode=false, pa se koristi Node koji je već u ~/.gradle/nodejs.

Projekt koristi AGP 9.4.1, Kotlin 2.4.21, Gradle 9.8.2 i compileSdk 36, iste verzije kao AndroidTV projekt.

Karte

Android koristi slike lica karata iz app/src/main/res/drawable-nodpi/ (card_<boja>_<vrijednost>.webp, 726 px), web iz web/src/wasmJsMain/composeResources/files/cards/ (363 px, preglednik ih sve preuzme na početku), a znakovi boja (suit_<boja>.webp) i logo su zajednički u shared/src/commonMain/composeResources/drawable/. Postoje dva izvora, a skripta odabranog izvora prepisuje te slike:

Izvor Naredba Napomena
PNG špil (trenutno u upotrebi): tomasdrus/hungarian-playing-cards, kopiran u card_assets/hungarian-playing-cards/ python tools/import_png_cards.py 363×585 px, WebP bez gubitaka. Repozitorij nema licencu, vidi NOTICE.md u toj mapi. Prije objave aplikacije treba dopuštenje autora.
Naši SVG-ovi u card_assets/*.svg python tools/render_cards.py Treba Inkscape 1.x. Renderira 720 px.

Poleđina je naša i crta se vektorski u kodu (CardBack).

Pravilo oštrine: karta se nikad ne crta šire od svoje slike. Svaka veličina karte ograničava se s maxCardWidth(). Slike se pripremaju u rezoluciji u kojoj se crtaju: Android ih dekodira smanjene, s mipmapama (app/.../platform/AndroidPlatform.kt), a web i znakovi boja smanjuju se prepolavljanjem (reduceImage). U debug buildu na Androidu svako povećanje slike zapisuje se u logcat pod oznakom BelaCards, pa se provjerava s adb logcat -s BelaCards.

Sve što crta kartu nalazi se u shared/src/commonMain/kotlin/hr/bela/shared/ui/CardArt.kt (CardFace, CardBack, SuitIcon, maxCardWidth).

U kodu se boje zovu HERC, KARO, PIK i TREF (= srce, zvono, list, žir), a vrijednosti SEDAM … AS.

Trening brojanja

S početnog ekrana ("Trening brojanja"). Svaka runda je hrpa osvojenih štihova (po 4 karte) s izmišljenim adutom i ponekad zadnjim štihom (+10). Karte se pokazuju jedna po jedna, a zatim igrač bira jedan od četiri zbroja. Netočni odgovori nastaju iz tipičnih grešaka (dečko ili devetka u adutu, zaboravljen zadnji štih, propuštena desetka ili as…). Nakon odgovora vidi se svaka karta s bodovima i objašnjenje greške.

  • Logika runde: engine/.../CountingDrill.kt (s testovima).
  • Razine (Lako 8 karata, Srednje 12–16, Teško 20–28) i stanje: shared/.../TrainingViewModel.kt.
  • Ekran: shared/.../ui/TrainingScreen.kt.

Izgled

  • Fontovi: Cinzel (naslovi, rezultat, oznake) i Inter (tekst), u shared/src/commonMain/composeResources/font/. Oba su pod licencom SIL Open Font License, tekst licence je u licenses/.
  • Boje, prijelazi i filc stola su u ui/Theme.kt, zajednički gumbi i ukrasi u ui/Components.kt.

Online igra

  1. Igrač upiše ime i otvori sobu (dobije kod od 4 znaka, npr. T2UT) ili uđe u postojeću s kodom. Poveznica https://bela.mariosem.es/?soba=KOD otvara web s već upisanim kodom.
  2. U čekaonici se vidi raspored za stolom; prije početka svatko može sjesti na prazno mjesto. Domaćin pokreće igru, a prazna mjesta igra računalo (u Androidu i webu prikazano robotom).
  3. Server vodi cijelu partiju (engine) i svakom igraču šalje samo njegov pogled: svoje karte, za ostale samo broj karata. Tempo je isti kao lokalno (Pacing).
  4. Kad veza pukne, igrač se vraća na svoje mjesto (kod sobe i token se pamte, pa radi i nakon zatvaranja aplikacije ili osvježavanja stranice). Ako ne stigne za 10 s, za njega igra računalo dok se ne vrati; nakon 10 minuta gubi mjesto. Sljedeća ruka kreće kad su svi spojeni igrači spremni.

Ponovno pokretanje servera (nova verzija, restart računala) ne prekida partije. Server zapisuje otvorene sobe u $DATA_DIR/rooms.json: svakih nekoliko sekundi kad se nešto promijeni i još jednom kad se gasi (docker stop šalje SIGTERM). Pri pokretanju ih učita prije nego što primi prvu vezu. Klijenti se sami ponovno spoje i nastave s istim kartama i rezultatom; računalo ih čeka 30 s prije nego što odigra umjesto njih. Spremljene sobe starije od 10 minuta se ne učitavaju. Ako DATA_DIR nije postavljen (npr. gradlew :server:run), sobe žive samo u memoriji.

  • Spremanje i učitavanje: server/.../RoomStore.kt (datoteka), Rooms.kt (kada), Room.kt (snapshot, restore). Partija se sprema kao sjeme i popis poteza (GameRecord, isti zapis kao spremljena lokalna igra) i ponovno odigra pri učitavanju.
  • Ako se pravila u novoj verziji promijene tako da se stara partija ne može ponovno odigrati, soba ostaje, ali bez partije: igrači se vrate u čekaonicu i domaćin pokrene novu.

Server, Docker i Gitea Actions

Jedna Docker slika (Dockerfile) gradi web i server (uz testove) i pokreće server koji poslužuje web na /, igru na /ws i /health. Gitea Actions (.gitea/workflows/release.yml, isto kao Keep) na svaki push na main gradi sliku, skenira je Trivyjem i objavljuje kao git.mariosem.es/msemes/bela:<sha> i :latest. Za objavu repozitorij treba tajnu REGISTRY_TOKEN (osobni token s write:package).

Postavljanje: docker compose pull && docker compose up -d s docker-compose.yml iz repozitorija. TLS i domenu bela.mariosem.es rješava vanjski ingress, koji mora propuštati WebSocket na /ws. Sobe se čuvaju na imenovanom volumenu bela-data (/data u kontejneru, vlasnik je korisnik bela, uid 10001). Ako umjesto njega montiraš mapu s hosta, ta mapa mora biti zapisiva za uid 10001; inače server javi upozorenje u logu i radi dalje, samo bez spremanja.

Izdanja i ažuriranje

Objava nove verzije (nakon commita i pusha):

powershell -File tools\build-release.ps1 -Notes "Što je novo"
powershell -File tools\build-release.ps1 -BuildOnly     # samo potpisani APK, bez objave

Skripta pri prvom pokretanju stvara ključ za potpisivanje: bela-release.jks i keystore.properties u korijenu projekta. Git ih ignorira. Spremi ih na sigurno. Bez tog ključa instalirane aplikacije se više ne mogu ažurirati. Prijava na server ide preko BELA_GITEA_TOKEN, datoteke .gitea-token ili vjerodajnica koje git već ima.

U aplikaciji: Postavke → Ažuriranje provjerava najnovije izdanje, preuzima APK, provjerava SHA-256 i otvara sistemsku instalaciju (app/.../update/Updates.kt).

Ikona

icon.png u korijenu je ikona i logo. python tools/make_icon.py iz nje radi adaptivnu Android ikonu (sadržaj stane u krug, okolo je filc u boji ruba) i logo za početni ekran i Postavke. Ikone weba (favicon.png, icon-192.png…) su u web/src/wasmJsMain/resources/.

QR kod u Postavkama je unaprijed izračunat (shared/.../ui/QrMatrix.kt, web nema QR koder); gradlew :app:testDebugUnitTest ga provjerava ZXingom i ispisuje nove retke ako se poveznica promijeni.

Spremanje partije

Partija se sprema nakon svakog poteza kao seed i popis poteza (GameRecord), pa se nakon zatvaranja aplikacije vraća točno gdje je stala.

S
Description
No description provided
Readme
52 MiB
0 Stars 1 Watchers 0 Forks
Languages
Kotlin 91.5%
Python 5.4%
PowerShell 1.7%
Dockerfile 0.7%
HTML 0.6%
Other 0.1%