Add project documentation and initial analysis reports

docs/api-contracts-app.md

@@ -0,0 +1,18 @@
+# API Contracts (Backend)
+
+## Overview
+
+This document outlines the API surface of the PriceFlow backend.
+
+> **Note**: This is a high-level summary from a Quick Scan. Run a Deep Scan to generate full endpoint documentation.
+
+## Router Structure
+
+The API is organized into routers located in `app/routers`:
+
+- *(Content pending deep scan - check `app/routers` for specific files)*
+
+## Request/Response Formats
+
+- **Format**: JSON
+- **Validation**: Pydantic models (see `app/schemas.py`)