Inventory

Inventory is an Android application designed for inventory management and seamless integration with the Redmine project management system.

It simplifies working with inventory items by combining task management, QR code support, image management, checklists, and label printing in a single mobile application.

---

Features

📋 Task Management

• Browse Redmine tasks
• Open tasks by entering the task ID
• Open tasks by scanning QR codes
• Filter tasks by project and tracker
• View all task information in JSON format

---

📝 Task Information

• Display only selected custom fields (configurable)
• View complete task information
• Update object location directly from the application
• Highlight tasks with missing required fields
• Automatic warning dialog when opening incomplete tasks

---

📷 Image Management

• View image gallery attached to a task
• Upload images from the device gallery
• Take a photo and upload it directly to Redmine
• Edit image name
• Edit image description/comments

---

✅ Checklists

• Full checklist support
• Checklist state synchronized with the Redmine server
• Update checklist items directly from the application

---

🏷 QR Code & Label Printing

• Generate QR codes containing a link to the Redmine task
• Edit generated labels
• Print labels using NIIMBOT Bluetooth label printers

---

⚠ Required Fields Validation

The application allows configuring required custom fields.

If one or more required fields are missing:

• the task card is highlighted in red
• a dialog displays which fields must be completed when the task is opened

---

🌍 Localization

Supported languages:

• English
• Russian

---

🎨 Themes

• Light Theme
• Dark Theme

---

Initial Setup

Before using the application for the first time:

1. Open the Connection Settings on the login screen.
2. Enter your Redmine server URL.
3. Enter your Redmine API Token.
4. Save the settings.

Copy Settings

The application can generate a settings configuration that can be shared with other devices.

Note: The API Token is never included in exported settings for security reasons.

---

Technologies

• Kotlin
• Android Jetpack
• MVVM Architecture
• CameraX
• ML Kit Barcode Scanner
• Retrofit
• LiveData
• Navigation Component
• Material Design
• NIIMBOT Printer SDK

---

Requirements

• Android 8.0 (API 26) or newer
• Redmine server with API access enabled

---

License

This project is licensed under the MIT License.

See the LICENSE file for details.

---

Demo

A demonstration GIF of the application will be available here.