PHPackages khalid-r/kasir-smart-api - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [API Development](/categories/api) 4. / 5. khalid-r/kasir-smart-api ActiveLibrary[API Development](/categories/api) khalid-r/kasir-smart-api ======================== AI-Powered Smart API for Kasir Percetakan - enables intelligent product search, AI chatbot integration, and smart price calculation for any Laravel-based Kasir Percetakan project. v1.2.2(2w ago)013↓100%MITPHPPHP ^8.1 Since May 22Pushed 2w agoCompare [ Source](https://github.com/muhammadkhalidr/kasir-smart-api)[ Packagist](https://packagist.org/packages/khalid-r/kasir-smart-api)[ RSS](/packages/khalid-r-kasir-smart-api/feed)WikiDiscussions main Synced 1w ago READMEChangelogDependencies (4)Versions (4)Used By (0) Kasir Smart API - AI Powered Pos Recommendation Engine ====================================================== [](#kasir-smart-api---ai-powered-pos-recommendation-engine) [![Latest Version](https://camo.githubusercontent.com/43dd5b5446ef6ed4dc036844949d372af5f3e6c34364cf000f595251d4baa153/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f6b68616c69642d722f6b617369722d736d6172742d6170692e737667)](https://camo.githubusercontent.com/43dd5b5446ef6ed4dc036844949d372af5f3e6c34364cf000f595251d4baa153/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f6b68616c69642d722f6b617369722d736d6172742d6170692e737667) [![Total Downloads](https://camo.githubusercontent.com/e657985e0a06e4b0cbf445b027ad2d23abcd099e404b95d75f75cac424d63824/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f6b68616c69642d722f6b617369722d736d6172742d6170692e737667)](https://camo.githubusercontent.com/e657985e0a06e4b0cbf445b027ad2d23abcd099e404b95d75f75cac424d63824/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f6b68616c69642d722f6b617369722d736d6172742d6170692e737667) [![License](https://camo.githubusercontent.com/c4d431fa410b43c7a6d6c578525ca76448fae46f5d45da96163cf25191928ecb/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f6c2f6b68616c69642d722f6b617369722d736d6172742d6170692e737667)](https://camo.githubusercontent.com/c4d431fa410b43c7a6d6c578525ca76448fae46f5d45da96163cf25191928ecb/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f6c2f6b68616c69642d722f6b617369722d736d6172742d6170692e737667) Kasir Smart API adalah package Laravel yang dirancang khusus untuk Sistem POS Kasir Percetakan. Module ini bertindak sebagai otak "Pencarian Cerdas" dan "AI Recommendation Engine" dari Chat Aggregator untuk berinteraksi dengan pelanggan secara otomatis, natural, akurat, dan toleran terhadap *typo* (kesalahan cetak pelanggan). Fitur Unggulan -------------- [](#fitur-unggulan) - **🧠 AI Recommendation Engine**: API Endpoint `/api/v1/ai/recommend` khusus untuk Chatbots/Aggregator. Cukup kirim pesan mentah pelanggan dan package ini langsung mengekstrak: - Niat pelanggan (kategori produk) - Kalkulasi luas area dan ukuran ($panjang \\times lebar \\times harga$). - Rekomendasi produk terakurat dan spesifik (Mencegah *cross-category mix-up*, seperti mencegah produk albatros masuk ke hasil spanduk). - Teks instruksi format matang untuk di konsumsi Model LLM (seperti Gemini atau Groq API). - **🔎 Fuzzy & Typo-Tolerant Product Search**: Pencarian cerdas khusus produk percetakan. Normalisasi kueri, deteksi jenis (banner vs xbener), dan scoring tinggi untuk produk prioritas. - **🛡️ Built-in Security**: API Authentication dengan token kustom (`X-API-Key`) dan sistem Rate Limiting bawaan. - **📊 Logging System**: Middleware logging lengkap untuk merekam perilaku pencarian yang dilakukan AI, demi evaluasi di masa depan. - **🏗️ Model-Agnostic & Zero Configuration**: Dirancang untuk dapat plug-and-play di *independent project* Kasir manapun yang Anda miliki (contoh: Adreena, Atakata, dsb), dengan cara mengganti Model Binding bawaannya melalui file Config. --- 🛠 Instalasi ----------- [](#-instalasi) Anda dapat menginstal package ini via [Composer](https://getcomposer.org/): ``` composer require khalid-r/kasir-smart-api ``` ⚙️ Konfigurasi (Opsional Tapi Penting) -------------------------------------- [](#️-konfigurasi-opsional-tapi-penting) Setelah instalasi, sangat direkomendasikan mempublikasikan konfigurasi file untuk me-*mapping* model aplikasi Anda dengan logic package ini. ``` php artisan vendor:publish --tag=kasir-smart-api-config ``` Ini akan menghasilkan file `config/kasir-smart-api.php`. Pastikan model yang digunakan (contoh `App\Models\Produk`) benar adanya dalam direktori sistem host Anda. Anda juga harus menambahkan variabel lingkungan berikut dalam file `.env` project baru Anda: ``` EXTERNAL_API_KEY="kunci_rahasia_untuk_chat_aggregator" API_RATE_LIMIT=60 API_LOG_CHANNEL=daily ``` *Selesai! Package ini akan me-load rute `api/v1/...` ke aplikasi Anda secara otomatis tanpa modifikasi.* --- 🚀 Penggunaan API & Endpoints -------------------------------- [](#-penggunaan-api--endpoints) Server Anda sekarang memiliki **2 endpoint brilian**. Pastikan selalu sertakan akses otentikasi di header: `X-API-Key : VALUE_DARI_ENV` ### 1. `GET /api/v1/ai/recommend?message={pesan_pelanggan_dari_wa}` [](#1-get-apiv1airecommendmessagepesan_pelanggan_dari_wa) Dikembangkan KHUSUS untuk Chat Aggregator. **Contoh Request:**`GET /api/v1/ai/recommend?message=mau bikin spanduk warung ukuran 5x3 gan` **Contoh Response:**Akan mengembalikan output cerdas berupa JSON yang berisi rincian intent, meta spesifik Outdoor, Array Data harga Spanduk, contoh kalkulasinya langsung untuk luas `15m2`, dan pesan prompt (*ai\_context*) siap suap ke API Groq/Gemini Anda. ### 2. `GET /api/v1/products/search?q={kueri}` [](#2-get-apiv1productssearchqkueri) Cocok untuk front-end kasir atau live-search manual, mengeliminasi typo dan mencari kata kunci percetakan implisit. **Contoh Request:**`GET /api/v1/products/search?q=benner` *(typo)* 📄 Lisensi --------- [](#-lisensi) The MIT License (MIT). Dibuat dengan ❤️ oleh **Khalid R** untuk memajukan ekosistem Software POS. ### Health Score 41 — FairBetter than 87% of packages Maintenance97 Actively maintained with recent releases Popularity8 Limited adoption so far Community6 Small or concentrated contributor base Maturity44 Maturing project, gaining track record Bus Factor1 Top contributor holds 100% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~1 days Total 3 Last Release 17d ago ### Community Maintainers ![](https://www.gravatar.com/avatar/f0ec517486b487b8865493c5b510cc1d953960de31c7131aa1e9a77fda235a9e?d=identicon)[khalidr](/maintainers/khalidr) --- Top Contributors [![muhammadkhalidr](https://avatars.githubusercontent.com/u/93936807?v=4)](https://github.com/muhammadkhalidr "muhammadkhalidr (6 commits)") ### Embed Badge ![Health badge](/badges/khalid-r-kasir-smart-api/health.svg) ``` [![Health](https://phpackages.com/badges/khalid-r-kasir-smart-api/health.svg)](https://phpackages.com/packages/khalid-r-kasir-smart-api) ``` ### Alternatives [psalm/plugin-laravel Psalm plugin for Laravel 3325.1M337](/packages/psalm-plugin-laravel)[api-platform/laravel API Platform support for Laravel 59156.3k10](/packages/api-platform-laravel)[simplestats-io/laravel-client Analytics for Laravel. Track visitors, registrations, and payments. Discover which channels actually drive revenue, not just traffic. Server-side, GDPR compliant, ad-blocker proof. 5019.3k](/packages/simplestats-io-laravel-client)[fleetbase/core-api Core Framework and Resources for Fleetbase API 1232.2k16](/packages/fleetbase-core-api)[pressbooks/pressbooks Pressbooks is an open source book publishing tool built on a WordPress multisite platform. Pressbooks outputs books in multiple formats, including PDF, EPUB, web, and a variety of XML flavours, using a theming/templating system, driven by CSS. 45344.0k1](/packages/pressbooks-pressbooks) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)