This project provides a fully containerized, ready-to-use backend for storing and retrieving data. Anyone — a developer, analyst, or student — can spin it up instantly to test workflows, prototype APIs, or learn backend concepts without needing to set up Postgres or dependencies manually.
It's a microcosm of a real-world backend system, showing reliability, reproducibility, and scalability in a small, hands-on package.
Key Features
🚀 Instant Setup
Run a single command to get everything up and running with Docker.
📚 Interactive Docs
Built-in API documentation at /docs
💾 Full Database
Complete Postgres integration with reliable data persistence.
Getting Started
Start the services
Run docker-compose up to launch both the API and Postgres database.
Access the API
Open http://localhost:8000/docs in your browser to explore and interact with the API.
Start storing data
Use POST /records to store data and GET /records to retrieve it.
Example Record
Here's what a sample record looks like:
{
"type": "example",
"message": "hello world",
"value": 123
}