docs: define initial quest board stories

2026-09-04 23:21:53 -04:00
commit 97ad506ba7
12 changed files with 314 additions and 0 deletions
@@ -0,0 +1,29 @@
+---
+type: User Story
+title: "US-005: Deliver blocks and complete a quest"
+description: Let a player deliver requested blocks at a quest board and receive the escrowed reward.
+status: backlog
+---
+
+# US-005: Deliver blocks and complete a quest
+
+As a **player**, I want to deliver requested blocks to a quest board so that I receive the promised reward and the issuer can claim my delivery.
+
+## Acceptance criteria
+
+- [ ] An active quest offers a Complete Quest action through every registered board.
+- [ ] Completion requires the delivering player to possess the full requested quantity of the exact block material.
+- [ ] Successful completion removes the requested blocks from the delivering player's inventory and stores them as a claim for the issuer.
+- [ ] Successful completion gives the exact escrowed reward items to the delivering player.
+- [ ] Reward items that do not fit are dropped safely at the delivering player's feet with a clear message.
+- [ ] The issuer is notified immediately when online or on their next login when offline that delivered blocks can be claimed at a quest board.
+- [ ] When player commands are enabled, `/quests complete <quest>` provides equivalent behavior with contextual autocomplete.
+- [ ] Completion is atomic and exactly one player can complete a quest, including simultaneous attempts.
+- [ ] Validation or persistence failure does not consume delivered blocks, release rewards, or change quest state.
+- [ ] Completed quests are no longer shown as active or completable.
+- [ ] Automated tests verify inventory validation, settlement, overflow, notifications, rollback, and concurrent completion protection.
+
+## Related
+
+- [US-003: Create a block-delivery quest](us-003-create-a-block-delivery-quest.md)
+- [US-007: Expire quests and claim held items](us-007-expire-quests-and-claim-held-items.md)