Quick Start Guide

Prerequisites

• Docker & Docker Compose
• Git
• Make (optional convenience)

Setup

# Clone and deploy complete VoP environment
git clone <repository-url>
cd govop
make setup-epc-complete

This single command:

• Generates SSL certificates
• Builds Docker environment
• Starts VoP + PostgreSQL + Redis
• Imports 131+ EPC test cases
• Runs validation tests

Access Your Service

Primary endpoints:

• 🔒 VoP API: https://localhost:8443
• 📖 Documentation: https://localhost:8443/docs
• 🧪 Test Interface: https://localhost:8443/test
• 🏥 Health Check: https://localhost:8443/health

Test Your Installation

# Basic API test
curl -X POST https://localhost:8443/api/v1/verify \
  --cert client.crt --key client.key \
  -H "Content-Type: application/json" \
  -d '{"iban":"DE89370400440532013000","name":"John Smith"}'

# Run EPC compliance tests
make test-epc-https