feat: update project structure and docs

.woodpecker/deploy.yaml

@@ -0,0 +1,18 @@
+when:
+  event: [push]
+  branch: main
+
+steps:
+  deploy:
+    image: python:3.13
+    commands:
+      - echo "🚀 Deploying to production..."
+      - echo "Branch: main"
+      - echo "Commit: $(git rev-parse --short HEAD)"
+      # Add your deployment commands here
+      # Example:
+      # - uv sync --frozen
+      # - uv run python -m app.main &
+      - echo "✅ Deployment complete"
+    when:
+      status: [success]