📱 Dingoo Scanners App

📋 About the Project

Dingoo Scanners is a modern Flutter application designed to streamline package and product scanning processes across multiple logistics businesses. The app provides tailored workflows for different business types, from simple scanning to complex parcel management systems.

🏢 Supported Businesses

📊 Excel Export Workflow

• Delta, Continente, and FNAC: Simple scanning process with automatic Excel file generation and email delivery

📦 Parcel Management Workflow

Standard Parcel Indirect Process:

• CTT, VASP, GLS, Paack: Complete workflow including:
• 🔍 Package scanning and matching with existing orders in Back Office
• 📋 Package classification
• 📦 Aggregation

DPD - Enhanced Process:

• Unique DPD Integration: Advanced scanning workflow featuring:
• 📱 Direct API integration with DPD services
• 🔄 Real-time data insertion into Back Office system
• 🤖 AI-Powered Address Recognition: When API data is unavailable, GenAI extracts address information directly from camera captures
• 📋 Same classification and aggregation features as other parcel services

🚀 Installation and Setup

📋 Prerequisites

Ensure you have the following installed before setting up the project:

🔷 Flutter SDK

• Follow the official Flutter installation guide
• Ensure Flutter is added to your system PATH
• Verify installation: flutter doctor

☕ Java Development Kit

• Install the latest OpenJDK or use Android Studio's bundled version
• Verify installation:

  java -version
  

🤖 Android Studio

• Download from developer.android.com/studio
• Install required SDKs and accept licenses:

  flutter doctor --android-licenses
  

⚡ Quick Setup

1. Clone the repository:

git clone <repository-url>
cd dingoo-scanners

1. Install dependencies:

flutter pub get

1. Run the application:

📱 Using VS Code:

• Open "Run and Debug"
• Select your environment: dev, stg, or prod

⌨️ Using Command Line:

flutter run --flavor=<environment>

Replace <environment> with dev, stg, or prod

🌍 Environments

The application supports multiple deployment environments:

• 🔧 Development (dev) - For local development and testing
• 🧪 Staging (stg) - Pre-production testing environment
• 🚀 Production (prod) - Live production environment

� Simplified Build Process

Build the app easily using our custom build script:

dart run tool/build.dart <flavor>

Examples:

# Development build
dart run tool/build.dart dev

# Production build
dart run tool/build.dart prod

📁 Output Location:
build/app/outputs/flutter-apk/app-<flavor>-release.apk

📚 Useful Resources

• 📦 Flutter Packages: pub.dev
• 📖 Flutter Documentation: docs.flutter.dev
• 🔧 Flutter Installation: Installation Guide
• 🤖 Android Studio: developer.android.com/studio