README

Solusi Point of Sale (POS) Mandiri untuk Instansi Tunggal yang Mengutamakan Kendali Penuh atas Data dan Infrastruktur.

👋 Tentang Yualan Community Edition

Yualan Community Edition (Dedicated Enterprise) adalah platform POS self-hosted yang dirancang khusus bagi pemilik bisnis dan organisasi yang membutuhkan otoritas mutlak atas basis data mereka.

Sistem ini ideal bagi instansi yang:

Menginginkan kedaulatan data penuh tanpa ketergantungan pada pihak ketiga.
Memerlukan akses database langsung untuk integrasi sistem internal.
Memiliki tim IT mandiri yang mampu mengelola infrastruktur server pribadi.
Membutuhkan performa tinggi melalui alokasi sumber daya server yang berdedikasi.

🖼️ Preview Antarmuka

Tampilan Dashboard Analytics

Antarmuka Point of Sale (POS)

✨ Fitur Utama

🛒 Operasional Kasir & Penjualan

Transaksi Cepat & Responsif - Dioptimalkan untuk alur kerja yang padat.
Manajemen Produk Enterprise - Dukungan SKU, kategori kompleks, dan manajemen unit barang.
Voucher & Promosi - Sistem manajemen promo mandiri untuk meningkatkan loyalitas pelanggan.
Customer CRM - Kelola database pelanggan Anda sendiri secara privat.

📦 Inventaris & Rantai Pasokan

Stock Card Real-Time - Pantau histori pergerakan barang dengan detail.
Adjustment & Receiving - Modul penerimaan barang dan penyesuaian stok yang akurat.
Supplier Directory - Kelola data pemasok barang untuk mempermudah operasional.

📊 Pelaporan & Transparansi

Laporan Detail Penjualan - Akses data mentah transaksi untuk keperluan audit dan analisis.
Pembayaran & Piutang - Pantau arus kas masuk dan manajemen piutang pelanggan.

🏗️ Teknologi Inti

Backend: Laravel 12 (PHP 8.3+)
Frontend: Vue 3 + Inertia.js (Modern SPA)
Database: SQLite (Default for easy setup) / PostgreSQL (Supported for Enterprise Stability)
Styling: Tailwind CSS & Vanilla CSS

🛠️ Instalasi Server Mandiri

Pastikan server Anda sudah terpasang PHP 8.3+ dan Node.js 20+. Jika menggunakan PostgreSQL, pastikan PostgreSQL 15+ juga terpasang.

Cara 1: Menggunakan Composer (Direkomendasikan)

Gunakan perintah ini untuk mengunduh dan menyiapkan proyek secara otomatis:

# 1. Buat proyek baru
composer create-project abdurozzaq/yualan --stability alpha
cd yualan

# 2. Bangun Aset Frontend
npm install
npm run build

Cara 2: Menggunakan Docker (Paling Cepat)

Sangat direkomendasikan jika Anda ingin langsung menjalankan aplikasi tanpa perlu setup environment atau clone repository.

# Jalankan aplikasi langsung dari Docker Hub
docker run -d -p 8627:80 --name yualan-app rozzaqnh/yualan-community-edition:latest

Aplikasi akan tersedia di http://localhost:8627.

Cara 3: Manual (Git Clone)

Jika Anda ingin melakukan instalasi secara manual tanpa Docker:

# 1. Clone repository
git clone https://github.com/Abdurozzaq/Yualan.git
cd Yualan

# 2. Instalasi Dependensi
composer install --optimize-autoloader --no-dev
npm install

# 3. Konfigurasi Environment
cp .env.example .env
# Sesuaikan koneksi database Anda di .env (Default: SQLite)

# 4. Inisialisasi Database
php artisan key:generate
php artisan migrate --seed --force

# 5. Build Aset Frontend
npm run build

⚡ Malas Setup Server?

Bagi instansi yang ingin menggunakan fitur lengkap Yualan tanpa perlu repot mengelola server sendiri, kami menyediakan Yualan Premium.

Terima Beres - Hosting, SSL, dan Maintenance ditangani oleh kami.
Fitur Lanjutan - Termasuk Laba Bersih, Analisis Produk Terlaris, Manajemen Karyawan, dan update rutin.
Dukungan Prioritas - Bantuan teknis langsung dari tim Nusavasoft.

🌐 Cek Edisi Premium: yualan.web.id

⚖️ Lisensi

Proyek ini dilisensikan di bawah GNU GPL v2. Pengguna memiliki kebebasan penuh untuk memodifikasi dan menjalankan sistem ini di infrastruktur masing-masing dengan tetap mematuhi aturan distribusi kode sumber asli.

Created Under PT. Nusavasoft Digital Solutions

abdurozzaq / yualan

Maintainers

Package info

Statistics

Security