title: “Appointments” description: “Sistem appointment dengan calendar view, 6 status, payment tracking, service management, dan ERP access control di SNISHOP ERP.”

Appointments

Halaman Appointments mengelola seluruh jadwal appointment bisnis kamu — dari booking customer, konsultasi, hingga kunjungan servis. Dibangun di atas Appointments.jsx (1015 baris) dengan tampilan kalender mingguan, tracking pembayaran, dan integrasi ke POS untuk pemilihan layanan. Sistem ini dilindungi oleh ERPAccessGuard dengan module="appointments", memastikan hanya user dengan akses yang tepat yang bisa mengelola jadwal.

Arsitektur Komponen

Diagram Relasi Entitas (ERD)

Entity Schema Tables

Entity: Appointment

Field	Tipe	Wajib	Deskripsi
`company_id`	string (FK → Company)	Ya	ID perusahaan pemilik appointment
`customer_id`	string (FK → Customer)	Tidak	ID customer yang melakukan booking
`customer_name`	string	Ya	Nama customer (denormalized untuk performa)
`customer_email`	string	Tidak	Alamat email customer
`customer_phone`	string	Ya	Nomor telepon customer untuk konfirmasi
`service_id`	string (FK → CompanyPOSProduct)	Tidak	ID produk/jasa yang di-booking dari katalog POS
`service_name`	string	Tidak	Nama layanan (denormalized dari CompanyPOSProduct)
`assigned_to`	string (FK → Employee)	Tidak	Email karyawan yang menangani appointment
`assigned_to_name`	string	Tidak	Nama lengkap karyawan (denormalized)
`appointment_date`	date	Ya	Tanggal appointment dijadwalkan
`appointment_time`	string (time)	Ya	Waktu mulai appointment, format HH:MM
`duration_minutes`	number	Tidak	Durasi appointment dalam menit (default: 60)
`location`	string	Tidak	Lokasi pelaksanaan appointment
`notes`	string	Tidak	Catatan tambahan untuk appointment
`status`	enum	Tidak	Status appointment: `pending`, `confirmed`, `rescheduled`, `completed`, `cancelled`, `no_show` (default: `pending`)
`reminder_sent`	boolean	Tidak	Flag apakah reminder sudah dikirim ke customer (default: `false`)
`confirmation_code`	string	Tidak	Kode konfirmasi unik untuk validasi customer
`price`	number	Tidak	Harga layanan (default: 0, diisi otomatis dari POS Product)
`payment_status`	enum	Tidak	Status pembayaran: `unpaid`, `paid`, `partially_paid` (default: `unpaid`)
`cancellation_reason`	string	Tidak	Alasan pembatalan (diisi saat status = `cancelled` atau `no_show`)

Entity: Customer (CRM Integration)

Field	Tipe	Wajib	Deskripsi
`company_id`	string (FK → Company)	Ya	ID perusahaan pemilik data customer
`name`	string	Ya	Nama lengkap customer
`email`	string	Tidak	Alamat email customer
`phone`	string	Ya	Nomor telepon utama
`whatsapp_number`	string	Tidak	Nomor WhatsApp untuk follow up
`company`	string	Tidak	Nama perusahaan customer (untuk B2B)
`address`	string	Tidak	Alamat lengkap customer
`customer_type`	enum	Tidak	Tipe customer: `individual`, `business`, `retail`, `reseller`, `distributor`, `modern_market` (default: `individual`)
`membership_level_id`	string (FK → CustomerMembership)	Tidak	ID level membership customer
`membership_level_name`	string	Tidak	Nama level membership (denormalized)
`membership_since`	date	Tidak	Tanggal sejak kapan menjadi member
`membership_points`	number	Tidak	Total poin member saat ini (default: 0)
`lifetime_points`	number	Tidak	Total poin sepanjang waktu (default: 0)
`stamps`	number	Tidak	Total stamp yang dimiliki saat ini (default: 0)
`status`	enum	Tidak	Status customer: `lead`, `prospect`, `customer`, `inactive` (default: `lead`)
`source`	string	Tidak	Sumber customer (ads, referral, walk-in, dll)
`tags`	array[string]	Tidak	Tag-label untuk segmentasi
`lifetime_value`	number	Tidak	Total nilai transaksi sepanjang waktu (default: 0)
`total_orders`	number	Tidak	Jumlah seluruh transaksi (default: 0)
`average_order_value`	number	Tidak	Rata-rata nilai transaksi (default: 0)
`last_purchase_date`	date	Tidak	Tanggal pembelian terakhir
`birthday`	date	Tidak	Tanggal ulang tahun customer

