FastAPI · PostgreSQL · AWS target

Secure URL Shortener Platform

A local-first URL shortening service with explicit ownership, lifecycle, and resolver boundaries. The service verifies its local PostgreSQL lifecycle while keeping the proposed AWS environment clearly identified as a design target.

Release
v0.1.0 candidate
Evidence
Local Compose lifecycle and CI verified
Boundary
No public endpoint or applied AWS environment

The product contract

Authenticated owners create, inspect, disable, and delete short links. Public resolution has deliberate lifecycle semantics: unknown codes return not found, while inactive links return gone. The service never fetches destinations on a user's behalf.

Validation constrains destination schemes, local or private targets, custom aliases, and ownership. Health and readiness remain separate so operators can distinguish a running process from a usable dependency path.

Architecture

Explicit lifecycle from validation to resolution

Open full-size SVG →
The local service and delivery definitions are verified; the AWS load balancer, ECS, Aurora, Secrets Manager, and CloudWatch resources remain unapplied.

Engineering decisions

  • Resolver safety: the server redirects but never retrieves user destinations.
  • Lifecycle clarity: missing and inactive links have distinct responses.
  • Container supply chain: pinned multi-platform images and scan evidence support repeatability.
  • Deployment truth: Terraform validation is not represented as a live service.

Review the service and delivery design.

GitHub repository →