apksel-dev/apskel-pos-backend
4
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

feat(enakgame): spin as an EnakGame game; remove the old game flow

Browse Source 
EnakGame phase 10 of docs/tasks-enakgame.md (EG-1001 to EG-1003).

Spin (EG-1001)
- PROBABILITY entries take an optional label (a wheel segment). The customer game
  list shows a PROBABILITY game's prizes (entry, label, amount, never weights), and
  completing returns the drawn prize, so the client can draw the wheel and stop it
  on the server's draw.
- docs/enakgame-spin.md: the admin steps to set up spin per organization (no
  seeder) and the customer app flow. An HTTP test plays it end to end.

Old game flow removed (EG-1002)
- Routes POST /customer/spin, GET /customer/games, GET /customer/ferris-wheel, and
  admin /marketing/games, /marketing/game-prizes, /marketing/rewards, with their
  handlers, services, processors, repositories, validators, models, contracts,
  mappers and tests (GamePlayProcessor, SpinGameService, rewards, ...). This also
  closes RFC §15 findings 1 and 2 (double charge, spinning another org's game).
- Tables games, game_prizes, game_plays and rewards stay for ledger history.
  entities.StringSlice moves to its own file; the omset tracker (unrouted) keeps
  game_id but no longer embeds the old game response.

games.is_active dropped (EG-1003)
- Migration 000115; nothing reads metadata.coin_cost any more.

The EnakPoint integration docs now point at /customer/enakgame. The Postgres tests
were not run: no test database here. Migration 000115 has not been run anywhere.
The customer app must stop calling the removed endpoints before this is deployed.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
efrilm
2026-10-07 21:31:56 +07:00
co-authored by Claude Opus 5.5
parent 296708244e
commit 18e87398bb
68 changed files with 467 additions and 5064 deletions
Download Patch File Download Diff File Expand all files Collapse all files
internal/validator/gamification_validator.go
-215
View File
@@ -14,21 +14,6 @@ type GamificationValidator interface {
ValidateUpdateTierRequest(req *contract.UpdateTierRequest) (error, string)
ValidateListTiersRequest(req *contract.ListTiersRequest) (error, string)
// Games
ValidateCreateGameRequest(req *contract.CreateGameRequest) (error, string)
ValidateUpdateGameRequest(req *contract.UpdateGameRequest) (error, string)
ValidateListGamesRequest(req *contract.ListGamesRequest) (error, string)
// Game Prizes
ValidateCreateGamePrizeRequest(req *contract.CreateGamePrizeRequest) (error, string)
ValidateUpdateGamePrizeRequest(req *contract.UpdateGamePrizeRequest) (error, string)
ValidateListGamePrizesRequest(req *contract.ListGamePrizesRequest) (error, string)
// Game Plays
ValidateCreateGamePlayRequest(req *contract.CreateGamePlayRequest) (error, string)
ValidateListGamePlaysRequest(req *contract.ListGamePlaysRequest) (error, string)
ValidatePlayGameRequest(req *contract.PlayGameRequest) (error, string)
// Omset Tracker
ValidateCreateOmsetTrackerRequest(req *contract.CreateOmsetTrackerRequest) (error, string)
ValidateUpdateOmsetTrackerRequest(req *contract.UpdateOmsetTrackerRequest) (error, string)
@@ -109,206 +94,6 @@ func (v *GamificationValidatorImpl) ValidateListTiersRequest(req *contract.ListT
return nil, ""
}
// Game Validators
func (v *GamificationValidatorImpl) ValidateCreateGameRequest(req *contract.CreateGameRequest) (error, string) {
if err := v.validate.Struct(req); err != nil {
return err, "VALIDATION_ERROR"
}
if req.Name != "" {
req.Name = strings.TrimSpace(req.Name)
if req.Name == "" {
return errors.New("name cannot be empty or whitespace only"), "INVALID_NAME"
}
if len(req.Name) > 255 {
return errors.New("name cannot exceed 255 characters"), "INVALID_NAME"
}
}
validGameTypes := []string{"SPIN", "RAFFLE", "MINIGAME"}
if !contains(validGameTypes, req.Type) {
return errors.New("invalid game type"), "INVALID_GAME_TYPE"
}
return nil, ""
}
func (v *GamificationValidatorImpl) ValidateUpdateGameRequest(req *contract.UpdateGameRequest) (error, string) {
if err := v.validate.Struct(req); err != nil {
return err, "VALIDATION_ERROR"
}
if req.Name != nil && *req.Name != "" {
*req.Name = strings.TrimSpace(*req.Name)
if *req.Name == "" {
return errors.New("name cannot be empty or whitespace only"), "INVALID_NAME"
}
if len(*req.Name) > 255 {
return errors.New("name cannot exceed 255 characters"), "INVALID_NAME"
}
}
if req.Type != nil {
validGameTypes := []string{"SPIN", "RAFFLE", "MINIGAME"}
if !contains(validGameTypes, *req.Type) {
return errors.New("invalid game type"), "INVALID_GAME_TYPE"
}
}
return nil, ""
}
func (v *GamificationValidatorImpl) ValidateListGamesRequest(req *contract.ListGamesRequest) (error, string) {
if err := v.validate.Struct(req); err != nil {
return err, "VALIDATION_ERROR"
}
if req.Page <= 0 {
req.Page = 1
}
if req.Limit <= 0 {
req.Limit = 10
}
if req.Limit > 100 {
req.Limit = 100
}
if req.Type != "" {
validGameTypes := []string{"SPIN", "RAFFLE", "MINIGAME"}
if !contains(validGameTypes, req.Type) {
return errors.New("invalid game type"), "INVALID_GAME_TYPE"
}
}
return nil, ""
}
// Game Prize Validators
func (v *GamificationValidatorImpl) ValidateCreateGamePrizeRequest(req *contract.CreateGamePrizeRequest) (error, string) {
if err := v.validate.Struct(req); err != nil {
return err, "VALIDATION_ERROR"
}
if req.Name != "" {
req.Name = strings.TrimSpace(req.Name)
if req.Name == "" {
return errors.New("name cannot be empty or whitespace only"), "INVALID_NAME"
}
if len(req.Name) > 255 {
return errors.New("name cannot exceed 255 characters"), "INVALID_NAME"
}
}
if req.Weight <= 0 {
return errors.New("weight must be greater than 0"), "INVALID_WEIGHT"
}
if req.Stock < 0 {
return errors.New("stock cannot be negative"), "INVALID_STOCK"
}
if req.MaxStock != nil && *req.MaxStock <= 0 {
return errors.New("max stock must be greater than 0"), "INVALID_MAX_STOCK"
}
if req.Threshold != nil && *req.Threshold < 0 {
return errors.New("threshold cannot be negative"), "INVALID_THRESHOLD"
}
return nil, ""
}
func (v *GamificationValidatorImpl) ValidateUpdateGamePrizeRequest(req *contract.UpdateGamePrizeRequest) (error, string) {
if err := v.validate.Struct(req); err != nil {
return err, "VALIDATION_ERROR"
}
if req.Name != nil && *req.Name != "" {
*req.Name = strings.TrimSpace(*req.Name)
if *req.Name == "" {
return errors.New("name cannot be empty or whitespace only"), "INVALID_NAME"
}
if len(*req.Name) > 255 {
return errors.New("name cannot exceed 255 characters"), "INVALID_NAME"
}
}
if req.Weight != nil && *req.Weight <= 0 {
return errors.New("weight must be greater than 0"), "INVALID_WEIGHT"
}
if req.Stock != nil && *req.Stock < 0 {
return errors.New("stock cannot be negative"), "INVALID_STOCK"
}
if req.MaxStock != nil && *req.MaxStock <= 0 {
return errors.New("max stock must be greater than 0"), "INVALID_MAX_STOCK"
}
if req.Threshold != nil && *req.Threshold < 0 {
return errors.New("threshold cannot be negative"), "INVALID_THRESHOLD"
}
return nil, ""
}
func (v *GamificationValidatorImpl) ValidateListGamePrizesRequest(req *contract.ListGamePrizesRequest) (error, string) {
if err := v.validate.Struct(req); err != nil {
return err, "VALIDATION_ERROR"
}
if req.Page <= 0 {
req.Page = 1
}
if req.Limit <= 0 {
req.Limit = 10
}
if req.Limit > 100 {
req.Limit = 100
}
return nil, ""
}
// Game Play Validators
func (v *GamificationValidatorImpl) ValidateCreateGamePlayRequest(req *contract.CreateGamePlayRequest) (error, string) {
if err := v.validate.Struct(req); err != nil {
return err, "VALIDATION_ERROR"
}
if req.CoinsUsed < 0 {
return errors.New("coins used cannot be negative"), "INVALID_COINS_USED"
}
return nil, ""
}
func (v *GamificationValidatorImpl) ValidateListGamePlaysRequest(req *contract.ListGamePlaysRequest) (error, string) {
if err := v.validate.Struct(req); err != nil {
return err, "VALIDATION_ERROR"
}
if req.Page <= 0 {
req.Page = 1
}
if req.Limit <= 0 {
req.Limit = 10
}
if req.Limit > 100 {
req.Limit = 100
}
return nil, ""
}
func (v *GamificationValidatorImpl) ValidatePlayGameRequest(req *contract.PlayGameRequest) (error, string) {
if err := v.validate.Struct(req); err != nil {
return err, "VALIDATION_ERROR"
}
return nil, ""
}
// Omset Tracker Validators
func (v *GamificationValidatorImpl) ValidateCreateOmsetTrackerRequest(req *contract.CreateOmsetTrackerRequest) (error, string) {
if err := v.validate.Struct(req); err != nil {