# 🏓 Tenis Meja 31 - E-Commerce & Multi-Channel Inventory

Sistem platform toko online dan manajemen inventori pusat perlengkapan olahraga tenis meja (kayu bat/blade, karet pips & inverted, sepatu pro, meja, dan bola standar ITTF). Didesain khusus untuk operasional ritel di Indonesia dengan integrasi logistik lokal, otomasi pemesanan, dan pengelolaan multi-channel penjualan.

---

## 📋 Ringkasan Sistem (System Summary)

Aplikasi **Tenis Meja 31** terdiri dari dua antarmuka utama berbasis peran (*role-based*) dengan dukungan arsitektur multi-subdomain:
1. **Storefront Publik** (`tenismeja31.nip.io`): Pengalaman belanja yang responsif, cepat, dan modern bagi konsumen.
2. **Backoffice / Admin Panel** (`manage.tenismeja31.nip.io` atau `/admin`): Panel kontrol terpusat untuk operasional toko, manajemen produk & varian, pencatatan mutasi stok lintas channel, pelacakan transaksi, dan laporan keuangan.

---

## 🚀 Fitur Utama

### 🛒 1. Storefront & Pengalaman Konsumen
* **Katalog & Hero Banner Interaktif**: Menampilkan promo aktif, produk unggulan, dan brand terkemuka (Butterfly, Stiga, DHS, Yinhe, Andro, Xiom, Nittaku, dll).
* **Live Search & Filter Eksklusif**: Pencarian langsung berbasis AJAX dengan aturan filter ketat (hanya satu filter aktif: pencarian kata kunci, brand, atau kategori) serta fitur *lazy loading*.
* **Sistem Varian Fleksibel**: Mendukung atribut kustom per produk (misal: warna karet *Merah/Hitam*, ketebalan *2.1mm*, kondisi *Baru/Bekas*) dengan harga dan stok real-time per varian.
* **Keranjang Belanja Cerdas**: Fitur *multi-select checkbox* (hanya produk yang dicentang yang dibawa ke checkout), penyesuaian kuantitas AJAX, dan validasi ketersediaan stok dinamis.
* **Integrasi RajaOngkir (Lokal & Caching)**: Kalkulasi otomatis tarif pengiriman ekspedisi (JNE, TIKI, POS Indonesia) menggunakan basis data wilayah provinsi & kota lokal dengan fallback API RajaOngkir.
* **Manajemen Alamat Pengiriman**: Buku alamat konsumen dengan penanda alamat utama (*default address*).
* **Payment Gateway Simulator**: Simulasi pembayaran otomatis dengan nomor Virtual Account (VA) unik dan QRIS, otomatis mengupdate status pesanan saat disimulasikan lunas.
* **Pelacakan Pesanan & Akun**: Histori transaksi dengan alur status transparan: `NEW` &rarr; `PROSES` &rarr; `SHIPPED` &rarr; `DONE`.
* **Ulasan Produk & Otomasi Cron**: Endpoint otomatisasi `cron/auto-done` yang menyelesaikan pesanan berstatus `SHIPPED` setelah 24 jam dan memicu email ajakan ulasan rating berbintang kepada pembeli.
* **Autentikasi Pengguna**: Login & registrasi akun manual, Google Login simulator/OAuth, serta auto-format nomor telepon WhatsApp standar internasional (`62...`).

### 🛠️ 2. Backoffice & Manajemen Toko (Admin Panel)
* **Dashboard KPI Real-Time**: Ringkasan performa finansial (total pendapatan bersih, pesanan aktif, total produk) dan peringatan dini stok menipis (*low stock alert* &le; 5 unit).
* **Manajemen Produk, Brand & Kategori**:
  * CRUD Produk lengkap dengan varian tak terbatas (*variant definitions* JSON).
  * CRUD Brand & Kategori dengan pembuatan slug otomatis yang tersinkronisasi, validasi form, dan upload media.
* **Central Inventory & Stock Hub**:
  * Pencatatan riwayat mutasi stok masuk (`IN`), keluar (`OUT`), dan penyesuaian stok fisik / *stock opname* (`ADJUSTMENT`).
  * Sinkronisasi otomatis total stok produk induk dari akumulasi stok varian.
  * Audit log mutasi lengkap mencatat tipe, jumlah, stok sebelum/sesudah, nomor referensi/faktur, dan admin pencatat.
* **Multi-Channel Sales Hub**:
  * Integrasi pencatatan stok lintas kanal: Tokopedia, Shopee, TikTok Shop, Blibli, Lazada, WhatsApp, Web Store, dan Penjualan Langsung (Offline).
* **Manajemen Transaksi & Cetak Invoice**:
  * Alur pemrosesan pesanan terpadu: Konfirmasi pembayaran, proses packing, input nomor resi pengiriman, hingga penyelesaian pesanan.
  * Fitur cetak faktur/invoice resmi siap cetak (*print-ready*).
* **Manajemen Pelanggan**:
  * Database konsumen terdaftar, statistik pertumbuhan bulanan, riwayat pesanan, profil lengkap, dan fitur **Export CSV**.
