TourPlanner (Angular)

SWEN2 2026 -- Tour planning application with .NET 10 backend and Angular 21 frontend.

Quick Start (Docker)

Requires Docker or OrbStack.

docker compose up -d

Service	URL
Frontend	http://localhost:7226
API	http://localhost:7102
pgAdmin	http://localhost:5050
Health	http://localhost:7102/health

pgAdmin login: admin@admin.com / admin

To stop:

docker compose down

Port conflicts

If any port is already in use, copy the example env file and adjust:

cp .env.example .env
# edit .env, then:
docker compose up -d

Local Development

Prerequisites

• Node 22.x (see .nvmrc)
• npm 10.x
• .NET SDK 10.0
• Docker or OrbStack (for PostgreSQL)

Steps

1. Start the database:

docker compose up -d postgres

2. Start the API:

dotnet watch --project API

3. Install frontend dependencies, regenerate the OpenAPI client types, and start the frontend (separate terminal):

npm ci
npm run generate
npm start

Open http://localhost:7226.

Build

npm run generate
dotnet build API/API.csproj
npm run build

Tests

npm test
npm run test:api

Run the full local verification pipeline:

npm run verify

Architecture

Same backend as the Blazor variant. The Angular frontend demonstrates that the UI layer is interchangeable when the API contract is stable.

Layer	Responsibility
Angular	Components, ViewModels, routing
API	HTTP endpoints, transport validation
BL	Business rules, orchestration
DAL	Persistence, external service access
Contracts	Shared DTOs