lakasir / lakasir_flutter

Mobile app for Lakasir

Lakasir Web App

Lakasir is a Point of Sale (POS) application built using Laravel for the API, the Filament admin panel for the web application, and Flutter for the mobile application.

Requirements

• php 8.1
• mysql 5.7 or higher
• php-ext.* base on laravel extenstion requirement

Features

• Role Management: Define roles and permissions for users.
• Transaction Management: Handle sales transactions seamlessly.
• Product Management: Manage your inventory and products effectively.
• Simple Reporting: Generate reports for insights into sales and performance.
• Simple Accounting: Basic accounting features for financial tracking.
• Unit Price: The product will have a different price base on the basic unit
• Friend Price: You can sell the product with a lower price or the highest price

Technologies Used

• Backend: Laravel
• Frontend (Web): Filament Admin Panel
• Frontend (Mobile): Flutter

Installation

1. Clone the repository: git clone https://github.com/lakasir/lakasir.git
2. Navigate to the project directory: cd lakasir
3. Install dependencies:
4. Laravel:
   • composer install
   • cp .env.example .env
   • edit the env based on your local configuration
   • php artisan migrate --path=database/migrations/tenant --seed
5. Create the user using php artisan app:create-user

Usage

• api: localdomain.test/api/test
• webapp: localdomain.test/member/login

Contributing

We welcome contributions from the community! If you'd like to contribute to Lakasir, please follow these steps:

1. keep on eye on project board
2. Fork the repository.
3. Create a new branch (git checkout -b feature/new-feature).
4. Make your changes and commit them (git commit -am 'Add new feature').
5. Push to the branch (git push origin feature/new-feature).
6. Create a new Pull Request.

When contributing to this project, please keep an eye on our project features board on GitHub to stay updated with ongoing and planned features.

License

This project is licensed under the GPL-3.0 license - see the LICENSE file for details.

Contact

For any inquiries or support, please contact [email protected] or you can open discussion in discussion features

lakasir_flutter's Issues

Add note for cart list in flutter

We need to add input to handle note in cart list screen, use textarea

Add upgrader notification

Add option to print the transaction (Flutter)

In the last step for transaction payment, we need to add the button for the user if the user wants to print the receipt or not, but we should add the logic in the button against the user's setting if the user didn't set the printer. We do not show the printer

add screen for notifications

Issues

We need to send the notification to Flutter using push notification when the stock runs out,
and the user can set the minimum stock for their notification, so we need to add a new parameter setting minimum_stock_nofication. This parameter has a default value of 0, so when the user doesn't set the setting, the notification will trigger when the stock is 0.

What we will do

• add setting notification page and the page will contain:
  • form for handling minimum_stock_nofication
• add new screen for notification page and the page will contain:
  • list of notifications: header/title, body/subtitle, actions
• please add color to product stock when the stock runs out
• integrate the notification with backend
  • register the fcm_token in /register-fcm-token
  • show the notification in page notification
  • add permission for update the set limit notification in setting
  • can update the stock limit in settting

Handle printer (Flutter)

On setting page we need add menu to manage the printer, inside the setting menu we need form:

1. Dropdown menu: (RJ45, Bluetooth, USB "if any printer support this feature")

Bluetooth Section:

1. Bluetooth devices list
2. Name of the printer (free text)
3. Bluetooth address
4. Toggle button for connect/disconnect
5. Status
6. Test button

RJ45 Section:
Coming soon

USB Section:
Coming soon

Update readme in flutter app

We need to add:

• Overview
• Instalation guide
• Contributor guid
• Code of conduct