Internal API & Architecture Documentation
Technical reference for NebusAI engineering team
Access Requirements
This documentation is restricted to authorized NebusAI engineers. Authentication via Cloudflare Access is required. For external API documentation, please visit docs.olympuscloud.ai.
Service Architecture
Auth Service
Authentication & authorization
- JWT RS256 token management
- Multi-factor authentication
- OAuth2/OIDC integrations
- Session & refresh tokens
- PIN authentication (staff)
Platform Service
Multi-tenant platform management
- Tenant lifecycle management
- RBAC & permissions engine
- Policy engine configuration
- Feature flags & toggles
- Location management
Commerce Service
Order & payment processing
- Menu item management
- Order state machine
- Payment orchestration
- Kitchen display integration
- Inventory sync
Analytics Pipeline
Data warehouse & ML
- Real-time metrics streaming
- BigQuery data warehouse
- Vertex AI model serving
- Dataflow pipelines
- Cost anomaly detection
API Gateway
Unified API surface
- GraphQL federation
- WebSocket management
- Rate limiting & throttling
- Request validation
- Circuit breakers
Edge Services
Cloudflare Workers
- JWT edge validation
- AI Gateway routing
- CDN cache management
- D1 domain sync
- Feature flags edge
Development Quick Start
# Clone the monorepo
git clone git@github.com:olympuscloud/olympus-cloud-gcp.git
# Start local development environment
docker-compose -f docker-compose.dev.yml up -d
# Run service tests
cd backend/rust && cargo test
cd backend/go && go test ./...
cd backend/python && pytest
# Generate dev tokens
python backend/rust/auth/scripts/generate_dev_tokens.py