Entity: Employee (HR Integration)

Field	Tipe	Wajib	Deskripsi
`company_id`	string (FK → Company)	Ya	ID perusahaan
`user_id`	string (FK → User)	Tidak	Link ke entitas User untuk autentikasi
`employee_id`	string	Ya	ID karyawan unik (NIP)
`full_name`	string	Ya	Nama lengkap karyawan
`email`	string	Ya	Alamat email karyawan
`phone`	string	Tidak	Nomor telepon karyawan
`department`	enum	Ya	Departemen: `Management`, `Sales`, `Marketing`, `Operations`, `Finance`, `IT`, `HR`, `Customer Service`
`position`	string	Ya	Jabatan / posisi karyawan
`description`	string	Tidak	Catatan atau deskripsi tambahan termasuk keahlian dan tanggung jawab (maks 1000 karakter)
`employment_type`	enum	Tidak	Tipe employment: `full_time`, `part_time`, `contract`, `intern` (default: `full_time`)
`hire_date`	date	Ya	Tanggal mulai bekerja
`salary`	number	Tidak	Gaji bulanan
`status`	enum	Tidak	Status karyawan: `active`, `on_leave`, `terminated` (default: `active`)
`avatar_url`	string	Tidak	URL foto profil karyawan

Entity: CompanyPOSProduct (POS Integration)

Field	Tipe	Wajib	Deskripsi
`company_id`	string (FK → Company)	Ya	ID perusahaan pemilik produk
`name`	string	Ya	Nama produk/jasa
`sku`	string	Tidak	SKU/Barcode produk
`category`	string	Tidak	Kategori produk
`price`	number	Ya	Harga jual layanan/produk
`cost`	number	Tidak	Harga modal/beli
`stock`	number	Tidak	Stok saat ini (default: 0)
`min_stock`	number	Tidak	Minimum stok untuk alert (default: 5)
`description`	string	Tidak	Deskripsi lengkap produk/jasa
`product_type`	enum	Tidak	Tipe produk: `finished_good`, `raw_material`, `semi_finished`, `packaging_material`, `bundle` (default: `finished_good`)
`is_active`	boolean	Tidak	Status aktif produk (default: `true`)
`unit`	string	Tidak	Satuan produk (default: `pcs`)
`sold_count`	number	Tidak	Total jumlah produk terjual (default: 0)
`tax_rate`	number	Tidak	Persentase pajak 0-100 (default: 0)

Entity: CustomerMembership (Loyalty Integration)

Field	Tipe	Wajib	Deskripsi
`company_id`	string (FK → Company)	Ya	ID perusahaan
`level_name`	string	Ya	Nama level (Silver, Gold, Platinum, dll)
`level_key`	string	Ya	Key unik untuk level (silver, gold, platinum)
`icon`	string	Tidak	Icon emoji untuk level
`color`	string	Tidak	Warna tema untuk level
`description`	string	Tidak	Penjelasan keuntungan dan syarat keanggotaan (maks 1000 karakter)
`discount_percentage`	number	Tidak	Diskon persentase untuk member level ini 0-100 (default: 0)
`points_multiplier`	number	Tidak	Multiplier poin yang didapat (default: 1)
`min_purchase`	number	Tidak	Minimum pembelian untuk mencapai level ini (default: 0)
`scheme_type`	enum	Tidak	Skema loyalty: `points`, `stamp`, `spending`, `visits`, `hybrid` (default: `points`)
`is_active`	boolean	Tidak	Status level aktif (default: `true`)

