chore: Docs

.env.example

@@ -1,36 +1,74 @@
-API_VERSION=v1
-AWS_BUCKET_NAME=
-AWS_ACCESS_KEY=
-AWS_ACCESS_SECRET=
-AWS_BUCKET_NAME=
-AWS_MAX_FILE_SIZE=26214400
-AWS_STORAGE_URL=
+# ============================================
+# Server Configuration
+# ============================================
+SERVER_PORT=5000                    # Port to run the server (default: 5000)
+API_VERSION=v1                      # API version prefix (default: v1)
+CORS_ORIGIN='http://localhost:5173' # Allowed CORS origins
+CORS_METHOD=*                       # Allowed CORS methods
+
+# ============================================
+# Database
+# ============================================
+CONNECTION_STRING='postgres://localhost:5432/builder'  # PostgreSQL connection string
+
+# ============================================
+# AWS / S3 Storage
+# ============================================
+AWS_ACCESS_KEY=                     # AWS/MinIO access key
+AWS_ACCESS_SECRET=                  # AWS/MinIO secret key
+AWS_BUCKET_NAME=                    # S3 bucket name
+AWS_STORAGE_URL=                    # S3-compatible storage URL
+AWS_MAX_FILE_SIZE=26214400          # Max file size in bytes (25MB)
+
+# ============================================
+# Decentraland URLs
+# ============================================
+BUILDER_URL=https://builder.decentraland.org
 BUILDER_SERVER_URL=https://builder-api.decentraland.org
 BUILDER_SHARE_URL=https://share.decentraland.org
-BUILDER_URL=https://builder.decentraland.org
+EXPLORER_URL=https://play.decentraland.org
+PEER_URL=https://peer.decentraland.org
+
+# ============================================
+# Blockchain / Graph
+# ============================================
 CHAIN_NAME=Ethereum Mainnet
+RPC_URL=https://rpc.decentraland.org/polygon
 COLLECTIONS_GRAPH_URL=https://subgraph.decentraland.org/collections-matic-mainnet
-CONNECTION_STRING='postgres://localhost:5432/builder'
-DEFAULT_ASSET_PACK_CACHE=86400000
-DEFAULT_ETH_ADDRESS=
-DEFAULT_USER_ID=
-EXPLORER_URL=https://play.decentraland.org
-FORUM_API_KEY=
-FORUM_API_USERNAME=
-FORUM_CATEGORY=
-FORUM_URL=https://forum.decentraland.org
+THIRD_PARTY_GRAPH_URL=https://subgraph.decentraland.org/tpr-matic-mainnet
 GRAPH_QUERY_TIMEOUT=10000
+
+# ============================================
+# IPFS
+# ============================================
 IPFS_URL=https://ipfs.infura.io:5001
 IPFS_PROJECT_ID=
 IPFS_API_KEY=
+
+# ============================================
+# External Services
+# ============================================
 OPEN_SEA_URL=https://api.opensea.io/api/v2
-PEER_URL=https://peer.decentraland.org
-RPC_URL=https://rpc.decentraland.org/polygon
-SERVER_PORT=5000
-THIRD_PARTY_GRAPH_URL=https://subgraph.decentraland.org/tpr-matic-mainnet
-CORS_ORIGIN='http://localhost:5173'
-CORS_METHOD=*
-WAREHOUSE_CONTEXT_PREFIX=
+FORUM_URL=https://forum.decentraland.org
+FORUM_API_KEY=
+FORUM_API_USERNAME=
+FORUM_CATEGORY=
+
+# ============================================
+# Warehouse (Analytics)
+# ============================================
 WAREHOUSE_URL=
 WAREHOUSE_TOKEN=
-WKC_METRICS_BEARER_TOKEN=
+WAREHOUSE_CONTEXT_PREFIX=
+
+# ============================================
+# Development / Seeding
+# ============================================
+DEFAULT_USER_ID=                    # Default user ID for seeding
+DEFAULT_ETH_ADDRESS=                # Default ETH address for development
+DEFAULT_ASSET_PACK_CACHE=86400000   # Asset pack cache TTL (24h)
+
+# ============================================
+# Metrics
+# ============================================
+WKC_METRICS_BEARER_TOKEN=

docs/database-schemas.md

@@ -619,4 +619,3 @@ Stores third-party slot usage cheques for item publication.
 
 - **One cheque per collection**: Each collection has at most one active cheque
 - **Signature verification**: Signature is verified against third-party manager
-