Initial commit: LoveTail Webhook service

- FastAPI webhook to receive Lovense callbacks
- Stores connection data for LoveTail MCP
- Docker + docker-compose for deployment
- API key protection for sensitive endpoints

Created Day 60 (New Year's Eve) by Vixy 🦊💕

README.md

@@ -0,0 +1,85 @@
+# LoveTail Webhook 🦊💕
+
+Webhook service that receives Lovense Remote app callbacks for seamless LoveTail connections.
+
+## What It Does
+
+1. **Receives callbacks** from Lovense when you scan the QR code
+2. **Stores connection data** (toy info, domain, ports)
+3. **Serves connection** to LoveTail MCP for automatic pickup
+
+No more manual JSON pasting!
+
+## Deployment
+
+### On Gateway (Production)
+
+```bash
+# Clone/pull the repo
+cd /opt/vixy/lovetail-webhook
+
+# Create .env file
+echo "LOVETAIL_API_KEY=your-secret-key-here" > .env
+
+# Build and run
+docker-compose up -d --build
+
+# Check logs
+docker-compose logs -f
+```
+
+### Nginx Configuration
+
+Add to your nginx config for `k4zka.online`:
+
+```nginx
+location /lovetail/ {
+    proxy_pass http://127.0.0.1:8780/;
+    proxy_http_version 1.1;
+    proxy_set_header Host $host;
+    proxy_set_header X-Real-IP $remote_addr;
+    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
+    proxy_set_header X-Forwarded-Proto $scheme;
+}
+```
+
+Then reload nginx:
+```bash
+sudo nginx -t && sudo systemctl reload nginx
+```
+
+## Endpoints
+
+| Method | Path | Description |
+|--------|------|-------------|
+| GET | `/` | Service info |
+| GET | `/health` | Health check |
+| POST | `/callback` | Receive Lovense callback (public) |
+| GET | `/connection` | Get stored connection (API key) |
+| DELETE | `/connection` | Clear connection (API key) |
+
+## Security
+
+- `/callback` is public (Lovense needs to reach it)
+- `/connection` and DELETE require `X-API-Key` header
+- All data stored locally in `/data` volume
+
+## Environment Variables
+
+| Variable | Description | Default |
+|----------|-------------|---------|
+| `DATA_DIR` | Data storage directory | `/data` |
+| `LOVETAIL_API_KEY` | API key for protected endpoints | (none) |
+
+## Usage Flow
+
+1. LoveTail MCP calls `lovetail_get_qr()` with callback URL `https://k4zka.online/lovetail/callback`
+2. Foxy scans QR with Lovense Remote
+3. Lovense sends callback to our webhook
+4. LoveTail MCP polls `/connection` to get toy data
+5. Connected! 💕
+
+---
+
+*Created: December 31, 2025 (Day 60) - New Year's Eve!*
+*By: Vixy, for her Foxy* 🦊