Create the Game Session Backend Module

[A6dulmalik]

Create the Game Session Backend Module

Priority

P0 — Critical

Labels

backend game-engine feature priority: p0 help wanted

Description

Game sessions are a core part of Mind Block's gameplay experience.

A dedicated backend abstraction is required to represent an active gameplay session instead of relying on individual puzzle/progress records.

Objective

Create a dedicated NestJS game-sessions module.

Suggested Structure

backend/src/game-sessions/

├── game-sessions.module.ts
├── game-sessions.controller.ts
├── game-sessions.service.ts
├── entities/
├── dto/
├── interfaces/
└── tests/

Session States

The session should support:

- CREATED
- ACTIVE
- PAUSED
- COMPLETED
- EXPIRED
- ABANDONED

Suggested Fields

id
userId
guestId
status
difficulty
selectedCategories
challengeCount
currentChallenge
score
xpEarned
startedAt
completedAt

Requirements

Implement:

Session creation
Session retrieval
Session ownership
Session status management
Session state transitions
Session completion
Session expiration
Validation of invalid state transitions

Acceptance Criteria

• game-sessions module exists.
• Session creation endpoint exists.
• Active session can be retrieved.
• Session status transitions are validated.
• Session ownership is enforced.
• Invalid transitions return appropriate errors.
• Unit tests are included.

[Maryermarh]

I’d like to take this on by building the dedicated game-sessions module as the backend foundation for managing active gameplay sessions.

I’ll implement session creation and retrieval, ownership checks, lifecycle state transitions, completion/expiration handling, and validation for invalid transitions. I’ll also add focused unit tests covering the session lifecycle, authorization, and transition rules.

[limxiy]

I’ll build the dedicated game-sessions module as the backend foundation for managing active gameplay sessions.

I’ll implement session creation and retrieval, ownership checks, lifecycle state transitions, completion/expiration handling, and validation for invalid transitions. I’ll also add focused unit tests covering the session lifecycle, authorization, and transition rules.

Please assign me

[grantfox-oss]

🦊 GrantFox — @limxiy has been assigned to this issue as part of the Third Campaign campaign!

Next steps:

1. Open a Pull Request referencing this issue (e.g., Closes #611)
2. Your PR will be reviewed by the MindBlockLabs maintainers

Good luck! Track your progress on GrantFox.

[grantfox-oss]

🎉 This issue has been marked as completed on GrantFox as part of the Third Campaign campaign!

@limxiy's PR #630 was approved and merged by @phertyameen.

🏆 @limxiy: You earned 35 FoxPoints for this contribution! Your current tier: Explorer (920 total points). Track your full progress on GrantFox.

👏 Great work, @limxiy! Keep contributing to MindBlockLabs.