* **Laporan Finansial & Penjualan**:
  * Filter rentang waktu: Hari ini, Minggu ini, Bulan ini, Tahun ini, atau Periode Kustom.
  * Analisis total omzet, pendapatan bersih produk, dan total biaya logistik.
* **Audit Log Notifikasi Email**:
  * Rekaman seluruh histori email notifikasi transaksi (Sales Order ke Admin, konfirmasi pesanan, dan ajakan ulasan) dengan tampilan HTML viewer.
* **Mode Maintenance Checkout**:
  * Kemampuan mengaktifkan mode maintenance checkout secara instan dari panel admin jika toko sedang libur atau stok opname tanpa mematikan katalog produk.

---

## 💻 Tech Stack & Kebutuhan Sistem

| Komponen | Teknologi / Library |
| :--- | :--- |
| **Backend Framework** | [CodeIgniter 4](https://codeigniter.com) (v4.7.4) |
| **Bahasa Pemrograman** | PHP `>= 8.2` (dengan ekstensi `intl`, `mbstring`, `mysqlnd`, `curl`, `json`) |
| **Basis Data** | MySQL / MariaDB (Driver MySQLi, UTF8MB4) |
| **Styling & CSS** | [Tailwind CSS v3.4](https://tailwindcss.com), FontAwesome 6, Select2 |
| **Web Server / Proxy** | [Caddy](https://caddyserver.com) (Reverse proxy ke `127.0.0.1:8282` dengan TLS internal) |

---

## ⚙️ Panduan Setup & Menjalankan Aplikasi

### 1. Salin Environment
Salin file konfigurasi environment dan sesuaikan konfigurasi database serta API:
```bash
cp env .env
```
Pastikan pengaturan database di `.env`:
```ini
database.default.hostname = 127.0.0.1
database.default.database = tenismeja31
database.default.username = root
database.default.password = toor
database.default.DBDriver = MySQLi

# Pengaturan Gmail SMTP (Gunakan Google App Password 16-digit)
email.protocol = 'smtp'
email.SMTPHost = 'smtp.gmail.com'
email.SMTPUser = 'emailanda@gmail.com'
email.SMTPPass = 'xxxx xxxx xxxx xxxx'
email.SMTPPort = 587
email.SMTPCrypto = 'tls'
email.fromEmail = 'emailanda@gmail.com'
email.fromName = 'Tenis Meja 31'
```

Uji coba koneksi Gmail SMTP via terminal:
```bash
/opt/homebrew/opt/php@8.3/bin/php spark email:test emailanda@gmail.com
```

### 2. Migrasi Database
Jalankan migrasi tabel database menggunakan PHP 8.2+:
```bash
/opt/homebrew/opt/php@8.3/bin/php spark migrate
```
*(Atau `php spark migrate` jika PHP CLI default sistem Anda sudah PHP 8.2+)*

### 3. Kompilasi Aset CSS (Tailwind)
Instal dependensi Node dan kompilasi CSS:
```bash
npm install
npm run build:css
# Atau jalankan mode pengawasan:
npm run watch:css
```

### 4. Menjalankan Server Lokal
Jalankan server pengembangan CodeIgniter pada port 8282 (wajib gunakan `--host 127.0.0.1` agar sinkron dengan IPv4 Caddy):
```bash
/opt/homebrew/opt/php@8.3/bin/php spark serve --host 127.0.0.1 --port 8282
```
Jalankan Caddy untuk melayani domain lokal dengan SSL otomatis:
```bash
caddy run
# atau memuat ulang konfigurasi:
caddy reload --config ./Caddyfile
```
Akses melalui browser:
* **Storefront Publik**: `https://tenismeja31.nip.io`
* **Admin Backoffice**: `https://manage.tenismeja31.nip.io` (atau `https://tenismeja31.nip.io/admin`)

---

## 📂 Struktur Direktori Utama

```
tenis-meja-31/
├── app/
│   ├── Config/            # Konfigurasi aplikasi & rute (Routes.php)
│   ├── Controllers/       # Controller Storefront & Admin (Admin/)
│   ├── Database/          # Migrasi database & Seeders
│   ├── Filters/           # Middleware / Request filter (AdminFilter, AuthFilter)
│   ├── Libraries/         # InventoryService, NotificationService, RajaOngkirService
│   ├── Models/            # Model data Eloquent/ActiveRecord CodeIgniter
│   └── Views/             # Blade/PHP Template tampilan (layouts/, admin/, storefront/)
├── public/                # Document root web (index.php, CSS terkompilasi, JS, uploads)
├── src/css/               # Sumber gaya Tailwind CSS (app.css)
├── writable/              # Cache, logs, dan sesi runtime CodeIgniter
├── Caddyfile              # Konfigurasi proxy Caddy SSL lokal
├── tailwind.config.js     # Konfigurasi tema dan token warna Tenis Meja 31
└── composer.json          # Dependensi PHP Composer
```
