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(2mo ago)013MITPHPPHP ^8.1 Since May 22Pushed 2mo 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 3w 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 37 — LowBetter than 81% of packages Maintenance87 Actively maintained with recent releases Popularity5 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 62d ago ### Community Maintainers ![](https://avatars.githubusercontent.com/u/2365234?v=4)[Khalid Reid](/maintainers/khalidr)[@khalidr](https://github.com/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 3345.3M347](/packages/psalm-plugin-laravel)[api-platform/laravel API Platform support for Laravel 58174.6k17](/packages/api-platform-laravel)[fleetbase/core-api Core Framework and Resources for Fleetbase API 1235.9k21](/packages/fleetbase-core-api)[simplestats-io/laravel-client Server-side analytics for Laravel that follows the full funnel from visit to registration to payment, attributed to the channel that drove it. Revenue, MRR, churn and ad-spend profit (ROAS/CAC) per channel. GDPR compliant, ad-blocker proof. 5022.6k](/packages/simplestats-io-laravel-client) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)