2025-10-30 12:18:57 +01:00
|
|
|
# ========================================
|
|
|
|
|
# ENVIRONMENT VARIABLES TEMPLATE
|
|
|
|
|
# ========================================
|
|
|
|
|
# Copy this file to .env and fill in your actual values
|
|
|
|
|
# NEVER commit .env with real secrets to git!
|
|
|
|
|
|
|
|
|
|
# === Frontend Variables ===
|
|
|
|
|
VITE_API_BASE_URL=https://puffinoffset.com/api
|
|
|
|
|
VITE_WREN_API_TOKEN=your_wren_api_token_here
|
|
|
|
|
VITE_FORMSPREE_CONTACT_ID=your_formspree_contact_id
|
|
|
|
|
VITE_FORMSPREE_OFFSET_ID=your_formspree_offset_id
|
|
|
|
|
VITE_STRIPE_PUBLISHABLE_KEY=your_stripe_publishable_key_here
|
|
|
|
|
|
|
|
|
|
# === Backend Variables ===
|
|
|
|
|
NODE_ENV=production
|
|
|
|
|
PORT=3001
|
|
|
|
|
FRONTEND_URL=https://puffinoffset.com
|
|
|
|
|
|
|
|
|
|
# === Stripe Configuration ===
|
|
|
|
|
# Use sk_test_* keys for testing (no real charges)
|
|
|
|
|
# Use sk_live_* keys for production (real charges)
|
|
|
|
|
STRIPE_SECRET_KEY=your_stripe_secret_key_here
|
|
|
|
|
STRIPE_WEBHOOK_SECRET=your_stripe_webhook_secret_here
|
|
|
|
|
|
|
|
|
|
# === Wren API Configuration ===
|
|
|
|
|
WREN_API_TOKEN=your_wren_api_token_here
|
|
|
|
|
# Set to true for testing (no real offsets purchased)
|
|
|
|
|
# Set to false for production (real offsets purchased)
|
|
|
|
|
WREN_DRY_RUN=true
|
|
|
|
|
|
|
|
|
|
# === Database Configuration ===
|
|
|
|
|
DATABASE_PATH=/app/data/orders.db
|
|
|
|
|
|
Add NocoDB integration for order management with comprehensive Stripe webhook logging
Features:
- Complete NocoDB schema with 42 fields supporting B2B and B2C customers
- Server-side NocoDB client (REST API integration)
- Stripe session data mapper with automatic field mapping
- Enhanced webhook handler with comprehensive logging
- Automatic order creation in NocoDB after payment
- Fulfillment data updates with Wren order IDs
- Support for business customers (VAT/EIN, business names)
- Complete billing address capture
- Non-blocking error handling (webhook succeeds even if NocoDB fails)
Files Added:
- server/utils/nocodbClient.js - NocoDB REST API client
- server/utils/nocodbMapper.js - Stripe to NocoDB data mapper
- docs/NOCODB_SCHEMA.md - Complete field reference (42 columns)
- docs/NOCODB_INTEGRATION_GUIDE.md - Testing and deployment guide
- docs/TESTING_STRIPE_WEBHOOK.md - Webhook testing instructions
- docs/STRIPE_INTEGRATION_SUMMARY.md - Project overview
Files Modified:
- server/routes/webhooks.js - Added NocoDB integration and enhanced logging
- src/types.ts - Updated OrderRecord interface with new fields
- src/api/nocodbClient.ts - Added createOrder() method
- .env.example - Added NocoDB configuration template
Schema includes:
- Payment tracking (Stripe session/intent/customer IDs, amounts, fees)
- Carbon offset details (tons, portfolio, Wren order ID)
- Customer information (name, email, phone, business name)
- Tax ID collection (VAT, EIN, etc.)
- Complete billing address
- Optional vessel/trip details for yacht calculations
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>
2025-11-03 16:35:15 +01:00
|
|
|
# === NocoDB Configuration ===
|
|
|
|
|
NOCODB_BASE_URL=https://your-nocodb-instance.com
|
|
|
|
|
NOCODB_BASE_ID=your_base_id_here
|
|
|
|
|
NOCODB_API_KEY=your_nocodb_api_key_here
|
|
|
|
|
NOCODB_ORDERS_TABLE_ID=your_orders_table_id_here
|
|
|
|
|
|
2025-10-31 21:01:57 +01:00
|
|
|
# === Email Configuration ===
|
|
|
|
|
SMTP_HOST=mail.puffinoffset.com
|
|
|
|
|
SMTP_PORT=587
|
|
|
|
|
SMTP_SECURE=false
|
|
|
|
|
SMTP_USER=noreply@puffinoffset.com
|
|
|
|
|
SMTP_PASSWORD=your_smtp_password_here
|
|
|
|
|
SMTP_FROM_NAME=Puffin Offset
|
|
|
|
|
SMTP_FROM_EMAIL=noreply@puffinoffset.com
|
|
|
|
|
ADMIN_EMAIL=matt@puffinoffset.com
|
|
|
|
|
|
2025-10-30 12:18:57 +01:00
|
|
|
# ========================================
|
|
|
|
|
# NOTES
|
|
|
|
|
# ========================================
|
|
|
|
|
#
|
|
|
|
|
# STRIPE TEST MODE:
|
|
|
|
|
# - Use sk_test_* and pk_test_* keys
|
|
|
|
|
# - Test card: 4242 4242 4242 4242 (any future date, any CVC)
|
|
|
|
|
# - No real money charged
|
|
|
|
|
#
|
|
|
|
|
# WREN DRY RUN:
|
|
|
|
|
# - WREN_DRY_RUN=true means no real carbon offsets purchased
|
|
|
|
|
# - Switch to false when ready for production
|
|
|
|
|
#
|
|
|
|
|
# PORT MAPPING:
|
|
|
|
|
# - PORT=3001 is the internal container port
|
|
|
|
|
# - Host exposes backend on port 3801 (3801:3001)
|
|
|
|
|
# - Frontend exposed on port 3800
|
|
|
|
|
#
|