docs: update documentation to use Docker Compose and .env

- Update Quick Start to use docker compose up -d
- Add comprehensive .env.example with all options documented
- Update all port references (8090 for P2P, 8080 for RPC)
- Add Docker-based monitoring and troubleshooting commands
- Add operations playbooks for Docker workflow

Author: echobt

.env.example

@@ -1,8 +1,64 @@
-# Platform Chain Validator Configuration
-# Copy this file to .env and fill in your values
+# =============================================================================
+# Platform Validator Configuration
+# =============================================================================
+# Copy this file to .env and configure your validator.
+#
+# Usage:
+#   cp .env.example .env
+#   nano .env  # Edit with your values
+#   docker compose up -d
+# =============================================================================
 
-# REQUIRED: Your validator secret key (hex encoded 32 bytes or BIP39 mnemonic)
-VALIDATOR_SECRET_KEY=your_secret_key_here
+# -----------------------------------------------------------------------------
+# REQUIRED: Validator Secret Key
+# -----------------------------------------------------------------------------
+# Your validator hotkey as a BIP39 mnemonic (24 words).
+# This must match the hotkey registered on the Bittensor subnet.
+#
+# Example:
+# VALIDATOR_SECRET_KEY=word1 word2 word3 word4 word5 word6 word7 word8 word9 word10 word11 word12 word13 word14 word15 word16 word17 word18 word19 word20 word21 word22 word23 word24
+#
+VALIDATOR_SECRET_KEY=
 
-# Optional: Slack webhook for Watchtower notifications
+# -----------------------------------------------------------------------------
+# Network Configuration (Optional)
+# -----------------------------------------------------------------------------
+# Subnet UID (default: 100)
+# NETUID=100
+
+# Bittensor RPC endpoint
+# SUBTENSOR_ENDPOINT=wss://entrypoint-finney.opentensor.ai:443
+
+# -----------------------------------------------------------------------------
+# Port Configuration (Optional)
+# -----------------------------------------------------------------------------
+# JSON-RPC API port (default: 8080)
+# RPC_PORT=8080
+
+# P2P libp2p port (default: 8090)
+# P2P_PORT=8090
+
+# -----------------------------------------------------------------------------
+# P2P Configuration (Optional)
+# -----------------------------------------------------------------------------
+# Run integrated bootnode (default: false)
+# WITH_BOOTNODE=true
+# BOOTNODE_PORT=8090
+
+# Public IP for P2P announcements (auto-detected if not set)
+# EXTERNAL_IP=1.2.3.4
+
+# Bootstrap peers (auto-discovered from Bittensor if not set)
+# BOOTSTRAP_PEERS=/ip4/1.2.3.4/tcp/8090/p2p/12D3KooW...
+
+# -----------------------------------------------------------------------------
+# Logging (Optional)
+# -----------------------------------------------------------------------------
+# Log level: error, warn, info, debug, trace
+# RUST_LOG=info,validator_node=debug,platform_p2p_consensus=info
+
+# -----------------------------------------------------------------------------
+# Notifications (Optional)
+# -----------------------------------------------------------------------------
+# Slack webhook for Watchtower update notifications
 # SLACK_WEBHOOK_URL=https://hooks.slack.com/services/xxx/xxx/xxx

README.md

@@ -150,16 +150,34 @@ flowchart TB
 
 ## Quick Start (Validator)
 
+### Using Docker Compose (Recommended)
+
 ```bash
 git clone https://github.com/PlatformNetwork/platform.git
 cd platform
+
+# Configure environment
 cp .env.example .env
-# Edit .env: add your VALIDATOR_SECRET_KEY (BIP39 mnemonic)
-mkdir -p data
-cargo build --release --bin validator-node
-./target/release/validator-node --data-dir ./data --secret-key "${VALIDATOR_SECRET_KEY}"
+# Edit .env and set your VALIDATOR_SECRET_KEY (BIP39 mnemonic)
+nano .env
+
+# Start validator
+docker compose up -d
+
+# View logs
+docker compose logs -f validator
 ```
 
+### Environment Variables
+
+| Variable | Description | Required |
+|----------|-------------|----------|
+| `VALIDATOR_SECRET_KEY` | BIP39 mnemonic (24 words) | Yes |
+| `NETUID` | Subnet UID (default: 100) | No |
+| `SUBTENSOR_ENDPOINT` | Bittensor RPC endpoint | No |
+| `RPC_PORT` | RPC API port (default: 8080) | No |
+| `P2P_PORT` | P2P port (default: 8090) | No |
+
 See [Validator Operations](docs/operations/validator.md) for hardware, configuration, and monitoring.
 
 ---