docs(readme): refresh project status and production usage guide

Author: zubeyralmaho

README.md

@@ -4,30 +4,40 @@ Spatiad is an open-source spatial dispatch engine for real-time fleets.
 
 ## What this repository contains
 
-- A Rust single-binary engine foundation
-- H3-oriented spatial indexing crate scaffold
-- HTTP + WebSocket API scaffold for dispatcher/driver flows
-- pnpm workspace with SDK, Express integration example, and docs package
+- Rust multi-crate backend (dispatch core, API, WS protocol, binary runtime)
+- HTTP + WebSocket dispatch API
+- H3-oriented geospatial matching foundation
+- TypeScript monorepo (SDK, Express plugin, example app)
+- Deployment assets (Docker, docker-compose, Kubernetes, systemd)
 
 ## Current status
 
-Initial implementation scaffold is in place. The next milestone is wiring the end-to-end dispatch loop:
+Production-ready baseline is implemented with:
 
-1. driver location updates
-2. nearest candidate lookup
-3. offer timeout/radius expansion
-4. websocket reconnect replay for pending offers
-5. match lock-in and webhook callback
+1. End-to-end dispatch lifecycle (offer creation, expiration, re-offer, match lock-in)
+2. Job status and job event timeline APIs with cursor pagination
+3. Dispatcher and driver token-based authentication
+4. Dispatch rate limiting and WS reconnect guard
+5. Webhook signing, retry, and failure event recording
+6. Readiness and liveness split for orchestration
+7. Request ID propagation and access logs
 
-## Quick start (scaffold)
+## Quick start
 
-### Rust
+### Run API server
 
 ```bash
 cd rust
 cargo run -p spatiad-bin
 ```
 
+Health check:
+
+```bash
+curl http://localhost:3000/health
+curl http://localhost:3000/ready
+```
+
 ### TypeScript workspace
 
 ```bash
@@ -36,9 +46,52 @@ pnpm install
 pnpm -r build
 ```
 
+### Run core tests
+
+```bash
+# Rust API unit + integration tests
+cd rust
+cargo test -p spatiad-api
+
+# SDK tests
+cd ../typescript
+pnpm --filter @spatiad/sdk test
+```
+
+## Key runtime configuration
+
+- SPATIAD_BIND_ADDR (default: 0.0.0.0:3000)
+- SPATIAD_LOG_LEVEL (default: info)
+- SPATIAD_H3_RESOLUTION (default: 8)
+- SPATIAD_DRIVER_TOKEN (optional)
+- SPATIAD_DISPATCHER_TOKEN (optional)
+- SPATIAD_DISPATCH_RATE_LIMIT_PER_MIN (default: 240)
+- SPATIAD_WS_RECONNECT_MAX_PER_MIN (default: 30)
+- SPATIAD_WEBHOOK_URL (optional)
+- SPATIAD_WEBHOOK_SECRET (optional)
+- SPATIAD_WEBHOOK_TIMEOUT_MS (default: 3000)
+
+See full matrix in docs/CONFIG.md.
+
+## Deployment options
+
+- Docker: Dockerfile
+- Compose: docker-compose.yml
+- Kubernetes: k8s/deployment.yaml
+- systemd: dist/spatiad.service
+
+Detailed deployment steps are in docs/DEPLOYMENT.md.
+
 ## Documentation
 
-High-level architecture and MVP documentation plan:
+Primary references:
 
-- docs/IMPLEMENTATION_PLAN.md
+- docs/GETTING_STARTED.md
+- docs/API_HTTP.md
+- docs/WS_PROTOCOL.md
+- docs/SECURITY.md
+- docs/CONFIG.md
+- docs/DEPLOYMENT.md
+- docs/OPERATIONS_RUNBOOK.md
+- docs/TROUBLESHOOTING.md
 - ARCHITECTURE.md