Add AGR market trade flow roadmap

2026-05-22 05:02:12 +00:00
parent 507f7ad2f1
commit 6d7cc534c4
2 changed files with 41 additions and 0 deletions
@@ -1095,6 +1095,12 @@ Required order:
 - [ ] Add barter container.
 - [ ] Add simple trade UI.
 - [ ] Add local market listing model for player-produced crops, meat, wood,
  stone, fiber, tools, animals, fuel, and other transferable resources.
 - [ ] Track market-facing item attributes: quantity, quality, freshness,
  location, seller, ownership, storage condition, and pickup/delivery terms.
 - [ ] Add item reservation/lock rules so listed goods cannot be double-sold,
  consumed, moved, spoiled invisibly, or transferred while a sale is pending.
 - [ ] Add ownership transfer.
 - [ ] Add local price notes if needed.
 - [x] Add AGR placeholder integration planning.
@@ -1167,6 +1173,10 @@ Goal: Let player communities form organically through trade, trust, conflict, la
 - [ ] Add secure trade window.
 - [ ] Add barter offer records.
 - [ ] Add basic contract data model.
 - [ ] Add market stall and settlement market board flows where sellers can list
  produced goods and buyers can browse, reserve, and purchase them naturally.
 - [ ] Add direct player trade flow for face-to-face exchange of resources,
  animals, crafted goods, tools, labor promises, or delivery contracts.
 - [ ] Add delivery contract.
 - [ ] Add labor contract.
 - [ ] Add rental contract placeholder.
@@ -1175,8 +1185,16 @@ Goal: Let player communities form organically through trade, trust, conflict, la
 - [ ] Add AGR payment request flow for player-to-player trade: seller creates a
  payment request, buyer pays through their own wallet, and the server verifies
  chain confirmation before marking the contract paid.
 - [ ] Add `Buy with AGR` market flow: reserve item, create payment request,
  wait for confirmation, transfer ownership, release pickup/delivery rights, and
  record seller/buyer receipts.
 - [ ] Add AGR transaction receipt records linked to game accounts, trades,
  contracts, timestamps, confirmations, and settlement/dispute state.
 - [ ] Add timeout and cancellation rules so unpaid or failed AGR purchases
  unlock the item and return the listing to the market.
 - [ ] Add low-value fast-confirmation policy research for future UX, with fraud
  limits and rollback/dispute handling before any pending-payment delivery is
  allowed.
 - [ ] Decide whether player-to-player AGR trades use direct payment only,
  server-observed escrow, or a separate escrow service after legal and security
  review.
@@ -1363,6 +1381,8 @@ Goal: Enable cities, citizenship, taxation, diplomacy, organized law, warfare, a
 - [ ] Add treasury model.
 - [ ] Add tax rules.
 - [ ] Add settlement market fee rules for market stalls, board listings,
  storage usage, delivery contracts, and public trade infrastructure.
 - [ ] Add public storage.
 - [ ] Add road funding.
 - [ ] Add public building funding.
@@ -40,6 +40,27 @@
  wallet signing/payment UX through Qt wallet, website wallet, or companion
  wallet, plus legal/compliance review for real-value marketplace use.
 ## AGR Natural Market Flow Roadmap Update - 2026-05-21
 - Nathan clarified the intended economy feel: players should be able to grow
  crops, raise animals for meat, harvest wood, gather resources, craft goods,
  and sell those goods naturally at markets or directly to other players.
 - Roadmap updates added:
  - `0.2.F Simple Economy`: local market listing model, item quality/freshness,
    quantity, location, seller identity, pickup/delivery terms, and item
    reservation locks so goods cannot be double-sold during a pending sale.
  - `0.3.B Trade And Contracts`: market stall, settlement board, direct trade,
    `Buy with AGR`, payment request, confirmation wait, ownership transfer,
    receipts, timeout/cancellation, and future low-value fast-confirmation
    policy research.
  - `0.5.C Taxation And Public Works`: settlement market fees for stalls,
    board listings, storage, delivery contracts, and public trade
    infrastructure.
 - Design guardrail:
  game items remain server-authoritative, AGR funds remain wallet-authoritative,
  and the trade layer bridges them with reservations, payment requests,
  confirmation checks, receipts, and dispute records.
 ## Gitea Container Repair - 2026-05-20
 - Gitea is hosted on Unraid as Docker container `Gitea`.