django and fastapi apps

ctrl/README.md

@@ -0,0 +1,61 @@
+# MPR Control
+
+Scripts for running and deploying MPR.
+
+## Setup
+
+1. Add to `/etc/hosts`:
+   ```
+   127.0.0.1 mpr.local.ar
+   ```
+
+2. Copy environment template:
+   ```bash
+   cp ctrl/.env.template ctrl/.env
+   ```
+
+3. Start the stack:
+   ```bash
+   ./ctrl/run.sh
+   ```
+
+## URLs
+
+- http://mpr.local.ar/admin - Django Admin
+- http://mpr.local.ar/api/docs - FastAPI Swagger
+- http://mpr.local.ar/ui - Timeline UI
+
+## Commands
+
+```bash
+# Start all services
+./ctrl/run.sh
+
+# Start in detached mode
+./ctrl/run.sh -d
+
+# Rebuild and start
+./ctrl/run.sh --build
+
+# Stop all
+./ctrl/run.sh down
+
+# View logs
+./ctrl/run.sh logs -f
+
+# Deploy to remote (configure SERVER/REMOTE_PATH in .env)
+./ctrl/deploy.sh
+./ctrl/deploy.sh --restart
+./ctrl/deploy.sh --dry-run
+```
+
+## Ports
+
+| Service    | Internal | External |
+|------------|----------|----------|
+| nginx      | 80       | 80       |
+| Django     | 8701     | 8701     |
+| FastAPI    | 8702     | 8702     |
+| Timeline   | 5173     | 5173     |
+| PostgreSQL | 5432     | 5433     |
+| Redis      | 6379     | 6380     |