TMCandClaude Opus 5.5 9c77ffd3a7
Release / build (push) Successful in 5m49s
Docker build: make the Gradle wrapper executable
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-15 23:25:46 +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.

Sobe su u memoriji servera: ponovno pokretanje servera prekida partije u tijeku.

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.

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%