# Quick Start - Web Application

Get up and running with the InvenTree Stock Tool web interface in 5 minutes!

## Step 1: Install

```bash
cd stocktool
uv sync
```

## Step 2: Run

```bash
uv run stock-tool-web
```

You should see:
```
✅ Connected to InvenTree: https://your-server.com
🚀 Starting InvenTree Stock Tool Web Server...
📱 Open your browser to: http://localhost:5000
Press Ctrl+C to stop
```

## Step 3: Open Browser

Navigate to: **http://localhost:5000**

## Step 4: Start Using

### Quick Workflow:

1. **Select Location**
   - Scan location barcode (e.g., `INV-SL123`)
   - OR select from dropdown

2. **Choose Mode**
   - Click "Add Stock", "Update Stock", "Check Stock", or "Locate Part"

3. **Scan Parts**
   - Click in scan field
   - Scan barcode or type part code
   - Press Enter

### Unknown Parts:

When you scan a part that doesn't exist:
- ✅ It's automatically added to "Pending Imports"
- ✅ Import runs in background
- ✅ You can keep scanning other parts!
- ✅ Part is processed automatically when ready

## Barcode Commands

Scan these to control the app:

- `MODE:ADD` → Add Stock mode
- `MODE:CHECK` → Check Stock mode
- `LOCATE` → Locate Part mode
- `CHANGE_LOCATION` → Clear location

## Access from Phone/Tablet

1. Find your computer's IP:
   ```bash
   # Windows
   ipconfig

   # Linux/Mac
   hostname -I
   ```

2. On your device, open browser to:
   ```
   http://YOUR_IP:5000
   ```

Example: `http://192.168.1.100:5000`

## Troubleshooting

### Can't connect?
- Check firewall allows port 5000
- Make sure server is running
- Try http://127.0.0.1:5000

### Import not working?
- Ensure `inventree-part-import` is installed
- Check your InvenTree API token has permissions

### WebSocket issues?
- Clear browser cache
- Try different browser
- Check browser console for errors (F12)

## What's Next?

- Read full docs: [WEB_APP.md](WEB_APP.md)
- Desktop version: `uv run stock-tool`
- Report issues: https://github.com/your-repo/issues

---

**That's it! You're ready to scan! 📱✨**