# Docker Services Guide

This repository contains multiple microservices that can be run using Docker Compose.

## Quick Start (With Cache)
For regular development when dependencies haven't changed:
```bash
# Build and run Auth Service
docker compose -f ../docker-compose-services.yml up auth-service

# Build and run Event Service
docker compose -f ../docker-compose-services.yml up event-service

# Build and run Validation Service
docker compose -f ../docker-compose-services.yml up validation-service

# Build and run all services
docker compose -f ../docker-compose-services.yml up
```

## Clean Build (No Cache)
Use these commands when changing Dockerfile or dependencies:
```bash
# Auth Service
docker compose -f ../docker-compose-services.yml build --no-cache auth-service && docker compose -f ../docker-compose-services.yml up auth-service

# Event Service
docker compose -f ../docker-compose-services.yml build --no-cache event-service && docker compose -f ../docker-compose-services.yml up event-service

# Validation Service
docker compose -f ../docker-compose-services.yml build --no-cache validation-service && docker compose -f ../docker-compose-services.yml up validation-service

# All Services
docker compose -f ../docker-compose-services.yml build --no-cache && docker compose -f ../docker-compose-services.yml up
```

## Service Ports
- Auth Service: `http://localhost:8000`
  - `/test/health` - Protected health check endpoint (requires authentication)
  - `/test/ping` - Public ping endpoint
- Event Service: `http://localhost:8001`
- Validation Service: `http://localhost:8002`

## Development Notes
- Use clean build (--no-cache) when:
  - Changing Dockerfile
  - Updating dependencies
  - Experiencing caching issues
- Use regular build (with cache) when:
  - Only changing application code
  - For faster development iterations
- Run in detached mode:
  ```bash
  docker compose -f ../docker-compose-services.yml up -d auth-service
  ```
- Stop services:
  ```bash
  docker compose -f ../docker-compose-services.yml down
  ```