tfm_ainventory/USER_GUIDE.md

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.