Status Appointment

Status	Warna	Ikon	Deskripsi
`pending`	Kuning	🟡	Menunggu konfirmasi dari customer
`confirmed`	Biru	🔵	Sudah dikonfirmasi, jadwal pasti
`completed`	Hijau	🟢	Appointment telah selesai dilaksanakan
`cancelled`	Merah	🔴	Dibatalkan oleh customer atau staff
`rescheduled`	Oranye	🟠	Dijadwalkan ulang ke waktu berbeda
`no_show`	Abu-abu	⚪	Customer tidak hadir tanpa kabar

Status Pembayaran

Status	Warna	Deskripsi
`unpaid`	Merah	Belum ada pembayaran
`partially_paid`	Kuning	Sudah dibayar sebagian (DP)
`paid`	Hijau	Lunas, pembayaran penuh

Enum Reference Tables

Enum: `Appointment.status`

Nilai	Label	Deskripsi
`pending`	Pending	Appointment baru dibuat, menunggu konfirmasi customer
`confirmed`	Confirmed	Customer telah mengkonfirmasi jadwal
`rescheduled`	Rescheduled	Jadwal diubah ke waktu yang berbeda
`completed`	Completed	Appointment telah selesai dilaksanakan
`cancelled`	Cancelled	Appointment dibatalkan oleh customer atau staff
`no_show`	No Show	Customer tidak hadir tanpa pemberitahuan

Enum: `Appointment.payment_status`

Nilai	Label	Deskripsi
`unpaid`	Unpaid	Belum ada pembayaran diterima
`partially_paid`	Partially Paid	Pembayaran diterima sebagian (DP)
`paid`	Paid	Pembayaran lunas dan penuh

Enum: `Customer.customer_type`

Nilai	Label	Deskripsi
`individual`	Individual	Customer perorangan
`business`	Business	Customer perusahaan / B2B
`retail`	Retail	Pembeli eceran
`reseller`	Reseller	Penjual kembali
`distributor`	Distributor	Distributor produk
`modern_market`	Modern Market	Minimarket/supermarket

Enum: `Customer.status`

Nilai	Label	Deskripsi
`lead`	Lead	Calon customer, belum melakukan transaksi
`prospect`	Prospect	Sudah menunjukkan minat, dalam proses konversi
`customer`	Customer	Customer aktif yang sudah bertransaksi
`inactive`	Inactive	Customer tidak aktif lagi

Enum: `Employee.department`

Nilai	Label	Deskripsi
`Management`	Management	Tim manajemen / pimpinan
`Sales`	Sales	Tim penjualan
`Marketing`	Marketing	Tim pemasaran
`Operations`	Operations	Tim operasional
`Finance`	Finance	Tim keuangan
`IT`	IT	Tim teknologi informasi
`HR`	HR	Tim sumber daya manusia
`Customer Service`	Customer Service	Tim layanan pelanggan

Enum: `Employee.employment_type`

Nilai	Label	Deskripsi
`full_time`	Full Time	Karyawan tetap penuh waktu
`part_time`	Part Time	Karyawan paruh waktu
`contract`	Contract	Karyawan kontrak / PKWT
`intern`	Intern	Magang

Enum: `Employee.status`

Nilai	Label	Deskripsi
`active`	Active	Karyawan aktif bekerja
`on_leave`	On Leave	Sedang cuti / izin panjang
`terminated`	Terminated	Sudah tidak bekerja

Enum: `CompanyPOSProduct.product_type`

Nilai	Label	Deskripsi
`finished_good`	Finished Good	Produk jadi siap jual
`raw_material`	Raw Material	Bahan baku
`semi_finished`	Semi Finished	Produk setengah jadi
`packaging_material`	Packaging Material	Bahan kemasan
`bundle`	Bundle	Paket bundel virtual

Enum: `CustomerMembership.scheme_type`

