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
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.