Life Sales and Inventory Management System

0. Installing the Web Application

Before you can log in and use the system, install it on your server or computer by following these steps:

1. Access Your Hosting Panel:
   • Log in to your hosting provider’s hPanel.
   • 
2. Extract the Downloaded File:
   • Extract the zip file to see the two folders.
   • Upload the contents of the Web Application folder to your hosting panel.
   • 
3. Create a New Database:
   • Create a new database in your hPanel and note the username, password, and database name.
   • 
4. Begin the Installation:
   • Open your browser and visit your domain followed by /install (e.g., http://yourbusiness.com/install).
   • Click Next on the installation page.
   • 
5. System Requirements Check:
   • The installer will display the system requirements page.
   • 
6. Enable PHP Extensions:
   • In your hPanel, go to PHP configuration under the Advanced section.
   • Enable the required PHP Extensions and remove symlink from the Disable Functions list.
   • 
7. Database Configuration:
   • Enter your database details (username, password, database name) with host set to localhost.
   • 
8. Admin Configuration:
   • Enter the admin details (name, email, password) on the next page.
   • 
9. Complete Installation:
   • Click Next to finish the installation. A success message will confirm completion.
   • 
10. Access Your Site and Admin Panel:
    • Visit your site’s frontend and access the admin panel at /admin/login (e.g., http://yourbusiness.com/admin/login).
    • 

1. How to Log In

Follow these steps to log in to the admin panel:

1. Open your browser and navigate to http://yourbusiness.com/admin/login.
2. Enter the default credentials:
   • Email: admin@example.com
   • Password: 12345678
3. Click Login and then update your password immediately.

2. Exploring the Dashboard

The dashboard gives you a snapshot of your business. It displays:

• Total Salesmen, Vehicles, Routes, Stores, Products, Orders, and Stock Items
• Graphs and Charts showing sales trends and product performance
• A list of Low Stock Products

Detailed Graphs and Tables

1. Totals Overview: Displays boxes with counts of salesmen, vehicles, routes, stores, products, orders, and stock items.
2. Graphs and Charts:
   • Sales Overview Graph: Line or bar chart showing total sales over time.
   • Sales by Salesman Graph: Chart comparing sales figures per salesman.
   • Top-Selling Products Graph: Bar or pie chart illustrating which products sell the most.
   • Sales by Route Graph: Chart showing which routes generate the most sales.
   • Revenue Over Time Graph: Line graph tracking revenue trends over time.
   • Damaged Order Items Over Time: Graph indicating the number of broken items returned over time.
3. Low Stock Products Table: A table listing products with low stock in vehicles.
4. Click on any graph or table item for more detailed reports.

3. Setting Up Your Business Details

Configure your business information in General Settings:

1. Click Settings from the sidebar and select General Settings.
2. Fill in details such as Company Name, Email, Address, Phone, Country, Currency, and Tax System.
3. Click Update Settings to save your changes.

4. Updating Your Profile

Secure your account by updating your personal details:

1. Click Settings in the sidebar, then select Profile Settings.
2. Update your Profile Picture, Name, Email, and set a new password.
3. Click Update Profile to apply the changes.

6. Adding Vehicles

Vehicles represent the cars or vans used by your salesmen. To add a vehicle:

1. Click Vehicles in the sidebar.
2. Click the Add New Vehicle button.
3. Enter the Vehicle Number (e.g., “XYZ-789”).
4. Click Add Vehicle and confirm the message.
5. To edit or delete a vehicle, use the options in the vehicle list.

7. Setting Up Routes

Routes determine the paths your salesmen take. To add a route:

1. Click Routes from the sidebar.
2. Click Add New Route.
3. Enter a Route Name (e.g., “Downtown Route”) and an optional description.
4. Click Add Route to confirm.

8. Adding Salesmen

Add salesmen who will use the mobile app to sell your products:

1. Click Salesman in the sidebar.
2. Click Add New Salesman.
3. Fill in their details (Name, Email, Phone, Password, Vehicle, and Route).
4. Click Add Salesman to save their information.
5. Share their login credentials so they can access the mobile app.

9. Adding Stores

Stores represent the customers or shops visited by your salesmen. To add a store:

1. Click Stores in the sidebar.
2. Click Add New Store.
3. Fill in the store’s Name, assign a Route, and enter its full Address.
4. Click Add Store to confirm.

10. Adding Products

Products are what you sell. The product form will change based on your chosen tax system:

1. Click Products in the sidebar.
2. Click Add New Product.
3. Fill in the details:
   • If VAT: Product Name, Base Price, VAT%
   • If GST: Product Name, HSN/SAC Code, Base Price, SGST%, CGST%, Cess%
   • If Sales Tax: Product Name, Base Price, Sales Tax%
4. The system will calculate the final price automatically.
5. Click Add Product to save it.

11. Giving Stock to Vehicles

Assign stock to vehicles so salesmen have products to sell:

1. Click Stock in the sidebar.
2. Click Add New Stock.
3. Select a Vehicle and then a Product, and specify the quantity.
4. If needed, click Add Product to assign additional products to the same vehicle.
5. Click Save to confirm.

12. Making a Stock Bill

A stock bill lists the products in a vehicle. To generate one:

1. After adding stock, click Generate Stock Bill.
2. You’ll be taken to a page displaying the generated bills.
3. Each bill shows details like Invoice Number, Vehicle Number, and Date Generated.
4. Next to each bill, you can view, download, or regenerate it.

13. Checking Orders

Orders are generated when salesmen sell products. To check orders:

1. Click Orders from the sidebar.
2. Each order shows details like Store Name, Salesman Name, Vehicle Number, and payment breakdown.
3. Use the search boxes to filter orders by salesman, store, or vehicle.

14. Tracking Money Owed (Dues)

This section shows which stores owe money:

1. Click Dues in the sidebar.
2. Each entry displays the Store Name, Total Due Amount, Latest Advance, Salesman Name, and Status.
3. Click View Details to see full order details for that store.

15. Looking at Reports

Reports help you monitor business performance. To view reports:

1. Click Reports in the sidebar.
2. Choose a report type (Sales, Orders, Stock, or Damaged Products Report).
3. Use the export buttons to save reports as PDF or Excel files.

16. Setting Up SMTP

Configure SMTP to enable automated emails such as invoices and notifications:

1. Access SMTP Settings:
   • Click SMTP Settings in the sidebar (under the Settings menu).
2. Enter SMTP Details:
   • Mail Driver: smtp
   • SMTP Host: e.g., smtp.yourbusiness.com
   • SMTP Port: e.g., 587 for TLS or 465 for SSL
   • Username and Password: Your email credentials
   • Encryption: TLS or SSL
3. Save SMTP Settings:
   • Click Save Settings and confirm the success message.

17. Setting Up Timezone

After installing your application, go to the public/config/app.php file. Locate the timezone setting, which by default is set to:

Change it to your local timezone. For example, if you are based in India, update it as follows:

1. Getting the App Ready

Set up the mobile app by following these steps:

1. Extract the Downloaded File:
   • Download the installable zip file from CodeCanyon and extract it.
   • You will see two folders: Web Application (for your admin dashboard) and Flutter App (the mobile app source code).
   • Open the Flutter App folder in your IDE (e.g., Visual Studio Code).
2. Update the Website Address:
   • Open the file lib/services/app_config.dart.
   • Locate the baseUrl variable and change it to your web application’s URL, for example:
     class ApiConfig {
       static const String baseUrl = 'http://yourbusiness.com';
     }
   • Save the file.
3. Make the App File (APK):
   • In the terminal, run flutter pub get and then flutter build apk.
   • After the build completes, locate the APK file in build/app/outputs/flutter-apk (e.g., app-release.apk).
4. Put the App on Phones:
   • Transfer the APK file to the salesman’s Android device via USB or email.
   • On the phone, open the file and follow the prompts to install the app.

2. Setting Up App Icon and App Name

Customize your mobile app’s appearance:

1. Update App Icon:
   • Open pubspec.yaml and add the flutter_launcher_icons package as a dev dependency.
   • Add the configuration for your icon image. For example:
     dev_dependencies:
       flutter_launcher_icons: ^0.9.2
     
     flutter_icons:
       android: true
       iOS: false
       image_path: "assets/icon/app_icon.png"
2. Run flutter pub get and then flutter pub run flutter_launcher_icons:main to generate new icons.
3. Update App Name:
   • Edit android/app/src/main/AndroidManifest.xml and modify the android:label attribute in the <application> tag to your desired name (e.g., "My Business App").

3. How Salesmen Use the App

Once installed, the app is used by salesmen as follows:

1. Logging In:
   • Open the “Life” app on your phone.
   • Enter your assigned email and password.
   • Tap Login to access your dashboard.
   • 
2. Main Screen (Dashboard):
   • View your name, phone number, assigned vehicle, and current stock.
   • 
3. Transactions & Stock Bill:
   • Tap the hamburger menu (three lines in the top-left corner) to open the menu.
   • Access Transactions (today’s sales) and Stock Bill (products in your vehicle).
   • 
4. Picking a Store:
   • Use the search bar on the main screen to find the store and select it.
   • View store details such as address and outstanding balance.
   • Enter sold product quantities and any returned (damaged) items.
   • Tap Proceed to Billing to generate the bill.
   • 
5. Making the Bill:
   • Review the bill details including products, total amount (with taxes), discounts, previous due, and cash received.
   • Tap Confirm Payment and confirm the prompt.
   • 
6. Printing the Bill:
   • Ensure your Bluetooth printer is turned on, connected, and loaded with paper.
   • Tap the printer icon or “Select Printer” and choose your printer.
   • Tap Print Bill to print the final bill.
   • 
   •