Nilai	Label	Deskripsi
`points`	Points	Akumulasi poin dari transaksi
`stamp`	Stamp	Koleksi stamp per transaksi
`spending`	Spending	Berdasarkan total belanja
`visits`	Visits	Berdasarkan frekuensi kunjungan
`hybrid`	Hybrid	Kombinasi beberapa skema

Duration Options

Durasi	Ikon	Kegunaan	Contoh Layanan
15 menit	⚡	Konsultasi singkat	Quick consultation, follow-up
30 menit	⏱️	Servis standar	Potong rambut, facial dasar
45 menit	🕐	Servis menengah	Hair coloring, manicure
60 menit	🕐	Servis penuh	Full body massage, deep facial
90 menit	🕑	Treatment panjang	Spa package, hair treatment
120 menit	🕒	Paket lengkap	Full spa day, bridal prep
180 menit	🕓	Session khusus	Extended treatment, VIP package

Waktu Selesai Otomatis

Fungsi calcEndTime() menghitung waktu selesai berdasarkan waktu mulai dan durasi:

endTime = appointment_time + duration_minutes

Ini ditampilkan di AppointmentCard supaya staff tahu kapan appointment berakhir dan bisa mempersiapkan sesi berikutnya.

Revenue Tracking

Stats dashboard menghitung 4 metrik utama:

Metrik	Perhitungan	Deskripsi
Total Appointments	`appointments.length`	Jumlah seluruh appointment
Pending	`filter(status === 'pending')`	Menunggu konfirmasi
Completed Today	`filter(status === 'completed' && date === today)`	Selesai hari ini
Total Revenue	`Σ price where status === 'completed'`	Revenue dari appointment selesai

Week Calendar View

Tampilan kalender menampilkan 7 hari ke depan dari tanggal yang dipilih. Setiap slot menampilkan appointment dengan warna sesuai status. Week picker memungkinkan navigasi ke minggu-minggu sebelumnya atau berikutnya.

Integrasi Lintas Modul

Modul	Entity	Fungsi	Data Flow
CRM	Customer	Data customer untuk booking	Customer → Appointment (customer_id, name, phone, email)
HR	Employee	Assignment staff ke appointment	Employee → Appointment (assigned_to, assigned_to_name)
POS	CompanyPOSProduct	Katalog layanan dari produk POS	POSProduct → Appointment (service_id, service_name, price)
CRM	CustomerMembership	Level membership dan diskon	CustomerMembership → Customer (level, discount, points)
Access Control	ERPAccessGuard	Module-level permission	Guard → Appointments (access check)
Company	Company	Scope multi-tenant	Company → semua entitas (company_id)

Sequence Diagrams

Flow Pembuatan Appointment Baru

Flow Notifikasi dan Reminder

Flow Reschedule Appointment

Flow Pembayaran Appointment

Flow Penggunaan Detail

Buka halaman Appointments dari sidebar — lihat stats revenue dan jumlah appointment di atas
Gunakan week picker untuk navigasi ke minggu yang diinginkan
Klik slot waktu kosong atau tombol “Tambah Appointment” untuk booking baru
Pilih customer dari daftar, atau buat customer baru jika belum ada
Pilih layanan dari katalog POS Products — harga otomatis terisi
Tentukan tanggal, waktu, durasi, dan assign ke staff yang tersedia
Isi lokasi dan catatan tambahan jika perlu
Klik Simpan — status awal adalah pending
Update status ke confirmed saat customer mengkonfirmasi
Setelah appointment selesai, update ke completed dan set payment status

Filter & Pencarian

Filter	Opsi	Deskripsi
Status	All, Pending, Confirmed, Completed, Cancelled, Rescheduled, No Show	Filter berdasarkan status appointment
Date	Week picker — pilih minggu yang diinginkan	Navigasi per minggu
Search	Pencarian berdasarkan nama customer	Full-text search di customer_name

RBAC Permission Table

Sistem appointment menggunakan ERPAccessGuard dengan module="appointments" dan Row-Level Security (RLS) dari Base44. Berikut adalah matriks hak akses berdasarkan peran:

