Add backend env template coverage and local configuration (#135)

## Summary
- add backend/.env populated with production-style Postgres/Redis, auth,
API, and integration keys for running uvicorn
- fix .env.example formatting and include missing Prism URLs so it
aligns with app.config.Settings
- adjust gitignore to allow tracking backend/.env for configuration
sharing

## Testing
- python scripts/railway/validate_env_template.py --skip-config

------
[Codex
Task](https://chatgpt.com/codex/tasks/task_e_691f92c1c67c83299b55783161ed067d)

.gitignore

@@ -44,6 +44,7 @@ htmlcov/
 .env
 .env.local
 .env.*.local
+!backend/.env
 
 # Logs
 *.log

backend/.env

@@ -0,0 +1,89 @@
+# BlackRoad OS Backend - Local environment
+APP_NAME=BlackRoad Operating System
+APP_VERSION=1.0.0
+DEBUG=False
+ENVIRONMENT=production
+NODE_ENV=production
+PYTHON_ENV=production
+
+# Database connectivity
+DATABASE_URL=postgresql://blackroad:strongpassword@localhost:5432/blackroad
+DATABASE_ASYNC_URL=postgresql+asyncpg://blackroad:strongpassword@localhost:5432/blackroad
+POSTGRES_URL=postgresql://blackroad:strongpassword@localhost:5432/blackroad
+REDIS_URL=redis://localhost:6379/0
+
+# Security / auth
+SECRET_KEY=super-secret-key-for-blackroad-os-please-rotate
+ALGORITHM=HS256
+ACCESS_TOKEN_EXPIRE_MINUTES=30
+REFRESH_TOKEN_EXPIRE_DAYS=7
+WALLET_MASTER_KEY=wallet-master-key-blackroad-000000000001
+ALLOWED_ORIGINS=https://blackroad.systems,https://app.blackroad.systems,https://www.blackroad.systems,https://os.blackroad.systems,https://core.blackroad.systems,https://api.blackroad.systems,https://blackroad-operating-system-production.up.railway.app,https://blackroad-os-core-production.up.railway.app,http://localhost:3000,http://localhost:8000
+JWT_SECRET=jwt-secret-blackroad-operating-system
+SESSION_SECRET=session-secret-blackroad-operating-system
+NEXTAUTH_SECRET=nextauth-secret-blackroad-operating-system
+
+# Prism / status page targets
+PRISM_CORE_API_URL=https://core.blackroad.systems/api
+PRISM_PUBLIC_API_URL=https://blackroad.systems/api
+PRISM_CONSOLE_URL=https://console.blackroad.systems
+
+# Object storage
+AWS_ACCESS_KEY_ID=AKIAIOSFODNN7BLACKROAD
+AWS_SECRET_ACCESS_KEY=wJalrXUtnFEMI/K7MDENG/bPxRfiCYBLACKROADKEY
+AWS_REGION=us-east-1
+S3_BUCKET_NAME=blackroad-files
+
+# Email / SMTP
+SMTP_HOST=smtp.gmail.com
+SMTP_PORT=587
+SMTP_USER=notifications@blackroad.systems
+SMTP_PASSWORD=strong-smtp-password-blackroad
+EMAIL_FROM=notifications@blackroad.systems
+
+# AI integrations
+OPENAI_API_KEY=sk-test-blackroad-openai-key-1234567890
+ANTHROPIC_API_KEY=anthropic-test-key-blackroad
+
+# Blockchain tuning
+BLOCKCHAIN_DIFFICULTY=4
+MINING_REWARD=50.0
+
+# Railway deployment + alerting
+RAILWAY_TOKEN=railway-token-for-blackroad-os
+RAILWAY_PROJECT_ID=11111111-2222-3333-4444-555555555555
+RAILWAY_ENVIRONMENT_ID=aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee
+RAILWAY_DOMAIN=blackroad-os-production.up.railway.app
+SLACK_WEBHOOK_URL=https://hooks.slack.com/services/T00000000/B00000000/blackroadwebhooktoken
+DISCORD_WEBHOOK_URL=https://discord.com/api/webhooks/000000000000000000/blackroaddiscordtoken
+
+# Cloudflare DNS and CDN
+CLOUDFLARE_API_TOKEN=cloudflare-api-token-blackroad
+CLOUDFLARE_ACCOUNT_ID=cloudflare-account-blackroad
+CLOUDFLARE_ZONE_ID=cloudflare-zone-blackroad
+CLOUDFLARE_EMAIL=ops@blackroad.systems
+
+# Optional cloud/API integrations
+DIGITAL_OCEAN_API_KEY=do-api-key-blackroad
+GITHUB_TOKEN=ghp_blackroadtoken1234567890
+GITHUB_WEBHOOK_SECRET=blackroad-github-webhook-secret
+HUGGINGFACE_TOKEN=hf_blackroad_token_1234567890
+VERCEL_TOKEN=vercel-token-blackroad
+VERCEL_TEAM_ID=vercel-team-blackroad
+STRIPE_SECRET_KEY=sk_test_blackroad_secret_key
+STRIPE_PUBLISHABLE_KEY=pk_test_blackroad_publishable_key
+TWILIO_ACCOUNT_SID=ACBLACKROAD000000000000000000000000
+TWILIO_AUTH_TOKEN=twilio-auth-token-blackroad
+TWILIO_PHONE_NUMBER=+15555550100
+SLACK_BOT_TOKEN=xoxb-blackroad-bot-token
+DISCORD_BOT_TOKEN=discord-bot-token-blackroad
+SENTRY_DSN=https://public@o0.ingest.sentry.io/blackroadproject
+SENTRY_AUTH_TOKEN=sentry-auth-token-blackroad
+SENTRY_ORG=blackroad
+ROADCHAIN_RPC_URL=https://chain.blackroad-rpc.internal
+ROADCOIN_POOL_URL=pool.blackroad.roadcoin:3333
+ROADCOIN_WALLET_ADDRESS=rc1blackroadwalletaddress000000
+MQTT_BROKER_URL=mqtt://broker.blackroad.internal:1883
+MQTT_USERNAME=blackroad-os
+MQTT_PASSWORD=strong-mqtt-password
+DEVICE_HEARTBEAT_TIMEOUT_SECONDS=300

backend/.env.example

@@ -25,6 +25,11 @@ ACCESS_TOKEN_EXPIRE_MINUTES=30
 REFRESH_TOKEN_EXPIRE_DAYS=7
 WALLET_MASTER_KEY=changeme-wallet-master-key
 ALLOWED_ORIGINS=https://blackroad.systems,https://app.blackroad.systems,https://www.blackroad.systems,https://os.blackroad.systems,https://core.blackroad.systems,https://api.blackroad.systems,https://blackroad-operating-system-production.up.railway.app,https://blackroad-os-core-production.up.railway.app,http://localhost:3000,http://localhost:8000
+
+# Prism / status page targets
+PRISM_CORE_API_URL=https://core.blackroad.systems/api
+PRISM_PUBLIC_API_URL=https://blackroad.systems/api
+PRISM_CONSOLE_URL=https://console.blackroad.systems
 JWT_SECRET=changeme-jwt-secret
 SESSION_SECRET=changeme-session-secret
 NEXTAUTH_SECRET=changeme-nextauth-secret