don
/
neon-sprawl
mirror of https://github.com/ViPro-Technologies/neon-sprawl
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity
neon-sprawl/docs/decomposition/modules/E7_M2_RewardAndUnlockRouter.md

1.6 KiB
Raw Blame History

E7.M2 — RewardAndUnlockRouter

Summary

Field Value
Module ID E7.M2
Epic Epic 7 — Quest / Faction
Stage target Prototype
Status Planned (see dependency register)

Purpose

Route quest and encounter outputs to XP, items, unlocks, and flags with idempotent delivery (E7.M1 completion, E2.M2, E3.M3). Party: Per-character idempotent grants when party credit completes multiple characters.

Responsibilities

  • Apply QuestRewardBundle; grant UnlockGrant; emit RewardDeliveryEvent for audit.

Key contracts

Contract Role
QuestRewardBundle Composite rewards for a step or completion.
UnlockGrant Blueprints, gates, cosmetics.
RewardDeliveryEvent Idempotency key and outcome.

Module dependencies

  • E2.M2 — XpAwardAndLevelEngine.
  • E3.M3 — ItemizationAndInventorySchema.
  • E7.M1 — QuestStateMachine.

Dependents (by design)

  • E5.M3 — EncounterAndRewardTables.
  • E6.M4 — RewardParityEnforcer.

Related implementation slices

Epic 7 Slice 2 — reward_delivery, unlock_granted; no double-claim on replay.

Source anchors