6.0 KiB
TFM aInventory - User Guide
Welcome to TFM aInventory, the unified inventory management system. This guide explains how to use the application for managing your inventory.
📱 Installing on Mobile (PWA)
The application is a Progressive Web App, which means you don't need to download it from the App Store or Google Play.
- Open the application URL in your browser (e.g., Safari on iOS or Chrome on Android).
- Tap the Share button (iOS) or the three dots menu (Android).
- Select "Add to Home Screen".
- The application will now appear as an icon on your home screen and run in immersive mode (without browser chrome).
🔐 Authentication
- Default User: On first installation, use
Admin/<initial-password>(check your system administrator for the initial password). - Change Password: We recommend changing your password immediately from the Admin settings.
- LDAP/Enterprise Login: If your administrator has configured LDAP integration, you can log in with your company/domain account. The application will cache your password locally to allow offline access (e.g., in areas without signal like basements).
- JWT Tokens: Your login session is secured with JWT bearer tokens that expire after 8 hours. You will be automatically logged out when your token expires.
🔍 Scanning and Adding Items
The application supports two scanning modes:
Manual / Barcode Scanning
Scan an existing barcode to locate or update an item in your inventory.
If no readable text is found, the scanner silently retries on the next cycle.
Box & Container Scanning (NEW v1.5.0)
You can now scan a generic label on a box (e.g., "SFP Box 1") to identify all its contents at once.
- If the box contains one type of item, the application takes you directly to the stock adjustment screen.
- If the box contains multiple items, a list will appear for you to select which specific item you are withdrawing or adding.
- This feature works locally and offline - no AI costs for scanning boxes.
🏷️ Label Printing
Administrators and users can generate physical labels for boxes to ensure 100% accurate scanning.
- Tap the Package (Box) icon in the header to open the Box Inventory.
- Find the box you want to label and tap Print Label.
- Desktop: Use the print dialog to send the label directly to a Dymo/Brother thermal printer.
- Mobile: Use "Save for Mobile App" to download a PNG image of the label, which you can then print using your Bluetooth printer's app (like NIIMBOT).
📂 Inventory Organization
The inventory is organized in a hierarchical structure:
- Categories: Broad groupings (e.g., Connectors, Spare Parts, Tools, Consumables).
- Items: Individual products within categories, identified by barcode.
- Item Properties: Name, part number, color, technical specifications, and quantity.
📶 Offline Operation
The application is designed to work even when you don't have internet connectivity in your warehouse or field location:
- Offline Data: All item data, categories, and your pending operations are stored locally on your device using IndexedDB.
- Automatic Sync: When you return to an area with internet connectivity, pending check-ins, check-outs, and other operations are automatically synchronized with the server.
- UUID Tracking: Each offline operation is tagged with a unique ID to prevent duplicates during synchronization.
📜 Activity Log (Audit Trail)
All actions (additions, modifications, deletions) are recorded in real-time with your user ID and timestamp. You can review the activity history in the Logs section to see:
- Who performed the action
- What action was performed (Check-in, Check-out, Item creation, etc.)
- When the action occurred
- The item affected and quantity changed
⚙️ Admin Functions
User Management
Administrators can:
- View all system users
- Create new users (local or LDAP-integrated)
- Modify user roles (admin or standard user)
- Delete users (except the default Admin account)
LDAP Configuration
If your organization uses LDAP/Active Directory, administrators can:
- Configure LDAP server connection details
- Set up role mapping (group membership → admin/user roles)
- Test LDAP connectivity
Settings
Access application settings from the Admin panel.
🚨 Security Notices
- Do not share your login credentials with other users. Each user should have their own account.
- Logout when done: Always log out when finished to protect your account.
- Report suspicious activity: If you notice unauthorized changes in the audit log, contact your system administrator immediately.
- API Security: The application uses JWT (JSON Web Tokens) for API authentication. Tokens are valid for 8 hours.
❓ Troubleshooting
"Insufficient Stock" Error
You attempted to check out more items than are currently in inventory. Check the current stock level and try again with a valid quantity.
Offline Mode Not Syncing
Ensure you have internet connectivity and wait a moment. Synchronization happens automatically when the connection is re-established. You can manually refresh the page to trigger an immediate sync.
Login Failed
- Verify your username and password are correct.
- If using LDAP, ensure your domain credentials are correct and the server is reachable.
- Check with your system administrator if you cannot reset your password.
AI Label Extraction Not Working
- Ensure adequate lighting when photographing the label.
- The label image must be clear and not blurry.
- The image size must not exceed 10 MB.
- The application supports JPEG, PNG, WebP, and GIF formats.
- If the AI service is unavailable, try again later or contact your administrator.
📞 Technical Support
For technical assistance, contact your system administrator or email: support@example.com
For detailed technical documentation, see the Project Architecture guide.
Version: v1.5.0 Last Updated: 2026-04-12