# Install devbox (if needed)
curl -fsSL https://get.jetify.com/devbox | bash

# Enter dev environment
devbox shell

# Run a service locally
cd services/gateway
go run .

Structure

services/       # Individual Go microservices
shared/         # Shared Go modules
deploy/         # Kubernetes manifests (kustomize)
  base/         # Base configs
  overlays/     # Environment-specific (development, etc.)

Services

Service	Description
gateway	API gateway, routes requests
auth	Authentication (Keycloak integration)
ota	OTA update management
depot	Vehicle registration & management
attendant	Event processing
cargo	Data ingestion to storage
ditto	Digital twin state
manufacture	Manufacturing integration
aftersales	Aftersales/diagnostic services

Local Development

Services connect to:

PostgreSQL: cloud-dev-rw.cnpg-system.svc:5432
MongoDB: cloud-dev-svc.mongodb.svc:27017
Redis: cloud-dev.redis.svc:6379
Kafka: cloud-dev-kafka-bootstrap.kafka.svc:9092
Keycloak: https://keycloak.mini.cloud.fiskerinc.com

Deployment

ArgoCD syncs from this repo. Push to main → auto-deploy to mini cluster.