🔶 Temuya Docs
Entry Level

Kategori Produk

Pengelompokan produk berdasarkan kategori bisnis untuk mempermudah navigasi kasir dan analisis laporan penjualan.

Gambaran Umum

Dalam dunia ritel dan F&B, puluhan bahkan ratusan produk tidak mungkin ditampilkan dalam satu daftar panjang tanpa pengelompokan. Di sinilah peran penting “Kategori Produk”. Fitur kategori berfungsi sebagai laci-laci pengelompokan yang mengorganisasikan seluruh katalog produk menjadi bagian-bagian logis yang mudah dicerna.

Bayangkan sebuah skenario bisnis di restoran besar. Saat kasir menghadapi antrean yang mengular, mencari menu “Es Teh Manis” dari daftar berisi 300 macam makanan dan minuman akan memakan waktu lama. Namun, dengan adanya kategori, kasir hanya perlu menyentuh kategori ”🍹 Minuman Dingin”, dan daftar akan langsung menyempit menjadi belasan item saja. Selain itu, pemilik bisnis sangat bergantung pada kategori untuk memahami tren. Laporan keuangan akhir bulan akan dengan jelas menunjukkan, misalnya, bahwa omzet tertinggi bulan ini bukan berasal dari kategori “Makanan Utama”, melainkan dari kategori “Camilan & Dessert”.

Pengorganisasian ini bukan hanya tentang estetika aplikasi, melainkan tentang kecepatan operasional, efisiensi navigasi UI/UX, dan kedalaman wawasan analitik yang bisa diberikan sistem kepada pengguna.

Alur Kerja

Pembuatan dan pengaturan kategori biasanya dilakukan saat setup awal toko, namun seringkali disesuaikan seiring dengan perkembangan menu.

Misalnya, seorang pengelola kafe awalnya hanya memiliki kategori “Makanan” dan “Minuman”. Seiring waktu, kafenya mulai menjual biji kopi dalam kemasan dan pernak-pernik (merchandise). Pengelola akan masuk ke menu “Manajemen Kategori”. Mereka menambahkan kategori baru bernama “Biji Kopi” dan “Merchandise”.

Agar lebih menarik secara visual dan mempercepat identifikasi oleh kasir (karena kasir lebih cepat merespons visual daripada teks), sistem kita memungkinkan penambahan icon atau emoji pada kategori, misalnya emoji cangkir kopi (☕) untuk “Biji Kopi” dan emoji kaos (👕) untuk “Merchandise”.

Selanjutnya, pengelola perlu mengatur urutan tampil (sorting). Mereka menyadari bahwa 80% transaksi kafe adalah minuman. Oleh karena itu, mereka mengubah urutan kategori sehingga “Minuman” tampil di urutan pertama pada layar kasir, diikuti “Makanan”, lalu yang lainnya di urutan belakang.

Setelah kategori dibuat, saat pengelola menambahkan produk baru (misalnya Tumbler Kafe), mereka cukup memilih kategori “Merchandise” dari menu dropdown. Secara instan, produk tersebut akan dikelompokkan dan tampil di layar kasir di bawah laci “Merchandise”. Ketika manajer toko menarik laporan penjualan minggu depan, sistem secara cerdas akan menjumlahkan semua produk yang berada di bawah payung “Merchandise” menjadi satu metrik laporan agregat.

flowchart TD
    A[Mulai: Setup Kategori] --> B[Masuk Halaman Manajemen Kategori]
    B --> C[Tambah Kategori Baru]
    C --> D[Input Nama Kategori]
    D --> E[Pilih Icon / Emoji Visual]
    E --> F[Tentukan Urutan Tampil / Sort Order]
    F --> G[Simpan Kategori ke Database]
    
    G --> H[Masuk Halaman Produk]
    H --> I[Assign Produk ke Kategori yang Dibuat]
    
    I --> J{Dampak pada Sistem}
    J --> K[Kasir: Navigasi UI menggunakan Tab Kategori]
    J --> L[Dashboard: Filter Produk Berdasarkan Kategori]
    J --> M[Laporan: Analisis Omzet per Kategori]

Teknologi & Infrastruktur

Kategori diimplementasikan sebagai entitas relasional independen yang saling terkait dengan entitas produk (One-to-Many). Hal ini memungkinkan perubahan nama kategori terjadi dalam waktu konstan (O(1)) tanpa perlu memperbarui ribuan baris data produk, karena produk hanya menyimpan referensi category_id.

