Issue: Erottele “Opetusdemo” ja “Avoin pelidemo” serverillä (tilit + ympäristö + resetointi) / Task update: Separate Teaching Demo and Open Demo on the server

[psykkis]

Tausta

Pelissä on kaksi demomoodia:

Pelitaiteen opetusdemo (käytetään opetustilanteissa)

Pelaajien tilit / data poistetaan opetusjakson päätyttyä

Kaikille avoin pelidemo (open demo for all)

Pysyvämpi testausympäristö kaikille testaajille

Kuvassa UI:ssa nämä kuvataan erillisinä “pelimuotoina”.

Tavoite

Serverin tulee tukea kahta erillistä “environmentia” niin, että:

Opetusdemo ei sekoitu avoimeen demoon (data, leaderboardit, klaanit, matchit)

Opetusdemo voidaan resetata (tai poistaa käyttäjät) hallitusti opetuksen jälkeen

Avoin demo säilyttää datansa normaalisti (tai eri omalla reset-aikataululla)

Vaatimukset (server)

1. Environment / Mode -tunniste

Lisätään selkeä ympäristö-/mooditunniste (esim. enum):

TEACHING_DEMO

OPEN_DEMO

Tämän tulee kulkea läpi kaikissa oleellisissa entiteeteissä tai ainakin niiden “namespace”-tasolla:

user/account

clan

match/battle results

leaderboard entries

inventory/assets

soulhome / jukebox / fleamarket

Hyvä periaate: mikään haku ei saa vahingossa palauttaa toisen ympäristön dataa.

2. Tilien elinkaari (TTL / deletion policy)

Teaching demo:

Tilit ja niihin liittyvä data ovat tilapäisiä

Kun opetusjakso päättyy → tilit poistetaan tai nollataan (valitkaa malli)

Ehdotus toteutusvaihtoehdoiksi:

A) expiresAt-kenttä userille + taustaprosessi joka poistaa/nollaa

B) “session/batch id” (esim. teachingBatchId), jonka perusteella admin voi tehdä resetin

C) manuaalinen admin-endpoint: “delete all teaching demo accounts created after X”

Open demo:

Tilit säilyvät normaalisti (ei automaattipoistoa oletuksena)

3. Resetointikyvykkyys (Teaching demo)

Tarvitaan serverille hallittu tapa siivota opetusdemon data, vähintään:

käyttäjätilit (TEACHING_DEMO)

klaanit ja klaanidata (TEACHING_DEMO)

leaderboardit (TEACHING_DEMO)

matchit ja tulokset (TEACHING_DEMO)

Mahdolliset endpointit:

POST /admin/demo/teaching/reset

poistaa/nollaa kaiken TEACHING_DEMO -datan

tai turvallisemmin:

POST /admin/demo/teaching/reset?batchId=...

(Autentikointi: admin token / internal-only.)

4. Leaderboard-erottelu

Leaderboardin on oltava ympäristökohtainen:

leaderboard (TEACHING_DEMO) ≠ leaderboard (OPEN_DEMO)

Sama koskee klaanien leaderboardia / tilastoja:

klaanin voitot/tappiot ja rankingit eivät saa sekoittua ympäristöjen välillä.

Definition of Done / Acceptance Criteria

Client voi kirjautua / luoda tilin valitun moodin alle, ja serveri merkitsee tilin environmentilla.

Kaikki serverin haut (clan, leaderboard, match history, inventory) palauttavat vain saman environmentin dataa.

Teaching demo voidaan resetata: resetin jälkeen opetusdemon tilit ja niihin liittyvä data eivät ole enää saatavilla.

Open demo -data säilyy resetistä muuttumattomana.

“Cross-environment” viittauksia ei synny (esim. OPEN_DEMO -klaani ei voi sisältää TEACHING_DEMO -jäsentä).

Huomio (implementaatiovinkki)

Helpoin tapa estää vahinkosekoitukset on tehdä environment pakolliseksi:

joko kaikissa primääriavaimellisissa tauluissa (environment-sarake + indeksit)

tai erillisissä skeemoissa / tietokannoissa (isompi muutos, mutta “idiot-proof”)

[psykkis]

Task update: Separate Teaching Demo and Open Demo on the server

Based on the current UI, the game has two distinct demo modes that must be handled separately on the server side:

Game Art Teaching Demo

Used in educational contexts

Player accounts and related data are temporary and must be deleted or reset after the teaching session ends

Open Game Demo for All

Open testing environment for all testers

Accounts and data are persistent (normal demo behavior)

Requirements (server-side)

1. Environment / Mode separation

Introduce a clear environment (or mode) identifier, e.g.:

TEACHING_DEMO

OPEN_DEMO

This environment flag must be respected across all relevant data:

users / accounts

clans

matches / battle results

leaderboards (including clan leaderboards)

inventory / assets

soulhome, jukebox, flea market, etc.

Important: No query should ever mix data between environments.

2. Account lifecycle handling

Teaching Demo

Accounts are temporary

At the end of a teaching session, accounts and their data must be removed or reset

Possible implementation options:

expiresAt field on user accounts + background cleanup job

teachingBatchId (or similar) to group accounts created for the same teaching session

Admin-only endpoint to delete/reset all TEACHING_DEMO data created after a given time or batch

Open Demo

Accounts persist normally

No automatic deletion by default

3. Reset capability for Teaching Demo

The server must support a controlled reset of Teaching Demo data, including:

user accounts

clans and clan-related data

leaderboards

matches and match results

Example (internal/admin-only) endpoint:

POST /admin/demo/teaching/reset

or a safer variant:

POST /admin/demo/teaching/reset?batchId=...

4. Leaderboard separation

Leaderboards must be environment-specific:

TEACHING_DEMO leaderboard ≠ OPEN_DEMO leaderboard

The same applies to clan leaderboards and clan statistics.

Acceptance Criteria

Accounts are always created under a specific environment (Teaching Demo or Open Demo).

All data queries are scoped to the current environment.

Teaching Demo data can be fully reset without affecting Open Demo data.

Open Demo data remains intact after any Teaching Demo reset.

No cross-environment references exist (e.g. an Open Demo clan cannot contain a Teaching Demo user).

Implementation note

To avoid accidental data leakage between environments, the safest options are:

an explicit environment field on all core entities (with proper indexing), or

fully separate schemas/databases per environment (heavier change, but very robust).