chore: initial project scaffolding with fastapi, docker and modular

structure

README.md

@@ -1 +1,36 @@
-# Playtomic Wrapper
+# Playtomic API Wrapper 🎾
+
+A **FastAPI-based** microservice that provides a clean, structured REST interface over Playtomic's private APIs. It automatically handles authentication, token persistence, and data normalization.
+
+## 🚀 Key Features
+
+- **Auto-Auth**: Manages Bearer tokens and handles automatic 401 refresh logic.
+- **Modular Design**: Organized by domain (Users, Bookings, Clubs) for easy scaling.
+- **Docker-Ready**: Fully containerized with Docker Compose for instant deployment.
+- **Auto-Documentation**: Integrated Swagger UI and ReDoc.
+- **Developer Friendly**: Built with modern Python standards (PEP 621, Pydantic v2).
+
+## 🛠 Tech Stack
+
+- **Python 3.11+**
+- **FastAPI** (Web framework)
+- **Pydantic** (Data validation & Settings)
+- **Requests** (HTTP Client with Session reuse)
+- **Docker & Docker Compose**
+
+---
+
+## 🚦 Getting Started
+
+### 1. Configuration
+
+Create a `.env` file in the project root based on the provided environment variables:
+
+```env
+PROJECT_NAME="Playtomic Wrapper"
+VERSION="1.0.0"
+API_V1_STR="/api/v1"
+
+PLAYTOMIC_EMAIL="your_email@example.com"
+PLAYTOMIC_PASSWORD="your_password"
+PLAYTOMIC_API_URL="[https://api.playtomic.io](https://api.playtomic.io)"