Decisions & TODOs
Applied Decisions
These items from the original draft have been integrated into the documentation:
| Decision | Applied In |
|---|---|
| Like/dislike feature is included from day one | Frontend (player footer), Data Model (events + rating metric) |
| Developer portal will also use iframes (consistent architecture) | Game Sourcing, Architecture |
| Documentation is written in English | All files |
| 10% exploration slots are available on Home, category, and game detail page recommendations, but not on author pages | Exploration & Ranking |
| On mobile, games launch in fullscreen with an explicit Play button (no auto-play) | Frontend (responsive behavior) |
| On desktop, games auto-play when visiting the game page | Frontend (responsive behavior) |
| Tag badges (New, Trendy) appear as small icons in the top-left corner of game cards | Frontend (game card component), Data Model (tags) |
| One backend service per domain from the start | Architecture |
| Only one build per game in MVP, but build structure supports multiple | Game Sourcing |
Open Questions
Items that need further discussion or are deferred:
| Item | Status | Notes |
|---|---|---|
| GDPR compliance | Deferred | Not addressed in MVP. Needs review before launch (cookie consent, data retention, right to deletion) |
| Ranking algorithm weights | To define | Which metrics feed into ranking and with what weights? Needs data to calibrate |
| Pagination vs infinite scroll | To decide | Both mentioned as options. Need to pick one and define UX behavior |
| Crash Rate detection | Deferred | Depends on whether GameDistribution fires gameplay_stop on page exit. Needs testing |
| Mean FPS measurement | Deferred | Feasibility depends on canvas/WebGL access within iframes. May not be possible with broker games |
| Updated tag | Deferred | Planned but not enabled in MVP. Needs definition of “update” for broker-sourced games |
| Login / accounts system | Deferred | Placeholder in header. No spec yet |
| Ad integration details | To define | show_ad event exists but ad provider, placement strategy, and revenue model are not specified |
| Search implementation | Partially resolved | MVP: PostgreSQL ILIKE + tsvector. Growth: Meilisearch. See Architecture → Tech Stack and Scaling → Search. Still open: autocomplete UX details, fuzzy matching threshold |
| Language / i18n | To define | Language selector in footer but no specification of supported languages or translation workflow |
| Ranked game demotion | To decide | Can a Ranked game be demoted back to Exploration if metrics drop? Options: no demotion (poor games sink in rankings), auto-demotion below threshold, manual admin-only demotion. See Exploration & Ranking → Demotion |
| Author URL format | Resolved | Author pages use slug-based URLs (/authors/:slug). See API Reference |