chore: bootstrap project structure

README.md

@@ -0,0 +1,22 @@
+# Telecom CDR Pipeline
+
+High-throughput telecom Call Detail Record ingestion and analytics pipeline.
+
+## Architecture
+
+The system will consist of:
+
+1. FastAPI ingestion API
+2. Kafka-compatible Redpanda message broker
+3. Processing and normalization worker
+4. ClickHouse analytics database
+
+Data flow:
+
+Network Element → Ingestion API → Redpanda → Worker → ClickHouse
+
+Malformed or unprocessable records are routed by the worker to a Dead Letter Queue.
+
+## Development Status
+
+Currently under development.