# TFM aInventory - User Guide

Welcome to **TFM aInventory**, the unified inventory management system.

---

## 📱 Installing on Mobile (PWA)
1. Open the application URL in your mobile browser (Safari for iOS, Chrome for Android).
2. Tap the **Share** button (iOS) or the **Menu** dots (Android).
3. Select **"Add to Home Screen"**.

## 🔐 Authentication
- **LDAP/Enterprise Login**: Use your company account. The app securely caches credentials for offline use.
- **Local Login**: Standard username/password provided by your admin.
- **Offline Access**: You can log in even without signal if you have logged in on that device at least once before.

## 🔍 Core Workflows
### Adding Items (AI Wizard)
1. Tap the **Camera/Plus** button.
2. Capture a photo of the item's label.
3. The AI will automatically extract Name, PN, and Category.
4. Review, adjust the quantity, and **Save**.

### Scanning Barcodes
1. Open the **Scanner** tab.
2. Point the camera at a barcode or QR code.
3. If the item exists, its details will appear instantly for stock adjustment.

### Stock Adjustment
- Use the **+/-** buttons for quick changes.
- Tap the quantity number to type a specific value.

## ☁️ Offline Sync
- Work anywhere, including basements or remote sites.
- Changes are saved locally and synced automatically when signal returns.
- Check the **Sync** status in the Bottom Navigation bar.

## 🛠 Admin Tasks
Administrators can access the **Admin Overlay** to:
- Manage Users and Categories.
- Configure AI Providers (Gemini/Claude).
- Perform Database Backups and Restore.
- View detailed Audit Logs of all actions.

---
*Refer to DEPLOYMENT.md for server setup instructions.*