Modern Acceptance Testing in Legacy Code (.NET)

Prerequisites

• .NET 8 SDK
• Docker Desktop
• PowerShell 7+

Ensure you have .NET 8 SDK installed

dotnet --version

Check that you have PowerShell 7

$PSVersionTable.PSVersion

Run Everything

.\run.ps1 all

This will:

1. Build the Monolith (compile code and create Docker image)
2. Start Docker containers (Monolith, PostgreSQL, & Simulated External Systems)
3. Wait for services to be healthy
4. Run all System Tests (xUnit + Playwright)

You can open these URLs in your browser:

• Monolith Application: http://localhost:8081
• ERP API (JSON Server): http://localhost:3100
• Tax API (JSON Server): http://localhost:3101
• PostgreSQL: localhost:5433 (username: eshop_user, password: eshop_password)

Separate Commands

Build

Compiles the code and creates the Docker image (local mode only):

.\run.ps1 build

Start Services

Starts the Docker containers:

# Local mode (builds from source)
.\run.ps1 start

# Pipeline mode (uses pre-built image)
.\run.ps1 start pipeline

You can open these URLs in your browser:

• Monolith Application: http://localhost:8081
• ERP API (JSON Server): http://localhost:3100
• Tax API (JSON Server): http://localhost:3101
• PostgreSQL: localhost:5433 (username: eshop_user, password: eshop_password)

Run Tests

.\run.ps1 test

View Logs

.\run.ps1 logs

Stop Services

.\run.ps1 stop

License

This project is released under the MIT License.

Contributors

• Valentina Jemuović
• Jelena Cupać