OMS_APP (Order Management System)

A modern, cross-platform Order Management System built with Flutter, designed for businesses to manage orders, couriers, reporting, and more. Developed by Orio Technologies.

---

Table of Contents

• Features
• Screenshots
• Getting Started
• Authentication Setup
• Project Structure
• Assets & Icons
• Contributing
• License

---

Features

• Dashboard: Real-time business metrics, outstanding amounts, and order status summaries.
• Order Management: Create, edit, and track orders with detailed status and shipment info.
• Courier Insights: Analyze courier performance, pending payments, and shipment details.
• Reports: Generate and view ageing reports, COD statements, and more.
• Notifications: Manage and view system notifications.
• User Profile: Manage user information and change password.
• Help Videos: Access help and onboarding videos.
• Multi-platform: Runs on Android, iOS, Web, Windows, MacOS, and Linux.
• Authentication: Secure login with email and password.
• Offline Support: Basic offline UI and connectivity awareness.

---

Screenshots

Add screenshots of the dashboard, order list, and reports here for best results.

---

Getting Started

Prerequisites

• Flutter SDK 3.8.1+
• Android Studio / Xcode / VS Code

Installation

1. Clone the repository:

   git clone <your-repo-url>
   cd oms

2. Install dependencies:

   flutter pub get

3. Run the app:

   flutter run

   For web:

   flutter run -d chrome

Platform Notes

• Android/iOS: Configure your app icons and authentication keys as described below.
• Web: Some features (like file pickers) may have limited support.

---

---

Project Structure

oms/
  ├── lib/
  │   ├── controllers/         # State management (GetX)
  │   ├── models/              # Data models
  │   ├── network/             # API and network services
  │   ├── screens/             # UI screens
  │   ├── services/            # Business logic and integrations
  │   ├── utils/               # Utilities and helpers
  │   ├── widgets/             # Reusable widgets
  │   └── main.dart            # App entry point
  ├── assets/                  # Images, SVGs, icons
  ├── android/                 # Android platform code
  ├── ios/                     # iOS platform code
  ├── web/                     # Web platform code
  ├── macos/                   # MacOS platform code
  ├── windows/                 # Windows platform code
  ├── linux/                   # Linux platform code
  └── pubspec.yaml             # Flutter dependencies and assets

---

Assets & Icons

• All images and SVGs are in the assets/ directory.
• App icons are in assets/icon/.
• To add new assets, place them in the appropriate folder and declare them in pubspec.yaml under flutter.assets.

---

Contributing

1. Fork the repository
2. Create your feature branch (git checkout -b feature/YourFeature)
3. Commit your changes (git commit -am 'Add some feature')
4. Push to the branch (git push origin feature/YourFeature)
5. Create a new Pull Request

---

License

This project is proprietary to Orio Technologies. For licensing or commercial use, please contact the maintainers.

---

Support & Documentation

• Flutter Documentation