add quick start script

Author: mofangju

README.md

@@ -62,7 +62,7 @@ docker build -t order-api .
 
 # Run (with LocalStack env vars)
 export SQS_QUEUE_URL=$(cd ../infra && terraform output -raw sqs_queue_url)
-export DDB_TABLE=$(cd ../infra && terraform output -raw dynamodb_table)
+export DDB_TABLE=$(cd ../infra && terraform output -raw dynamodb_table_name)
 export AWS_ENDPOINT_URL=http://host.docker.internal:4566  # for Docker → LocalStack
 
 docker run -p 8000:8000 \

scripts/quickstart.sh

@@ -0,0 +1,58 @@
+#!/usr/bin/env bash
+# Quick start local integration with LocalStack + Terraform + Docker services
+# Usage: ./scripts/localstack-quickstart.sh
+
+set -euo pipefail
+cd "$(dirname "$(realpath "$0")")/.."
+
+check_cmd() { command -v "$1" >/dev/null 2>&1 || { echo "Required command '$1' not found. Install it and retry."; exit 2; } }
+
+check_cmd docker
+check_cmd terraform
+check_cmd aws
+check_cmd docker-compose || true
+
+echo "1/5 Starting LocalStack..."
+cd localstack
+docker compose down -v || true
+docker compose up -d
+sleep 15
+
+echo "2/5 Applying infra (terraform)..."
+cd ../infra
+rm -rf .terraform* terraform.tfstate* || true
+terraform init -input=false
+terraform apply -var-file=dev.tfvars -auto-approve
+
+echo "3/5 Building and running order-api..."
+cd ../order-api
+docker build -t order-api .
+
+SQS_QUEUE_URL=$(cd ../infra && terraform output -raw sqs_queue_url)
+DDB_TABLE=$(cd ../infra && terraform output -raw dynamodb_table_name)
+export AWS_ENDPOINT_URL="http://host.docker.internal:4566"
+
+docker rm -f order-api 2>/dev/null || true
+docker run -d --name order-api -p 8000:8000 \
+  -e SQS_QUEUE_URL="$SQS_QUEUE_URL" \
+  -e DDB_TABLE="$DDB_TABLE" \
+  -e AWS_ENDPOINT_URL="$AWS_ENDPOINT_URL" \
+  order-api
+
+echo "4/5 Building and running order-processor..."
+cd ../order-processor
+go mod tidy
+docker build -t order-processor .
+
+HOST_PORT=${HOST_PORT:-9091}
+docker rm -f order-processor 2>/dev/null || true
+docker run -d --name order-processor -p ${HOST_PORT}:9090 \
+  -e SQS_QUEUE_URL="$SQS_QUEUE_URL" \
+  -e DDB_TABLE="$DDB_TABLE" \
+  -e AWS_ENDPOINT_URL="$AWS_ENDPOINT_URL" \
+  order-processor
+
+echo "Done. Services running:"
+echo " - Order API: http://localhost:8000"
+echo " - Processor metrics/health: http://localhost:${HOST_PORT}"
+echo "Tip: run ./scripts/smoke.sh to verify end-to-end."

scripts/smoke.sh

@@ -0,0 +1,44 @@
+#!/usr/bin/env bash
+set -euo pipefail
+cd "$(dirname "$(realpath "$0")")/.."
+
+command -v curl >/dev/null 2>&1 || { echo "curl required"; exit 2; }
+command -v jq >/dev/null 2>&1 || { echo "jq required"; exit 2; }
+
+HOST_PORT=${HOST_PORT:-9091}
+
+wait_for_url() {
+  local url=$1; local timeout=${2:-60}; local interval=2; local elapsed=0
+  while true; do
+    if curl -s -f "$url" >/dev/null 2>&1; then return 0; fi
+    sleep $interval
+    elapsed=$((elapsed + interval))
+    if [ "$elapsed" -ge "$timeout" ]; then return 1; fi
+  done
+}
+
+echo "Waiting for services..."
+wait_for_url "http://localhost:8000/health" 60 || { echo "Order API not ready"; exit 3; }
+wait_for_url "http://localhost:${HOST_PORT}/health" 60 || { echo "Processor not ready"; exit 4; }
+
+echo "Obtaining token..."
+TOKEN=$(curl -s -X POST http://localhost:8000/login -H "Content-Type: application/json" -d '{"user_id":"u123","amount":1}' | jq -r .access_token)
+[ -n "$TOKEN" ] && [ "$TOKEN" != "null" ] || { echo "Failed to get token"; exit 5; }
+
+echo "Posting order..."
+ORDER_RESP=$(curl -s -X POST http://localhost:8000/orders -H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json" -d '{"user_id":"u123","amount":999}')
+echo "Order response: $ORDER_RESP"
+
+echo "Waiting for metrics..."
+for i in {1..15}; do
+  if curl -s "http://localhost:${HOST_PORT}/metrics" | grep -q orders_processed_total; then
+    echo "Metrics:"
+    curl -s "http://localhost:${HOST_PORT}/metrics" | grep orders_processed_total || true
+    echo "Smoke tests passed."
+    exit 0
+  fi
+  sleep 2
+done
+
+echo "Metrics did not appear in time" >&2
+exit 6