git clone <repository-url>
cd CROP-parts-services
bun install
bun run docker:up        # Start MongoDB + Elasticsearch
bun run dev              # Start all services
bun run dev search catalog  # Start specific services only

CROP-parts-services/
├── services/              # 8 microservices
│   ├── search/           # Elasticsearch-powered parts search
│   ├── catalog/          # Product catalog management
│   ├── cart/             # Shopping cart
│   ├── user/             # User accounts and garage
│   ├── payment/          # Stripe payments
│   ├── media/            # Image handling
│   ├── analytics/        # Usage analytics
│   └── health-analytics/ # Health monitoring
├── packages/              # 12 shared packages
│   ├── shared-types/     # TypeScript types and Zod schemas
│   ├── shared-auth/      # Authentication utilities
│   ├── shared-catalog/   # Catalog domain logic
│   ├── shared-hono/      # Hono middleware
│   ├── shared-db/        # MongoDB connection management
│   └── ...
├── scripts/               # Operational utilities
└── terraform/             # GCP infrastructure as code

# Development
bun install                     # Install all workspace dependencies
bun run dev                     # Start all services in dev mode
bun run build                   # Build all packages and services

# Testing
bun test                        # Run tests across monorepo
bun run test:coverage           # With coverage report

# Code Quality
bun run lint                    # Run Biome linter
bun run typecheck               # TypeScript type checking
bun run check:all               # Full validation (lint + checks + dead-code)

# Docker (Local Infrastructure)
bun run docker:up               # Start MongoDB + Elasticsearch + Kibana
bun run docker:down             # Stop local databases

# Stage VMs
bun run vm:health               # Check VM status + API health
bun run vm:up                   # Start ES + RabbitMQ VMs
bun run vm:down                 # Stop VMs (cost savings)