dadaloop82
80303f7900
- Features.md: translate all Italian UI strings to English (chat examples, Avvia cottura → Start Cooking, Spiega → Explain, La quantità è giusta → correct) - Android-Kiosk.md: translate Italian button labels (Concedi permessi → Grant permissions, Rileva automaticamente → Auto-discover); fix REQUEST_INSTALL_PACKAGES description (OTA kiosk self-updates, not scale APK); fix REORDER_TASKS description; add 'Header Overlay Buttons' section documenting the three web overlay buttons (✕ ↻ ⚙️) and the permanent native button hiding - Scale-Gateway.md: translate Italian button labels (Cerca Bilance Bluetooth → Find Bluetooth Scales, Leggi bilancia → Read Scale, Disconnetti/Riconnetti → Disconnect/Reconnect) - FAQ.md: translate all Italian strings (AI non disponibile → AI not available, Bring! non configurato, Leggi bilancia, Carica altri → Load more); replace outdated 'Gateway install fails' section (separate APK no longer exists for kiosk users) with 'Kiosk app update fails'; update ✕ button description to reflect the new 3-button overlay (✕ ↻ ⚙️); restore missing Getting Help section - Home.md: update What's New v1.7.13 with complete list of changes; mark evershelf-scale-gateway/ as DEPRECATED in repo structure
163 lines
5.2 KiB
Markdown
163 lines
5.2 KiB
Markdown
# ❓ FAQ & Troubleshooting
|
|
|
|
---
|
|
|
|
## Installation
|
|
|
|
### The app shows a blank page after setup
|
|
|
|
- Open the browser console (F12 → Console) and check for errors
|
|
- Make sure PHP is running and `api/index.php` is reachable: visit `https://your-server/dispensa/api/index.php?action=get_settings` — it should return JSON
|
|
- Check your web server error log: `tail -f /var/log/apache2/error.log`
|
|
|
|
### Camera doesn't work / barcode scanner won't open
|
|
|
|
Camera access requires **HTTPS**. On plain HTTP, browsers block `getUserMedia()`.
|
|
|
|
- Set up HTTPS with Let's Encrypt, Caddy, or a self-signed certificate
|
|
- On Android, you can also add a security exception in Chrome: `chrome://flags/#allow-insecure-localhost`
|
|
|
|
### "Permission denied" error for the data directory
|
|
|
|
```bash
|
|
chmod 755 data/
|
|
chown -R www-data:www-data data/
|
|
```
|
|
|
|
### Docker container exits immediately
|
|
|
|
```bash
|
|
docker compose logs evershelf
|
|
```
|
|
|
|
Usually a permission issue on the mounted `data/` volume. Try:
|
|
|
|
```bash
|
|
docker compose down
|
|
rm -rf data/
|
|
mkdir data/
|
|
docker compose up -d
|
|
```
|
|
|
|
---
|
|
|
|
## AI Features
|
|
|
|
### "AI not available" error
|
|
|
|
1. Check that `GEMINI_API_KEY` is set in `.env`
|
|
2. Verify the key is valid at [aistudio.google.com](https://aistudio.google.com)
|
|
3. Check that you haven't exceeded the free tier quota (15 req/min, 1500 req/day)
|
|
4. Look for errors in the PHP error log
|
|
|
|
This is usually a Gemini API timeout. The app streams results via SSE — if the server PHP timeout is too low, the stream is cut short. Increase `max_execution_time` in `php.ini`:
|
|
|
|
```ini
|
|
max_execution_time = 120
|
|
```
|
|
|
|
---
|
|
|
|
## Shopping List (Bring!)
|
|
|
|
### "Bring! not configured" message in the shopping tab
|
|
|
|
Add your Bring! credentials to `.env`:
|
|
|
|
```ini
|
|
BRING_EMAIL=your@email.com
|
|
BRING_PASSWORD=yourpassword
|
|
```
|
|
|
|
### Items aren't syncing to Bring!
|
|
|
|
- Verify your credentials are correct by logging into [getbring.com](https://web.getbring.com/)
|
|
- Check for rate-limit errors in the PHP error log — Bring! has API limits
|
|
|
|
---
|
|
|
|
## Scale Integration
|
|
|
|
### Scale readings don't appear in EverShelf
|
|
|
|
1. Confirm the gateway app is running and shows the WebSocket URL
|
|
2. Check the Gateway URL in EverShelf Settings matches exactly
|
|
3. Make sure both the Android device and the EverShelf server are on the same network
|
|
4. Look at the scale status indicator (⚖️) in the header — "disconnected" means no WebSocket connection
|
|
|
|
### Scale shows weight but form doesn't auto-fill
|
|
|
|
- The auto-fill only triggers for products with unit `g` or `ml`
|
|
- Make sure you tapped **"⚖️ Read Scale"** first to activate the scale modal
|
|
- The weight must stabilize (stay within 10g) for the countdown to start
|
|
|
|
### Bluetooth scale not appearing in the gateway app
|
|
|
|
- Wake up the scale (step on it or press its button)
|
|
- Make sure Bluetooth and Location permissions are granted to the gateway app (Location is required by Android for BLE scanning)
|
|
- Restart the gateway app
|
|
|
|
---
|
|
|
|
## Kiosk App
|
|
|
|
### Setup wizard can't find my server
|
|
|
|
- Make sure the tablet is on the same Wi-Fi network as the server
|
|
- Try entering the URL manually instead of using auto-discovery
|
|
- Check that the server responds on the expected port (80/443/8080/8443)
|
|
|
|
### Kiosk app update fails
|
|
|
|
The kiosk checks for a new release every 6 hours and downloads it from GitHub. If the install fails:
|
|
|
|
| Symptom | Fix |
|
|
|---------|-----|
|
|
| "Install from unknown sources" dialog | Enable the setting for the EverShelf Kiosk app in Android Settings |
|
|
| Persistent failure after download | Force-stop the app, clear its data, and relaunch the update flow |
|
|
| Not enough space | Free up storage on the device |
|
|
|
|
### Exit button (✕) is not visible
|
|
|
|
Three buttons are always visible in the kiosk header overlay: **✕** (exit), **↻** (refresh), **⚙️** (settings). If the page failed to load entirely, tap **↻** first. If nothing is visible, restart the device.
|
|
|
|
### App is stuck in kiosk mode after a crash
|
|
|
|
Restart the device. Screen pinning is released on reboot.
|
|
|
|
---
|
|
|
|
## General
|
|
|
|
### The version shown in the app is outdated
|
|
|
|
The version is cached by the browser. Do a hard refresh:
|
|
- Desktop: `Ctrl+Shift+R` / `Cmd+Shift+R`
|
|
- Android: tap the ↻ button (kiosk) or clear site data in Chrome settings
|
|
|
|
### Transactions are missing from the log
|
|
|
|
The log shows the last 50 entries by default. Tap **"Load more"** to load more. Entries older than the database creation date won't appear.
|
|
|
|
### "Can only undo transactions within 24 hours"
|
|
|
|
The undo window is 24 hours. For older operations, manually correct the inventory via the Edit function on the affected product.
|
|
|
|
### Error reports keep creating duplicate GitHub issues
|
|
|
|
EverShelf uses a fingerprint to deduplicate — the same error from the same device won't create a new issue within 24 hours. If you're seeing duplicates, check the `data/rate_limits/` folder and clear old files.
|
|
|
|
---
|
|
|
|
## Getting Help
|
|
|
|
- **Open an issue:** [github.com/dadaloop82/EverShelf/issues](https://github.com/dadaloop82/EverShelf/issues)
|
|
- **Email:** [evershelfproject@gmail.com](mailto:evershelfproject@gmail.com)
|
|
- **Try the demo:** [evershelfproject.dadaloop.it/demo](https://evershelfproject.dadaloop.it/demo)
|
|
|
|
When reporting a bug, include:
|
|
1. EverShelf version (shown in the header as `v1.x.x`)
|
|
2. Browser and OS
|
|
3. Steps to reproduce
|
|
4. Any error messages from the browser console (F12)
|