Add Makefile and .env.example

.env.example

@@ -0,0 +1,7 @@
+MQTT_BROKER=tcp://mosquitto:1883
+GENERATOR_ID=stream-generator
+INGESTION_ID=stream-ingestor
+GATEWAY_ADDR=gateway:50051
+PUBLISH_RATE=10  # events/sec
+INGESTION_WORKERS=4
+INGESTION_QUEUE_SIZE=1000

Makefile

@@ -0,0 +1,23 @@
+## help: Show available commands
+help:
+	@echo ""
+	@echo "Usage: make [target]"
+	@echo ""
+	@echo "Available targets:"
+	@echo "  config  - Copy environment config from .env.example" 
+	@echo "  up      - Build and run services with docker" 
+	@echo "  down    - Shut down services in docker"
+	@echo "  test    - Run tests with race detection" 
+	@echo ""
+
+config:
+	cp .env.example .env
+
+test:
+	go test ./... -race
+
+up:
+	docker compose up --build
+
+down:
+	docker compose down