GuessAgainBro – tai žodžių spėjimo žaidimas, realizuotas naudojant C++ kalbą. Projektas imituoja originalų Wordle žaidimą, leidžiant vartotojams per naršyklę spėti 5 raidžių žodžius, kol jie atspėja teisingą per ribotą bandymų skaičių.
| Komponentas | Atsakomybė |
|---|---|
| Frontend UI | Vartotojo sąsaja, formų pateikimas, žodžio įvedimas, rezultatų vizualizacija |
| Controlleriai | Registruoja maršrutus (GET /, POST /game/word), apdoroja JSON |
| Žaidimo logika | Tikrina raidžių atitikimą, kuria atsakymą, įvertina spėjimą |
| Duombazė | Saugo šiandienos žodį, gali tikrinti ar žodis legalus |
sequenceDiagram
participant User
participant UI
participant Server
participant GameController
User->>UI: Input word
UI->>Server: POST /game/word
Server->>GameController: Checks word
GameController-->>Server: JSON return (letter status)
Server-->>UI: JSON return
UI-->>User: Shows colour-indicated result
-
Įvedimas: vartotojas suveda žodį (per formą ar mygtukus)
-
Išvedimas: žodis parodomas su spalvotais indikatoriais (žalia, geltona, pilka)
-
Atsakymai į POST siunčiami JSON formatu, pvz.:
{
"1": 1,
"2": 2,
"3": 0,
"4": 1,
"5": 0
}Kur 1 reiškia teisingą vietą, 2 – klaidingą vietą, 0 – raidė neegzistuoja.
-
Žodžių duomenų bazė
Atsakinga už visų galimų žodžių saugojimą bei validavimą. Žodžiai įkeliami iš failo. -
Dienos žodis (TodaysWord)
Sistemoje yra pasirinktas vienas žodis, kuris laikomas atmintyje ir naudojamas viso žaidimo metu.
| Komponentas | Technologija |
|---|---|
| Serveris | C++ su cpp-httplib |
| JSON | nlohmann/json |
| UI | React.js |
| Komunikacija | HTTP POST JSON |
Pagrindinės vartotojo funkcijos:
- Pradėti žaidimą
- Įvesti spėjimą
- Peržiūrėti rezultatą
Pradėjus žaidimą, vartotojas įveda 5 raidžių žodį. Šis žodis yra perduodamas serveriui ir tikrinama - ar tai validus žodis, ar tai "šiandienos žodis" ir ar tai buvo šeštas įvedimo bandymas. Jeigu žodis yra "šiandienos žodis", vartotojas laimėjo. Jeigu žodis yra netinkamas, arba tai nėra "šiandienos žodis", vartotojas gauna atsakymą, kur kiekvieną raidė yra nuspalvinta žaliai, geltonai arba pilkai. Jeigu vartotojas nesugebėjo atspėti žodžio po šešių bandymų, žaidimas yra pralaimėtas.
Norint paleisti projektą, pagrindiniame kataloge atidarykite GuessAgainBro.sln failą ir paleiskite projektą, kad būtų sukompiliuotas serveris.
Tuomet eikite į katalogą front/word-guesser-app ir paleiskite frontendą su komanda npm start.
Rest API darymas su c++ nebuvo toks didelis baubas kaip atrodė iš pat pradžių, visai simple. Galėjom pamėgint frontendą su c++, bet įsivaizduoju kad žiauriai sudėtinga tūrėtų būt, dėl laiko stokos vengėm.
Manau, buvo naudinga patiems sugalvoti projekto viziją, ją analizuoti ir galiausiai parengti diagramas. Tokiu būdu pavyko giliau suprasti dėstomą medžiagą – kuriant diagramas atsiskleidė įvairios kūrimo subtilybės, kurias po paskaitos lengva pamiršti. Taip pat buvo įdomu išbandyti backend programavimą su C++ – anksčiau esu dirbęs su Java ir C#, tačiau sunkiai įsivaizdavau, kaip tai gali atrodyti C++ kalboje.