feat: initial project scaffold and repository setup

.gitignore

@@ -0,0 +1,24 @@
+# Python bytecode & cache
+__pycache__/
+*.py[cod]
+*$py.class
+
+# Virtual environments
+venv/
+env/
+.venv/
+
+# Environment files
+.env
+
+# Data files (track folders via .gitkeep, ignore data dumps)
+data/raw/*
+!data/raw/.gitkeep
+data/processed/*
+!data/processed/.gitkeep
+
+# IDE & system artifacts
+.vscode/
+.idea/
+.DS_Store
+Thumbs.db