migration to web

README.md

@@ -64,7 +64,23 @@ This creates the SQLite database at `data/punimtag.db` (default). For PostgreSQL
 
 ### Running the Application
 
-**Terminal 1 - Backend API:**
+**Prerequisites:**
+- Redis must be running (for background jobs)
+  ```bash
+  # Check if Redis is running
+  redis-cli ping
+  # If not running, start Redis:
+  # On Linux: sudo systemctl start redis
+  # On macOS with Homebrew: brew services start redis
+  # Or run directly: redis-server
+  ```
+
+**Terminal 1 - Redis (if not running as service):**
+```bash
+redis-server
+```
+
+**Terminal 2 - Backend API:**
 ```bash
 cd /home/ladmin/Code/punimtag
 source venv/bin/activate
@@ -72,7 +88,15 @@ export PYTHONPATH=/home/ladmin/Code/punimtag
 uvicorn src.web.app:app --host 127.0.0.1 --port 8000
 ```
 
-**Terminal 2 - Frontend:**
+**Terminal 3 - RQ Worker (required for photo import):**
+```bash
+cd /home/ladmin/Code/punimtag
+source venv/bin/activate
+export PYTHONPATH=/home/ladmin/Code/punimtag
+python -m src.web.worker
+```
+
+**Terminal 4 - Frontend:**
 ```bash
 cd /home/ladmin/Code/punimtag/frontend
 npm run dev
@@ -84,6 +108,8 @@ Then open your browser to **http://localhost:3000**
 - Username: `admin`
 - Password: `admin`
 
+**Note:** The RQ worker (Terminal 3) is required for background photo import jobs. Without it, jobs will remain in "Pending" status.
+
 ---
 
 ## 📖 Documentation