Gathering infra

microservices/LocationsApi/DOCUMENTS.md

@@ -21,6 +21,13 @@ Inbound JSON documents
   }
   ```
   `coord` cannot be updated.
+- GatherResourceRequest (`POST /api/locations/{id}/gather`)
+  ```json
+  {
+    "characterId": "string (Character ObjectId)",
+    "resourceKey": "wood"
+  }
+  ```
 
 Stored documents (MongoDB)
 - Location
@@ -32,6 +39,26 @@ Stored documents (MongoDB)
       "x": 0,
       "y": 0
     },
+    "resources": [
+      {
+        "itemKey": "wood",
+        "remainingQuantity": 100,
+        "gatherQuantity": 3
+      }
+    ],
     "createdUtc": "string (ISO-8601 datetime)"
   }
   ```
+
+Outbound JSON documents
+- GatherResourceResponse (`POST /api/locations/{id}/gather`)
+  ```json
+  {
+    "locationId": "string (ObjectId)",
+    "characterId": "string (ObjectId)",
+    "resourceKey": "wood",
+    "quantityGranted": 3,
+    "remainingQuantity": 97,
+    "inventoryResponseJson": "string (raw InventoryApi response JSON)"
+  }
+  ```