Skip to content
Back to all projects

Backend

adreskodusorgula-api

A Fastify/TypeScript backend API for Turkish national address (UAVT) code lookups, running live in production on Railway.

Problem

Provides the production address-lookup API behind a public Turkish address-code website, serving real traffic.

Highlights

  • Running live in production with health and readiness endpoints
  • Structured JSON logging with Pino
  • Sentry error monitoring and uptime checks
  • Zod request validation and a Vitest test suite
  • Dockerized deployment on Railway

Architecture and notes

A Fastify 5 / TypeScript API with Zod request validation and a Vitest suite, backed by PostgreSQL and Redis. It exposes health and readiness endpoints, writes structured JSON logs with Pino, reports errors to Sentry, is watched by uptime checks, and runs as a Docker container on Railway.

Technologies

  • Node.js 24
  • Fastify 5
  • TypeScript
  • Zod
  • PostgreSQL (Neon)
  • Redis (Upstash)
  • Pino
  • Sentry
  • Railway
  • Docker