Inviniux — Aplikasi Stok Gudang Elektronik

Sistem informasi berbasis web untuk pengelolaan dan pemantauan persediaan barang elektronik di gudang. Mendukung pencatatan stok masuk/keluar, manajemen supplier & kategori, real-time notifikasi stok rendah, serta ekspor laporan ke Excel.

Dikembangkan sebagai tugas Project Based Learning (PBL) Program Studi Teknik Informatika, Politeknik Negeri Batam.

Daftar Isi

• Tim Pengembang
• Fitur
• Teknologi
• Instalasi
• Struktur Proyek
• Hak Akses
• License

👥 Tim Pengembang (PBL IF-2PC-05)

Peran	Nama
Manajer Proyek	Dwi Amalia Purnamasari, S.T., M.Cs
Ketua Tim	Adrian Septiaji (3312501064)
Anggota	Cindo Maulina (3312501070)
Anggota	Taqiyyah Aufaa Nabiilah (3312501084)

🚀 Fitur Utama

Admin Gudang

• Manajemen Data Barang — CRUD barang beserta gambar, satuan (UnitBarang), dan kategori.
• Barang Masuk — Pencatatan inventaris masuk dengan validasi nomor seri unik.
• Barang Keluar — Pencatatan barang keluar dengan pengecekan stok otomatis.
• Manajemen Supplier — Kelola data pemasok barang.
• Manajemen Kategori — Kelola kategori produk elektronik.
• Ekspor Laporan — Unduh data barang dalam format Excel (.xlsx) via PhpSpreadsheet.
• Notifikasi Stok Rendah — Real-time alert via Pusher ketika stok di bawah batas minimum.

Manajer

• Dashboard Monitoring — Ringkasan stok dan statistik persediaan.
• Lihat Data Barang — Akses read-only ke daftar barang beserta detail stok.
• Ekspor Laporan — Unduh laporan persediaan dalam format Excel.
• Notifikasi Stok Rendah — Real-time alert via Pusher ketika stok di bawah batas minimum.

Umum

• Autentikasi — Login, lupa password (OTP via email), dan reset password.
• Pengaturan Profil — Edit nama, email, dan ubah password.
• Role-based Access Control — Middleware role membatasi akses berdasarkan peran.

🛠️ Teknologi yang Digunakan

Layer	Teknologi
Framework	Laravel 13 (PHP ≥ 8.3)
Frontend	Blade, Tailwind CSS 3, Flowbite 4, JavaScript
Bundler	Vite 8
Database	MySQL
Real-time	Pusher + Laravel Echo
Export Excel	PhpSpreadsheet
Email	SMTP (OTP untuk reset password)

⚙️ Cara Instalasi (Local Development)

Prasyarat

• PHP ≥ 8.3
• Composer
• Node.js & npm
• MySQL
• Laragon / XAMPP / Valet (atau server lokal lainnya)

Langkah Instalasi

1. Clone repositori:

   git clone https://github.com/adriansa2009/pro-web.git
   cd pro-web

2. Instal dependensi PHP:

   composer install

3. Instal dependensi Node.js:

   npm install
   npm run build

4. Salin file environment dan atur konfigurasi:

   cp .env.example .env

   Sesuaikan nilai berikut di .env:

   • DB_DATABASE, DB_USERNAME, DB_PASSWORD — kredensial database MySQL
   • MAIL_* — konfigurasi SMTP untuk OTP reset password
   • PUSHER_* — kredensial Pusher (opsional, untuk notifikasi real-time)

5. Generate application key:

   php artisan key:generate

6. Jalankan migrasi dan seeder:

   php artisan migrate --seed

7. Jalankan server pengembangan:

   npm run dev
   php artisan serve

8. Buka browser → http://localhost:8000

Akun Default (Seeder)

Role	Username	Password
Admin Gudang	admin (default seeder)	password (default seeder)
Manajer	manajer (default seeder)	password (default seeder)

Jalankan php artisan db:seed untuk membuat akun default. Periksa file seeder di database/seeders/ untuk kredensial.

📁 Struktur Proyek

pro-web/
├── app/
│   ├── Http/Controllers/
│   │   ├── admin/          # Controller Admin Gudang
│   │   ├── manajer/        # Controller Manajer
│   │   └── Auth/           # Autentikasi & Reset Password
│   ├── Models/             # Eloquent Models (Barang, BarangMasuk, BarangKeluar, Supplier, ...)
│   ├── Events/             # Event Pusher (LowStockNotification)
│   ├── Mail/               # Mailable (SendOtpMail)
│   └── Traits/             # HasStockAlert (trait notifikasi stok)
├── database/
│   ├── migrations/         # Skema database
│   └── seeders/            # Data awal
├── resources/views/        # Blade templates
├── routes/
│   └── web.php             # Definisi route
└── public/                 # Asset publik (build, images)

🔐 Hak Akses (Role)

Fitur	Admin Gudang	Manajer
Dashboard	✅	✅
CRUD Barang	✅	❌ (read-only)
Barang Masuk / Keluar	✅	❌
Supplier & Kategori	✅	❌
Ekspor Laporan	✅	✅
Notifikasi Stok Rendah	✅	✅
Pengaturan Profil	✅	✅

📄 License

Proyek ini dilisensikan di bawah MIT License.