From 8c145c0d0195442be4c5af5279259f3cacc1c3f3 Mon Sep 17 00:00:00 2001
From: C <0xicl33n@gmail.com>
Date: Sun, 21 Dec 2025 16:01:57 -0800
Subject: [PATCH] example env is pogchampion

---
 .env.example | 72 ++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 72 insertions(+)
 create mode 100644 .env.example

diff --git a/.env.example b/.env.example
new file mode 100644
index 0000000..f043be1
--- /dev/null
+++ b/.env.example
@@ -0,0 +1,72 @@
+# studspider Environment Configuration
+
+# ============================================================================
+# Square API Configuration
+# ============================================================================
+
+# Environment: "production" or "sandbox"
+SQUARE_ENV=sandbox
+
+# Sandbox credentials
+SANDBOX_SQUARE_APP_ID=your_sandbox_app_id
+SANDBOX_SQUARE_TOKEN=your_sandbox_access_token
+
+# Production credentials
+PROD_SQUARE_APP_ID=your_production_app_id
+PROD_SQUARE_TOKEN=your_production_access_token
+
+# Square LEGO category ID (find this in Square Dashboard)
+SQUARE_LEGO_CAT_ID=your_lego_category_id
+
+# ============================================================================
+# Brickset API Configuration
+# ============================================================================
+
+BRICKSET_USERNAME=your_brickset_username
+BRICKSET_PASS=your_brickset_password
+BRICKSET_API_KEY=your_brickset_api_key
+
+# ============================================================================
+# SSL Certificate Configuration (Optional)
+# ============================================================================
+
+# NOTE: Only needed if running HTTPS directly (not recommended with nginx)
+# For nginx reverse proxy setup, leave these empty
+
+# Path to SSL certificate in PEM format
+# SSL_CERT_PATH=/path/to/cert.pem
+
+# Path to SSL private key in PEM format
+# SSL_KEY_PATH=/path/to/key.pem
+
+# ============================================================================
+# Square Webhook Certificate (P7B Format)
+# ============================================================================
+
+# Path to P7B certificate file for Square webhook signature verification
+# This file is UPLOADED to Square Dashboard, not used by your server
+# Generate with: python convert_to_p7b.py
+SQUARE_P7B_PATH=./cert.p7b
+
+# ============================================================================
+# Server Configuration (Optional)
+# ============================================================================
+
+# Default host and port (can override with command line args)
+# SERVER_HOST=0.0.0.0
+# SERVER_PORT=7432
+# SERVER_HOOK_PORT=8080
+
+# ============================================================================
+# Usage Examples
+# ============================================================================
+
+# Basic HTTP server (recommended with nginx):
+#   python src/test_server.py
+#
+# With SSL from .env:
+#   Set SSL_CERT_PATH and SSL_KEY_PATH above, then:
+#   python src/test_server.py --hook-port 8443 --hook-ssl-only
+#
+# Override SSL from command line:
+#   python src/test_server.py --ssl-cert /custom/cert.pem --ssl-key /custom/key.pem