Atribut sort_order pada kategori sangat kritikal untuk UX. Kolom ini menyimpan nilai integer yang digunakan oleh query database ORDER BY sort_order ASC saat mengirimkan data daftar kategori ke aplikasi frontend kasir. Jika pengguna mengubah urutan di dashboard melalui antarmuka drag-and-drop, backend akan menerima sebuah array berisi ID kategori yang telah diurutkan ulang, lalu melakukan update massal (bulk update) pada kolom sort_order dari masing-masing kategori sesuai indeks barunya.

Icon atau emoji umumnya disimpan sebagai karakter Unicode langsung di dalam kolom teks database berkat dukungan encoding utf8mb4 pada database modern, sehingga tidak memerlukan penyimpanan file gambar eksternal yang memberatkan.

Tabel Database Terkait

Nama TabelDeskripsiKolom Penting
categoriesMenyimpan master data kategori bisnis.id, name, icon, sort_order, is_active, created_at, updated_at
productsTabel produk yang merujuk pada kategori (Foreign Key).id, name, category_id (FK ke categories.id)

Endpoint API

MetodeEndpointFungsi dan Kegunaan
GET/api/v1/categoriesMengambil semua kategori aktif. Selalu mengembalikan data yang sudah diurutkan berdasarkan sort_order.
POST/api/v1/categoriesMembuat kategori baru dengan parameter name dan opsional icon.
PUT/api/v1/categories/:idMengedit nama, status, atau icon kategori spesifik.
PUT/api/v1/categories/reorderEndpoint khusus menerima array of IDs untuk mengubah urutan tampil banyak kategori sekaligus.
DELETE/api/v1/categories/:idMenghapus kategori. Sistem harus memvalidasi agar tidak ada produk yang masih memakai kategori ini sebelum dihapus, atau memindahkan produk ke “Uncategorized”.

Keterkaitan dengan Fitur Lain

  1. Antarmuka Aplikasi Kasir (POS): Kategori adalah elemen antarmuka tingkat pertama. Biasanya ditampilkan sebagai deretan tombol menu di sisi kiri atau atas layar aplikasi POS. Ini adalah instrumen utama bagi staf toko untuk menemukan barang dagangan dengan cepat.
  2. Laporan Penjualan (Sales Report): Filter kategori sangat penting di laporan. Pemilik sering kali ingin melihat perbandingan kinerja antara kelompok produk. Sistem menghasilkan diagram pie atau grafik batang yang menunjukkan persentase omzet masing-masing kategori.
  3. Printer Dapur / Bar: Dalam sistem F&B modern, pesanan dicetak ke lokasi yang berbeda. Kategori sering digunakan sebagai aturan routing pencetakan (Order Routing). Misalnya, semua produk dalam kategori “Minuman Dingin” akan otomatis dicetak ke printer area Bar, sedangkan kategori “Makanan Utama” dicetak ke printer Dapur.

Hal Penting yang Perlu Diketahui

  • Pencegahan Yatim Piatu (Orphan Records): Penghapusan kategori memerlukan perhatian khusus. Jika sebuah kategori memiliki 50 produk, menghapus kategori tersebut secara paksa akan membuat 50 produk menjadi “yatim piatu” (kolom category_id-nya menunjuk ke ID yang tidak ada). Solusi sistem kita adalah menolak penghapusan (restrict) jika masih ada relasi produk, atau secara otomatis memberikan opsi kepada user untuk memindahkan produk-produk tersebut ke kategori default (misal: “Lain-lain”).
  • Kinerja Laporan: Menghitung total penjualan per kategori dari jutaan transaksi dapat membebani database. Oleh karena itu, query laporan menggunakan teknik agregasi SQL tingkat lanjut (GROUP BY categories.name) yang dioptimalkan dengan indeks pada foreign key category_id di tabel transaksi.
erDiagram
    CATEGORIES ||--o{ PRODUCTS : "mengelompokkan"
    
    CATEGORIES {
        int id PK
        string name "Nama Kategori (ex: Minuman)"
        string icon "Emoji visual (ex: ☕)"
        int sort_order "Urutan tampil UI"
        boolean is_active
    }
    
    PRODUCTS {
        string id PK
        int category_id FK "Referensi ke Categories"
        string name
        decimal price
    }