Operasi	Admin	Owner Company	Staff (creator)	User Lain
Create	Ya (semua data)	Ya (scoped ke `active_company_id`)	Ya (hanya buat baru)	Tidak
Read	Ya (semua data)	Ya (scoped ke `active_company_id`)	Ya (hanya data sendiri)	Tidak
Update	Ya (semua data)	Ya (scoped ke `active_company_id`)	Ya (hanya data sendiri)	Tidak
Delete	Ya (semua data)	Ya (scoped ke `active_company_id`)	Ya (hanya data sendiri)	Tidak

RLS Conditions (dari JSONC)

create/read/update/delete:
  $or:
    - $and:
        - data.company_id == user.data.active_company_id
        - data.company_id NOT IN [null, ""]
    - created_by_id == user.id
    - user.role == "admin"

Penjelasan:

Admin (role = "admin") memiliki akses penuh ke seluruh appointment tanpa batasan company
Owner Company dapat mengakses appointment selama company_id sesuai dengan active_company_id yang sedang aktif
Staff (creator) hanya dapat mengakses appointment yang mereka buat sendiri (created_by_id == user.id)
User lain yang tidak memenuhi kondisi di atas tidak memiliki akses sama sekali

Akses Guard pada Komponen

<ERPAccessGuard module="appointments">
  <AppointmentsContent />
</ERPAccessGuard>

Guard ini memastikan hanya user yang memiliki modul appointments aktif di paket ERP mereka yang bisa mengakses halaman ini.

Tips

Selalu gunakan durasi standar dari dropdown supaya calcEndTime bisa menghitung waktu selesai secara akurat
Cek kalender setiap pagi untuk mengetahui jadwal hari ini dan antisipasi konflik jadwal
Set reminder_sent = true setelah mengirim reminder ke customer — ini mencegah reminder ganda
Untuk customer yang tidak hadir, gunakan status no_show dan isi cancellation_reason untuk tracking
Manfaatkan integrasi POS Products supaya harga layanan konsisten dengan yang ada di kasir
Denormalized fields (customer_name, assigned_to_name, service_name) membuat card tampil cepat tanpa perlu join ke entity lain
Review appointment cancelled/no-show secara berkala untuk mengidentifikasi pola dan mengurangi kerugian
Gunakan confirmation_code untuk verifikasi customer saat check-in, terutama untuk appointment bernilai tinggi
Manfaatkan CustomerMembership untuk memberikan diskon otomatis berdasarkan level membership customer
Perhatikan Employee.status — hanya assign ke karyawan dengan status active untuk menghindari penugasan ke karyawan yang sudah resign atau cuti panjang

Cara Akses

Dari sidebar, klik menu Productivity > Appointments.

​title: “Appointments” description: “Sistem appointment dengan calendar view, 6 status, payment tracking, service management, dan ERP access control di SNISHOP ERP.”

​Appointments

​Arsitektur Komponen

​Diagram Relasi Entitas (ERD)

​Entity Schema Tables

​Entity: Appointment

​Entity: Customer (CRM Integration)

​Entity: Employee (HR Integration)

​Entity: CompanyPOSProduct (POS Integration)

​Entity: CustomerMembership (Loyalty Integration)

​Status Appointment

​Status Pembayaran

​Enum Reference Tables

​Enum: Appointment.status

​Enum: Appointment.payment_status

​Enum: Customer.customer_type

​Enum: Customer.status

​Enum: Employee.department

​Enum: Employee.employment_type

​Enum: Employee.status

​Enum: CompanyPOSProduct.product_type

​Enum: CustomerMembership.scheme_type

​Duration Options

​Waktu Selesai Otomatis

​Revenue Tracking

​Week Calendar View

​Integrasi Lintas Modul

​Sequence Diagrams

​Flow Pembuatan Appointment Baru

​Flow Notifikasi dan Reminder

​Flow Reschedule Appointment

​Flow Pembayaran Appointment

​Flow Penggunaan Detail

​Filter & Pencarian

​RBAC Permission Table

​RLS Conditions (dari JSONC)

​Akses Guard pada Komponen

​Tips

​Cara Akses