SalesPro

SalesPro is an Android application designed specifically for shop sales representatives to streamline their order-taking processes. The application provides a robust platform for sales reps to add new customers, browse product catalogs, place orders, and monitor order statuses. By offering a user-centric interface, the app enhances the productivity and efficiency of sales representatives, ensuring seamless sales operations and improved customer satisfaction.

Table of Contents

• Project Overview
• Purpose and Objectives
• Scope of the Project
• Development Tools and Technologies
• Code Structure
• Key Features
• Getting Started

Project Overview

SalesPro aims to simplify and automate the daily tasks of sales representatives, reducing manual effort and minimizing errors in order management.

Purpose and Objectives

The primary purpose of the SalesPro project is to create a tool that simplifies and automates the daily tasks of sales representatives. The key objectives of the project are:

• Develop a secure and user-friendly application for sales reps.
• Enable efficient customer management by allowing the addition and retrieval of detailed customer profiles.
• Provide a comprehensive product catalog with search and filter capabilities.
• Facilitate order management, including order creation, tracking, and history access.
• Offer real-time inventory updates and notifications for low or out-of-stock items.
• Generate detailed sales reports and analytics for performance monitoring.
• Implement instant notifications for order updates and promotional offers.
• Provide support and feedback mechanisms within the app.

Scope of the Project

The project focuses on developing the SalesPro application with the aforementioned features, aiming to enhance the productivity of sales representatives.

Development Tools and Technologies

• Development Environment: Android Studio
• Programming Languages: Java, Kotlin
• Libraries and Frameworks:
  • AndroidX libraries for core functionality
  • Firebase services for authentication, database, and messaging
  • Material Components for UI design
  • SmoothBottomBar for bottom navigation
  • Glide for image loading and caching
  • Dagger Hilt for dependency injection
• Version Control:
  • Git for source code management and version control
  • GitHub for repository hosting, issue tracking, and project management
• Notification Services:
  • Dialog E-SMS for notifications

Code Structure

• app/src/main/java/com/salespro/: Main application source files
  • activities/: Activity classes
  • fragments/: Fragment classes
  • models/: Data models
  • adapters/: RecyclerView adapters
  • utils/: Utility classes
  • di/: Dependency injection classes
• app/src/main/res/: Resource files
  • layout/: XML layout files
  • values/: XML files for strings, colors, dimensions, styles, etc.
  • drawable/: Image and shape files

Key Features

• Customer Management: Add, view, and edit customer profiles.
• Product Catalog: Browse, search, and filter products.
• Order Management: Create new orders, track order status, and view order history.
• Inventory Updates: Real-time inventory updates and notifications for low or out-of-stock items.
• Notifications: Order updates and promotional offers using Dialog E-SMS.
• Sales Reports and Analytics: Generate detailed sales reports and performance analytics.
• Support and Feedback: Provide support and feedback mechanisms within the app.

Getting Started

Prerequisites

• Android Studio
• Java JDK
• Kotlin

Installation

1. Clone the repository:

   git clone https://github.com/supunsathsara/salespro.git

2. Open the project in Android Studio.
3. Build the project to install the required dependencies.

Running the Application

• Connect an Android device or use an emulator.
• Click on the "Run" button in Android Studio.

Contributing

Contributions are welcome! Please fork the repository and create a pull request with your changes.

Steps to Contribute

1. Fork the repository
2. Create your feature branch:

   git checkout -b feature/your-feature-name

3. Commit your changes:

   git commit -m 'Add some feature'

4. Push to the branch:

   git push origin feature/your-feature-name

5. Open a pull request

License

This project is licensed under the MIT License - see the LICENSE file for details.

Feel free to contribute to the project by creating issues and pull requests. For any queries, please contact the project maintainers.

Maintainers:

• Supun Sathsara
• Madubashini Gamage
• Ilham

• Shawindu Madushan

  
  Contibutors: