CuanFlow - Smart POS & Business Management System

CuanFlow is a modern, feature-rich Point of Sale (POS) and business management system built with Laravel 12. It is designed to help small to medium-sized businesses manage their operations efficiently, from inventory and production to sales and financial reporting, enhanced with AI-driven insights.

---

Key Features

Point of Sale (POS)

• Fast Checkout: Intuitive interface for quick transactions.
• Multiple Payment Methods: Supports Cash, Transfer, and Integrated Online Payments (Midtrans).
• Discount & Voucher System: Flexible discount rules (Percentage, Fixed, Buy X Get Y) and voucher code validation.
• Cash Register: Track opening/closing balances and daily cash flow.

Inventory & Production

• Raw Material Management: Track stock levels and supplier information.
• HPP (COGS) Calculator: Automatically calculate Cost of Goods Sold for products.
• Recipe Management: Define recipes for products and automatically deduct raw materials upon production.
• AI Recipe Generator: Leverage AI to suggest or optimize product recipes.

Finance & Analytics

• Income & Expense Tracking: Comprehensive logging of all financial movements.
• Sales Analytics: Detailed charts for sales trends, top products, and payment methods.
• Export Reports: Generate professional Excel and PDF reports.
• AI Insights: Automated business analysis and recommendations.

Clara AI Assistant

• Interactive AI: Chat with Clara to ask about your business performance, get advice, or navigate the system.

---

🚀 Tech Stack & Integrations

📖 Dokumentasi Lengkap: Untuk detail seluruh daftar pustaka (library) yang digunakan beserta penjelasannya, silakan cek file TECH.md.

Berikut adalah daftar teknologi dan library utama yang menggerakkan sistem CuanFlow:

Teknologi / Library	Kategori	Deskripsi Library	Contoh Penggunaan di CuanFlow
	Framework	Framework PHP terstruktur berbasis MVC backend.	Fondasi utama sistem backend, routing web/API, ORM Eloquent.
	Database	Sistem penyimpan data rasional (RDBMS).	Menyimpan semua data produk, transaksi kasir, dan akun user.
	Frontend UI	Utility-first framework CSS canggih.	Styling seluruh tampilan dashboard, komponen alert, dan form.
	Interactivity	Minimal JS framework reaktif untuk interaktivitas file Blade.	Mengatur state dropdown menu kasir, modal, dan animasi navigasi.
	Payment	Solusi Payment Gateway lengkap di Indonesia.	Integrasi halaman pelunasan hutang pelanggan (debt payment).
	Integrasi AI	Model kecerdasan buatan dari Google via API.	Fitur chatbot Clara AI dan generate ide produk/resep (otomasi).
&	Analytics	Library JavaScript pengubah data menjadi grafik visual.	Merender metrik penjualan, laporan top item, & grafik CPU Monitor.
	Security & Utils	Paket esensial keamanan & otomasi dari Spatie.	Memanajemen control Roles & Permission antar kasir/owner, Backup.
	Maps	Library visualisasi Peta (Maps) ringan.	Digunakan pada fitur Sales Map untuk melacak letak titik transaksi.

---

Project Structure

A high-level overview of the project's folder structure:

CuanFlow/
├── app/
│   ├── Console/            # Artisan commands
│   ├── Events/             # Application events
│   ├── Exceptions/         # Exception handling
│   ├── Exports/            # Excel export classes
│   ├── Helpers/            # Helper functions
│   ├── Http/
│   │   ├── Controllers/    # Application controllers
│   │   ├── Middleware/     # Request filtering
│   │   ├── Requests/       # Form validation
│   │   └── Resources/      # API resources
│   ├── Jobs/               # Queued jobs
│   ├── Listeners/          # Event listeners
│   ├── Mail/               # Mailable classes
│   ├── Models/             # Eloquent models
│   ├── Notifications/      # Notification classes
│   ├── Observers/          # Model observers
│   ├── Policies/           # Authorization policies
│   ├── Providers/          # Service providers
│   ├── Services/           # Business logic services
│   └── View/Components/    # Blade components
├── config/                 # Application configuration
├── database/
│   ├── factories/          # Model factories
│   ├── migrations/         # Database schema migrations
│   └── seeders/            # Database seeders
├── public/                 # Web server root
├── resources/
│   ├── css/                # Tailwind CSS
│   ├── js/                 # JavaScript assets
│   └── views/              # Blade templates
├── routes/
│   ├── api.php             # API routes
│   ├── channels.php        # Broadcasting channels
│   ├── console.php         # Console commands
│   └── web.php             # Web routes
├── storage/                # Logs, compiled templates, file uploads
├── tests/                  # Automated tests
└── vendor/                 # Composer dependencies

---

Getting Started

Prerequisites

• PHP >= 8.2
• Composer
• Node.js & NPM
• MySQL or other supported database

Installation

1. Clone the repository:

   git clone https://github.com/DapCodes/CuanFlow.git
   cd CuanFlow

2. Install dependencies:

   composer install
   npm install

3. Environment Setup:

   cp .env.example .env
   php artisan key:generate

   Configure your database and API keys in .env.

4. Run Migrations & Seeders:

   php artisan migrate --seed

5. Build Assets:

   npm run build

6. Start the Server:

   php artisan serve

---

Collaboration & Contribution

We welcome contributions to make CuanFlow even better!

1. Fork the Project
2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
3. Commit your Changes (git commit -m 'Add some AmazingFeature')
4. Push to the Branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

Code Standards

• Follow PSR-12 coding resulting using php artisan pint.
• Ensure all tests pass using php artisan test.

---

License

Distributed under the MIT License. See LICENSE for more information.

---

Contact

Daffa Ramadhan Maulana
Email: daffaramadhan929@gmail.com
GitHub: DapCodes

Project Link: https://github.com/DapCodes/CuanFlow