title: “Automation” description: “Workflow automation dengan 12 trigger types, 7 action types, background engine, dan integrasi Google Sheets/Slack/Discord di SNISHOP ERP.”

Automation

Halaman Automation memungkinkan kamu membuat workflow yang berjalan otomatis berdasarkan trigger dan action yang ditentukan. Dibangun di atas Automation.jsx (105 baris) dengan engine utama di WorkflowAutomationManager.jsx (427 baris) dan WorkflowEngine.jsx yang berjalan di background. Sistem ini mendukung 12 jenis trigger dari berbagai modul (task, invoice, stock, KPI, leave request) dan 7 jenis action termasuk integrasi ke Google Sheets, Slack, dan Discord.

Arsitektur Komponen

Entity WorkflowAutomation

Field	Tipe	Deskripsi
`id`	UUID	Primary key
`name`	string	Nama workflow
`description`	string	Deskripsi workflow
`trigger_type`	enum	Jenis trigger (12 opsi)
`trigger_conditions`	object	Kondisi trigger (misal `{days_before: 3}`)
`actions`	array	Daftar action yang dijalankan
`is_active`	boolean	Status aktif workflow
`trigger_count`	number	Berapa kali trigger dijalankan
`company_id`	FK → Company	Scope perusahaan
`user_id`	FK → User	Scope user (opsional)
`created_at`	Timestamp	Waktu pembuatan
`updated_at`	Timestamp	Waktu update terakhir
`created_by`	FK → User	User yang membuat

12 Trigger Types

Trigger	Sumber	Deskripsi
`task_created`	Tasks	Task baru dibuat
`task_status_changed`	Tasks	Status task berubah
`task_due_approaching`	Tasks	Deadline task mendekat
`task_overdue`	Tasks	Task melewati deadline
`invoice_created`	Finance	Invoice baru dibuat
`invoice_overdue`	Finance	Invoice melewati jatuh tempo
`low_stock`	Inventory	Stok produk rendah
`leave_request`	HR	Pengajuan cuti baru
`kpi_target_missed`	KPI	Target KPI tidak tercapai
`schedule_daily`	System	Trigger harian (jadwal)
`schedule_weekly`	System	Trigger mingguan (jadwal)
`schedule_monthly`	System	Trigger bulanan (jadwal)

Trigger Conditions

Trigger	Condition Object	Deskripsi
`task_due_approaching`	`{ days_before: 3 }`	X hari sebelum deadline
`low_stock`	`{ threshold: 10 }`	Stok di bawah threshold
`schedule_daily`	`{ time: '09:00' }`	Waktu eksekusi harian
`schedule_weekly`	`{ day: 'monday', time: '09:00' }`	Hari & waktu eksekusi
`schedule_monthly`	`{ day: 1, time: '09:00' }`	Tanggal & waktu eksekusi

7 Action Types

Action	Deskripsi	Data Fields
`send_notification`	Kirim notifikasi in-app	`message`, `recipient`
`send_chat_message`	Kirim pesan ke channel	`message`, `channel_id`
`create_task`	Buat task baru otomatis	Task fields
`create_notification_all_members`	Notifikasi ke semua anggota	`message`
`sync_google_sheets`	Sync data ke Google Sheets	`spreadsheetId`, `sheetName`
`send_slack_alert`	Kirim alert ke Slack	`message`, `channelId`
`send_discord_alert`	Kirim alert ke Discord	`message`, `channelId`

Recipient Options

Recipient	Deskripsi
`self`	Kirim ke pembuat workflow
`all_members`	Kirim ke semua anggota company
`admins`	Kirim ke semua admin

Workflow Engine

Background Polling

Engine berjalan di background dan mengevaluasi semua workflow aktif setiap 2 menit.

Multi-Action Execution

Satu workflow bisa memiliki beberapa action yang dijalankan berurutan saat trigger terpicu.

Cross-Module Integration

Data Scoping

Workflow di-scope berdasarkan:

company_id — workflow berlaku untuk seluruh perusahaan
user_id — workflow berlaku hanya untuk user tertentu (opsional)

DirectMessage Integration

Sistem juga menggunakan entity DirectMessage untuk internal messaging dengan polling setiap 30 detik untuk unread count.

Contoh Workflow

1. Reminder Deadline Task

Field	Value
Name	”Reminder H-1 Deadline”
Trigger	`task_due_approaching`
Condition	`{ days_before: 1 }`
Action 1	`send_notification` ke task assignee
Action 2	`send_chat_message` ke channel #tasks

2. Low Stock Alert

Field	Value
Name	”Alert Stok Rendah”
Trigger	`low_stock`
Condition	`{ threshold: 10 }`
Action 1	`send_notification` ke inventory manager
Action 2	`send_slack_alert` ke channel #inventory
Action 3	`sync_google_sheets` untuk tracking

3. Invoice Overdue Notification

Field	Value
Name	”Notifikasi Invoice Jatuh Tempo”
Trigger	`invoice_overdue`
Condition	None (semua invoice overdue)
Action 1	`send_notification` ke finance team
Action 2	`create_task` untuk follow-up

Cara Akses

Dari sidebar, klik menu Marketing > Automation.

Flow Penggunaan

Buka halaman Automation dari sidebar — lihat daftar workflow yang sudah ada
Klik “Buat Workflow” untuk membuat automation baru
Beri nama dan deskripsi workflow
Pilih trigger type dari 12 opsi yang tersedia
Atur trigger conditions jika diperlukan (misal: days_before: 3)
Tambahkan satu atau lebih actions yang harus dijalankan
Untuk action eksternal (Google Sheets, Slack, Discord), isi connection details
Aktifkan workflow dengan toggle Active
Monitor trigger_count untuk melihat berapa kali workflow sudah berjalan
Review dan optimasi workflow secara berkala berdasarkan hasil

Tips

Mulai dari workflow sederhana (1 trigger + 1 action) sebelum membuat yang kompleks
Test workflow dengan skenario berbeda sebelum mengaktifkannya — pastikan trigger terpicu pada kondisi yang tepat
Gunakan task_due_approaching dengan days_before: 1 untuk reminder H-1 deadline
Kombinasikan low_stock trigger dengan send_notification ke admin untuk restock alert
Review trigger_count secara berkala — workflow yang tidak pernah trigger mungkin perlu di-adjust condition-nya
Dokumentasikan setiap workflow dengan deskripsi yang jelas agar tim lain bisa memahami tujuannya
Jangan membuat terlalu banyak workflow untuk trigger yang sama — bisa terjadi duplikasi notifikasi

Entity Relationship Diagram

Entity Schema Tables

WorkflowAutomation

Field	Type	Required	Description
`company_id`	string	No	ID perusahaan (null = personal)
`user_id`	string	Yes	Email pemilik workflow
`name`	string	Yes	Nama workflow automation
`description`	string	No	Deskripsi workflow
`trigger_type`	string (enum)	Yes	Jenis trigger workflow — 15 opsi tersedia
`trigger_conditions`	object	No	Kondisi tambahan trigger (mis: status=completed, days_before=3)
`actions`	array	No	Daftar aksi yang dijalankan saat trigger terpicu
`is_active`	boolean	No	Status aktif workflow (default: true)
`last_triggered_at`	datetime	No	Waktu terakhir trigger dijalankan
`trigger_count`	number	No	Jumlah total trigger sudah dijalankan (default: 0)

Automation

Field	Type	Required	Description
`workspace_id`	string	Yes	ID workspace tempat automasi beroperasi
`name`	string	Yes	Nama automasi
`description`	string	No	Penjelasan tentang tujuan dan cara kerja automasi ini (maks 1000 karakter)
`trigger_type`	string (enum)	Yes	Jenis trigger — 5 opsi tersedia
`trigger_conditions`	object	No	Kondisi trigger yang harus dipenuhi
`action_type`	string (enum)	Yes	Jenis aksi yang dijalankan — 5 opsi tersedia
`action_properties`	object	No	Properti aksi berupa konfigurasi detail
`is_active`	boolean	No	Status aktif automasi (default: true)

Customer

Field	Type	Required	Description
`company_id`	string	Yes	ID perusahaan pemilik data customer
`name`	string	Yes	Nama lengkap customer
`email`	string	No	Alamat email customer
`phone`	string	Yes	Nomor telepon customer
`whatsapp_number`	string	No	Nomor WhatsApp untuk follow up
`company`	string	No	Nama perusahaan customer (B2B)
`address`	string	No	Alamat lengkap customer
`customer_type`	string (enum)	No	Tipe customer (default: individual)
`membership_level_id`	string	No	ID level membership customer
`membership_level_name`	string	No	Nama level membership
`membership_since`	date	No	Sejak kapan menjadi member
`membership_points`	number	No	Total poin member saat ini (default: 0)
`lifetime_points`	number	No	Total poin sepanjang waktu (default: 0)
`stamps`	number	No	Total stamp yang dimiliki saat ini (default: 0)
`has_negative_points`	boolean	No	Flag saldo negatif akibat pembatalan/void transaksi (default: false)
`loyalty_deficit_points`	number	No	Defisit poin loyalty yang membutuhkan rekonsiliasi manual (default: 0)
`loyalty_review_notes`	string	No	Catatan review penanganan loyalty deficit
`last_tier_upgrade_date`	datetime	No	Waktu perubahan level membership terakhir
`last_tier_upgrade_reason`	string	No	Alasan perubahan level membership
`last_tier_upgrade_by`	string	No	Email operator/admin yang melakukan perubahan tier
`status`	string (enum)	No	Status customer (default: lead)
`source`	string	No	Sumber customer (ads, referral, walk-in, dll)
`tags`	array	No	Tag untuk kategorisasi customer
`lifetime_value`	number	No	Total nilai transaksi sepanjang waktu (default: 0)
`total_orders`	number	No	Jumlah transaksi (default: 0)
`average_order_value`	number	No	Rata-rata nilai transaksi (default: 0)
`last_purchase_date`	date	No	Tanggal pembelian terakhir
`last_contact_date`	date	No	Terakhir kali di-follow up
`last_contact_method`	string (enum)	No	Metode terakhir follow up
`last_contact_notes`	string	No	Catatan follow up terakhir
`birthday`	date	No	Tanggal ulang tahun customer
`preferences`	object	No	Preferensi customer (kontak, pembayaran, bahasa)
`notes`	string	No	Catatan umum mengenai customer
`auth_user_id`	string	No	ID autentikasi dari Auth provider
`default_address_id`	string	No	ID alamat default di buku alamat
`addresses`	array	No	Buku alamat tersimpan customer
`billing_address`	string	No	Alamat penagihan resmi perusahaan/customer B2B
`shipping_address`	string	No	Alamat pengiriman default B2B
`parent_customer_id`	string	No	ID perusahaan induk untuk outlet/cabang retailer
`outlet_name`	string	No	Nama cabang/outlet
`tax_id`	string	No	NPWP/Identitas administrasi pajak
`payment_terms`	string (enum)	No	Ketentuan pembayaran B2B (default: net_30)
`payment_terms_days`	number	No	Jumlah hari jatuh tempo pembayaran (default: 30)
`credit_limit`	number	No	Batas plafon riutang kredit B2B (default: 0)
`is_active`	boolean	No	Status aktif customer B2B (default: true)

Notification

Field	Type	Required	Description
`user_id`	string	Yes	Email pengguna yang menerima notifikasi
`title`	string	Yes	Judul notifikasi
`message`	string	Yes	Pesan notifikasi
`description`	string	No	Detail tambahan atau konteks dari notifikasi ini (maks 1000 karakter)
`url`	string	No	URL tujuan saat notifikasi diklik
`type`	string (enum)	No	Tipe notifikasi untuk menentukan render aksi (default: SYSTEM)
`metadata`	object	No	Payload tambahan untuk notifikasi (invitationId, companyId, companyName)
`priority`	string (enum)	No	Prioritas notifikasi (default: normal)
`is_read`	boolean	No	Status apakah notifikasi sudah dibaca (default: false)
`event_id`	string	No	Idempotency key — notif duplikat dengan event_id sama diabaikan
`company_id`	string	No	ID perusahaan untuk scope filter
`location_id`	string	No	ID lokasi untuk scope filter (opsional)
`source_entity`	string	No	Nama entity sumber (POSTransaction, Invoice, ProductionBatch, dll)
`source_id`	string	No	ID record sumber
`correlation_id`	string	No	Correlation ID dari request kritis untuk observability

EmailCampaign

Field	Type	Required	Description
`company_id`	string	No	ID perusahaan pemilik kampanye
`campaign_name`	string	Yes	Nama kampanye email
`subject`	string	Yes	Subjek email yang dikirim
`content`	string	Yes	HTML email content
`recipient_list`	array	No	Array of customer emails penerima
`send_date`	datetime	No	Tanggal dan waktu pengiriman
`status`	string (enum)	No	Status kampanye (default: draft)
`sent_count`	number	No	Jumlah email terkirim (default: 0)
`opened_count`	number	No	Jumlah email dibuka penerima (default: 0)
`clicked_count`	number	No	Jumlah link diklik penerima (default: 0)
`template_id`	string	No	ID template email yang digunakan

NewsletterSubscriber

Field	Type	Required	Description
`email`	string	Yes	Email subscriber
`name`	string	No	Nama subscriber (opsional)
`description`	string	No	Catatan atau preferensi konten yang diinginkan subscriber (maks 1000 karakter)
`subscribed_from`	string (enum)	No	Dari halaman mana subscribe (default: blog)
`is_active`	boolean	No	Status aktif subscription (default: true)
`unsubscribed_date`	datetime	No	Tanggal unsubscribe
`interests`	array	No	Topik yang diminati subscriber

CustomerLoyaltyLedger

Field	Type	Required	Description
`company_id`	string	Yes	ID perusahaan
`customer_id`	string	Yes	ID customer pemilik transaksi loyalty
`customer_name`	string	No	Nama customer saat transaksi
`customer_phone`	string	No	Nomor telepon/kontak customer
`transaction_id`	string	No	ID transaksi POS atau referensi sale asal
`transaction_number`	string	No	Nomor struk/receipt number transaksi
`idempotency_key`	string	Yes	Idempotency key untuk mencegah double crediting/posting
`event_type`	string (enum)	Yes	Tipe event mutasi loyalty
`scheme_type`	string (enum)	No	Skema loyalty yang berlaku (default: points)
`points_delta`	number	No	Perubahan poin (+ bertambah, - berkurang) (default: 0)
`points_before`	number	No	Saldo poin sebelum event (default: 0)
`points_after`	number	No	Saldo poin setelah event (default: 0)
`stamps_delta`	number	No	Perubahan stamp (+ bertambah, - berkurang) (default: 0)
`stamps_before`	number	No	Saldo stamp sebelum event (default: 0)
`stamps_after`	number	No	Saldo stamp setelah event (default: 0)
`eligible_amount`	number	No	Nilai transaksi yang sah/eligible untuk perolehan poin (default: 0)
`reason`	string	No	Alasan atau keterangan mutasi loyalty
`deficit_points`	number	No	Defisit poin jika poin telah terpakai sebelum void/return (default: 0)
`requires_manual_review`	boolean	No	Flag jika reversal menghasilkan saldo negatif (default: false)
`reward_details`	object	No	Detail reward jika event adalah redeem
`performed_by`	string	No	Email atau ID operator yang memproses
`actor_role`	string	No	Role aktor (owner, admin, cashier)
`created_at`	datetime	No	Waktu event tercatat di server
`finance_record_id`	string	No	ID FinancialRecord (biaya COGS reward) yang terhubung

CustomerMembership

Field	Type	Required	Description
`company_id`	string	Yes	ID perusahaan
`level_name`	string	Yes	Nama level (Silver, Gold, Platinum, dll)
`level_key`	string	Yes	Key unik untuk level (silver, gold, platinum)
`icon`	string	No	Icon emoji untuk level
`color`	string	No	Warna untuk level
`description`	string	No	Penjelasan mengenai keuntungan dan syarat keanggotaan (maks 1000 karakter)
`discount_percentage`	number	No	Diskon % untuk member level ini 0-100 (default: 0)
`points_multiplier`	number	No	Multiplier poin yang didapat (default: 1)
`min_purchase`	number	No	Minimum pembelian untuk mendapat level ini (default: 0)
`benefits`	array	No	List benefit yang didapat member
`priority_support`	boolean	No	Akses priority support via WhatsApp (default: false)
`free_delivery`	boolean	No	Gratis ongkir (default: false)
`birthday_bonus`	number	No	Bonus poin di hari ulang tahun (default: 0)
`is_active`	boolean	No	Status aktif level (default: true)
`order`	number	No	Urutan level (semakin tinggi semakin premium) (default: 0)
`scheme_type`	string (enum)	No	Skema loyalty yang berlaku pada tier ini (default: points)
`points_threshold`	number	No	Ambang batas belanja per perolehan poin (default: 10000)
`points_per_threshold`	number	No	Jumlah poin yang diperoleh per threshold (default: 1)
`stamps_required`	number	No	Jumlah stamp untuk reward atau naik level (default: 10)
`stamp_per_transaction`	number	No	Jumlah stamp diperoleh per transaksi eligible (default: 1)
`min_redemption_points`	number	No	Minimal poin untuk penukaran reward (default: 0)
`reward_type`	string (enum)	No	Jenis reward yang dapat ditukarkan (default: none)
`reward_value`	number	No	Nilai reward (persen/nominal diskon) (default: 0)
`reward_product_id`	string	No	ID produk reward gratis jika reward_type = free_product
`reward_product_name`	string	No	Nama produk reward gratis
`expiry_days`	number	No	Masa kedaluwarsa poin dalam hari (opsional)

ChatChannel

Field	Type	Required	Description
`company_id`	string	Yes	ID perusahaan
`channel_name`	string	Yes	Nama channel
`channel_type`	string (enum)	Yes	Tipe channel (default: public)
`description`	string	No	Deskripsi channel
`members`	array	No	Array of member emails
`admins`	array	No	Array of admin emails
`created_by`	string	No	Email pembuat channel
`is_archived`	boolean	No	Status channel diarsipkan (default: false)
`last_message`	string	No	Isi pesan terakhir
`last_message_at`	datetime	No	Waktu pesan terakhir dikirim
`unread_count`	number	No	Jumlah pesan belum dibaca (default: 0)

Discount

Field	Type	Required	Description
`company_id`	string	Yes	ID perusahaan
`discount_name`	string	Yes	Nama diskon
`discount_type`	string (enum)	Yes	Tipe diskon (default: percentage)
`value`	number	Yes	Nilai diskon (% atau nominal)
`buy_quantity`	number	No	Untuk tipe buy_x_get_y: jumlah beli
`get_quantity`	number	No	Untuk tipe buy_x_get_y: jumlah gratis
`min_purchase_amount`	number	No	Minimum pembelian (default: 0)
`max_discount_amount`	number	No	Batas maksimal nilai diskon
`applies_to`	string (enum)	No	Berlaku untuk (default: all_products)
`product_ids`	array	No	Daftar ID produk target
`category_names`	array	No	Daftar nama kategori target
`coupon_code`	string	No	Kode kupon unik
`usage_limit`	number	No	Batas penggunaan (0 = unlimited)
`used_count`	number	No	Jumlah sudah dipakai (default: 0)
`start_date`	date	No	Tanggal mulai berlaku
`end_date`	date	No	Tanggal berakhir
`is_active`	boolean	No	Status aktif diskon (default: true)
`description`	string	No	Deskripsi diskon

Voucher

Field	Type	Required	Description
`code`	string	Yes	Kode voucher unik
`name`	string	Yes	Nama voucher
`description`	string	No	Penjelasan detail voucher, syarat, dan ketentuan (maks 1000 karakter)
`discount_type`	string (enum)	Yes	Jenis potongan: persentase atau jumlah tetap
`discount_value`	number	Yes	Nilai potongan (persentase 0-100 atau jumlah dalam rupiah)
`min_purchase`	number	No	Minimum pembelian untuk menggunakan voucher (default: 0)
`max_discount`	number	No	Maksimum potongan (untuk jenis persentase)
`usage_limit`	number	No	Batas penggunaan voucher (null = unlimited)
`usage_count`	number	No	Jumlah voucher sudah digunakan (default: 0)
`valid_from`	datetime	Yes	Tanggal mulai aktif voucher
`valid_until`	datetime	Yes	Tanggal berakhir voucher
`applicable_plans`	array	No	Paket yang bisa menggunakan voucher ini
`is_active`	boolean	No	Status aktif voucher (default: true)
`created_by`	string	No	Admin yang membuat voucher

Referral

Field	Type	Required	Description
`referrer_id`	string	Yes	ID pengguna yang mengundang (referrer)
`referee_id`	string	Yes	ID pengguna yang diundang (referee)
`referee_email`	string	Yes	Email pengguna yang diundang
`referee_name`	string	No	Nama pengguna yang diundang
`description`	string	No	Catatan tambahan mengenai referral ini (maks 1000 karakter)
`status`	string (enum)	No	Status undangan (default: signed_up)

StockAlert

Field	Type	Required	Description
`company_id`	string	Yes	ID perusahaan
`inventory_id`	string	No	ID inventori
`product_id`	string	No	ID produk
`product_name`	string	No	Nama produk
`location_id`	string	No	ID lokasi
`location_name`	string	No	Nama lokasi
`alert_type`	string (enum)	Yes	Tipe alert — 11 opsi tersedia
`current_quantity`	number	No	Jumlah stok saat ini
`threshold_quantity`	number	No	Jumlah threshold untuk alert
`severity`	string (enum)	No	Tingkat keparahan (default: medium)
`status`	string (enum)	No	Status alert (default: active)
`title`	string	No	Ringkasan alert untuk tampilan daftar
`description`	string	No	Penjelasan detail anomali/kondisi
`recommended_action`	string	No	Tindakan yang disarankan sistem
`fingerprint`	string	No	Key stabil per anomali untuk mencegah notifikasi duplikat
`source`	string	No	Asal pembuat alert (mis. stock_anomaly_detector)
`entity_ref_id`	string	No	ID entitas terkait (LotBatch, StockMovement, dsb)
`movement_ids`	array	No	ID StockMovement yang memicu anomali
`detected_at`	datetime	No	Waktu anomali terdeteksi oleh scanner
`acknowledged_by`	string	No	User yang mengakui alert
`acknowledged_at`	datetime	No	Waktu alert diakui
`resolved_at`	datetime	No	Waktu alert diselesaikan
`auto_reorder_triggered`	boolean	No	Apakah auto reorder sudah dipicu (default: false)
`notes`	string	No	Catatan tambahan

SalesPipeline

Field	Type	Required	Description
`company_id`	string	Yes	ID perusahaan
`lead_id`	string	No	ID prospek/lead
`lead_name`	string	Yes	Nama prospek
`lead_email`	string	No	Email prospek
`lead_phone`	string	No	Nomor telepon prospek
`company_name`	string	No	Nama perusahaan prospek
`assigned_to`	string	Yes	ID sales person yang ditugaskan
`pipeline_stage`	string (enum)	No	Stage dalam sales pipeline (default: prospect)
`estimated_value`	number	No	Perkiraan nilai penjualan
`currency`	string	No	Mata uang (default: IDR)
`probability`	number	No	Probabilitas konversi dalam % (default: 0)
`expected_close_date`	date	No	Tanggal penutupan yang diharapkan
`actual_close_date`	date	No	Tanggal penutupan aktual
`source_lead`	string (enum)	No	Sumber prospek
`product_interest`	array	No	Produk yang diminati prospek
`interaction_history`	array	No	Riwayat interaksi dengan prospek
`next_action`	string	No	Aksi selanjutnya yang harus dilakukan
`next_action_date`	date	No	Tanggal aksi selanjutnya
`notes`	string	No	Catatan mengenai pipeline

Siklus Hidup Automation Rule

Sequence Diagrams

1. Alur Trigger Rule

2. Alur Eksekusi Kampanye Email

3. Alur Customer Journey (Loyalty & Membership)

4. Alur Pipeline Sales & Lead Automation

Referensi Enum

WorkflowAutomation — `trigger_type`

Nilai	Deskripsi
`task_created`	Task baru dibuat di modul Tasks
`task_status_changed`	Status task berubah (misal: todo → in_progress)
`task_due_approaching`	Deadline task semakin mendekat
`task_overdue`	Task melewati batas deadline
`invoice_created`	Invoice baru dibuat di modul Finance
`invoice_overdue`	Invoice melewati tanggal jatuh tempo
`new_chat_mention`	Ada mention baru di chat internal
`pos_transaction`	Transaksi POS baru terjadi
`low_stock`	Stok produk berada di bawah threshold
`employee_birthday`	Ulang tahun karyawan/customer hari ini
`leave_request`	Pengajuan cuti baru masuk
`kpi_target_missed`	Target KPI tidak tercapai
`schedule_daily`	Trigger terjadwal harian
`schedule_weekly`	Trigger terjadwal mingguan
`schedule_monthly`	Trigger terjadwal bulanan

WorkflowAutomation — `actions[].action_type`

Nilai	Deskripsi
`send_notification`	Kirim notifikasi in-app ke pengguna
`send_chat_message`	Kirim pesan ke channel chat internal
`create_task`	Buat task baru secara otomatis
`change_task_status`	Ubah status task yang sudah ada
`assign_task`	Tetapkan task ke pengguna tertentu
`create_notification_all_members`	Kirim notifikasi ke seluruh anggota perusahaan

Automation — `trigger_type`

Nilai	Deskripsi
`task_created`	Task baru dibuat dalam workspace
`task_status_changed`	Status task berubah dalam workspace
`task_due_approaching`	Deadline task dalam workspace semakin dekat
`user_assigned`	Pengguna ditugaskan ke task
`file_uploaded`	File diunggah ke workspace

Automation — `action_type`

Nilai	Deskripsi
`change_status`	Ubah status task secara otomatis
`assign_user`	Tetapkan task ke pengguna tertentu
`send_notification`	Kirim notifikasi ke pengguna
`create_subtask`	Buat sub-task baru secara otomatis
`move_to_workspace`	Pindahkan task ke workspace lain

Customer — `customer_type`

Nilai	Deskripsi
`individual`	Customer perorangan
`business`	Customer perusahaan (B2B)
`retail`	Customer ritel/end-user
`reseller`	Reseller yang menjual kembali produk
`distributor`	Distributor wilayah
`modern_market`	Pasar modern (minimarket, supermarket)

Customer — `status`

Nilai	Deskripsi
`lead`	Prospek yang belum dikonversi
`prospect`	Prospek yang sedang di-follow up
`customer`	Sudah menjadi customer aktif
`inactive`	Customer tidak aktif lagi

Customer — `last_contact_method`

Nilai	Deskripsi
`phone`	Follow up melalui telepon
`whatsapp`	Follow up melalui WhatsApp
`email`	Follow up melalui email
`meeting`	Follow up melalui pertemuan langsung

Customer — `payment_terms`

Nilai	Deskripsi
`cash`	Pembayaran tunai
`net_7`	Jatuh tempo 7 hari
`net_14`	Jatuh tempo 14 hari
`net_30`	Jatuh tempo 30 hari
`net_60`	Jatuh tempo 60 hari
`custom`	Ketentuan pembayaran khusus

Customer — `preferences.preferred_contact`

Nilai	Deskripsi
`phone`	Preferensi kontak via telepon
`whatsapp`	Preferensi kontak via WhatsApp
`email`	Preferensi kontak via email

Notification — `type`

Nilai	Deskripsi
`SYSTEM`	Notifikasi sistem umum
`INVITATION`	Undangan bergabung perusahaan
`TASK`	Notifikasi terkait task
`STOCK`	Notifikasi terkait stok
`INVOICE`	Notifikasi terkait invoice
`WORKFLOW`	Notifikasi terkait workflow automation
`ANNOUNCEMENT`	Pengumuman dari admin
`ORDER`	Notifikasi terkait pesanan
`PAYMENT`	Notifikasi terkait pembayaran
`LOW_STOCK`	Peringatan stok rendah
`DISCREPANCY`	Notifikasi ketidaksesuaian data
`EXPIRY`	Peringatan produk mendekati kedaluwarsa
`BACKUP`	Notifikasi terkait backup data
`BTT_PENDING`	Notifikasi BTT menunggu persetujuan
`PAYMENT_DUE`	Peringatan jatuh tempo pembayaran
`RECALL`	Notifikasi penarikan produk

Notification — `priority`

Nilai	Deskripsi
`low`	Prioritas rendah — tidak mendesak
`normal`	Prioritas normal — standar
`high`	Prioritas tinggi — perlu perhatian segera

EmailCampaign — `status`

Nilai	Deskripsi
`draft`	Kampanye masih dalam tahap draf
`scheduled`	Kampanye dijadwalkan untuk dikirim
`sent`	Kampanye berhasil terkirim
`failed`	Kampanye gagal terkirim

NewsletterSubscriber — `subscribed_from`

Nilai	Deskripsi
`blog`	Subscribe dari halaman blog
`home`	Subscribe dari halaman utama
`about`	Subscribe dari halaman tentang
`partnership`	Subscribe dari halaman partnership
`other`	Subscribe dari halaman lainnya

CustomerLoyaltyLedger — `event_type`

Nilai	Deskripsi
`earn`	Perolehan poin dari transaksi
`redeem`	Penukaran poin menjadi reward
`return_reversal`	Pembatalan poin akibat retur/void
`tier_upgrade`	Kenaikan tier membership
`manual_adjustment`	Penyesuaian poin manual oleh operator

CustomerLoyaltyLedger — `scheme_type`

Nilai	Deskripsi
`points`	Skema berbasis poin transaksi
`stamp`	Skema berbasis stempel per transaksi
`spending`	Skema berbasis total belanja
`visits`	Skema berbasis jumlah kunjungan
`hybrid`	Skema kombinasi beberapa metode

CustomerMembership — `scheme_type`

Nilai	Deskripsi
`points`	Tier ditentukan oleh akumulasi poin
`stamp`	Tier ditentukan oleh jumlah stamp
`spending`	Tier ditentukan oleh total belanja
`visits`	Tier ditentukan oleh frekuensi kunjungan
`hybrid`	Tier ditentukan oleh kombinasi metode

CustomerMembership — `reward_type`

Nilai	Deskripsi
`none`	Tidak ada reward yang dapat ditukar
`discount_percentage`	Reward berupa diskon persentase
`discount_amount`	Reward berupa potongan nominal
`free_product`	Reward berupa produk gratis

ChatChannel — `channel_type`

Nilai	Deskripsi
`public`	Channel terbuka untuk semua anggota
`private`	Channel terbatas untuk anggota tertentu
`direct`	Channel percakapan langsung antar pengguna

Discount — `discount_type`

Nilai	Deskripsi
`percentage`	Diskon dalam bentuk persentase
`fixed_amount`	Diskon dalam bentuk nominal tetap
`buy_x_get_y`	Beli X gratis Y produk
`coupon_code`	Diskon dengan memasukkan kode kupon

Discount — `applies_to`

Nilai	Deskripsi
`all_products`	Berlaku untuk semua produk
`specific_products`	Berlaku untuk produk tertentu saja
`specific_categories`	Berlaku untuk kategori tertentu saja

Voucher — `discount_type`

Nilai	Deskripsi
`percentage`	Potongan dalam bentuk persentase
`fixed_amount`	Potongan dalam bentuk nominal tetap

Voucher — `applicable_plans[]`

Nilai	Deskripsi
`pro`	Berlaku untuk paket Pro
`business`	Berlaku untuk paket Business
`advanced`	Berlaku untuk paket Advanced
`enterprise`	Berlaku untuk paket Enterprise

Referral — `status`

Nilai	Deskripsi
`signed_up`	Referee sudah mendaftar melalui undangan
`purchased`	Referee sudah melakukan pembelian pertama

StockAlert — `alert_type`

Nilai	Deskripsi
`low_stock`	Stok berada di bawah threshold minimum
`out_of_stock`	Stok habis sepenuhnya
`overstock`	Stok berlebih di atas kapasitas
`expiring_soon`	Produk mendekati tanggal kedaluwarsa
`reconciliation_needed`	Diperlukan rekonsiliasi data stok
`negative_stock`	Stok menunjukkan nilai negatif (anomali)
`rapid_depletion`	Stok berkurang sangat cepat
`orphaned_movement`	Pergerakan stok tanpa referensi yang jelas
`duplicate_movement`	Pergerakan stok terdeteksi duplikat
`futuristic_date`	Tanggal pergerakan stok di masa depan
`lot_negative`	Qty lot/batch menunjukkan nilai negatif

StockAlert — `severity`

Nilai	Deskripsi
`low`	Keparahan rendah — pantauan berkala
`medium`	Keparahan sedang — perlu ditinjau
`high`	Keparahan tinggi — perlu tindakan segera
`critical`	Keparahan kritis — harus ditangani sekarang

StockAlert — `status`

Nilai	Deskripsi
`active`	Alert aktif dan belum ditindaklanjuti
`acknowledged`	Alert sudah diakui oleh pengguna
`dismissed`	Alert diabaikan karena tidak relevan
`resolved`	Alert sudah diselesaikan sepenuhnya

SalesPipeline — `pipeline_stage`

Nilai	Deskripsi
`prospect`	Tahap awal — prospek baru masuk
`qualified`	Prospek sudah terqualifikasi
`proposal`	Proposal sedang disiapkan/dikirim
`negotiation`	Sedang dalam tahap negosiasi
`won`	Deal berhasil dimenangkan
`lost`	Deal gagal atau prospek menolak

SalesPipeline — `source_lead`

Nilai	Deskripsi
`website`	Prospek berasal dari website
`referral`	Prospek berasal dari referensi
`advertisement`	Prospek berasal dari iklan
`cold_call`	Prospek berasal dari telepon langsung
`social_media`	Prospek berasal dari media sosial
`event`	Prospek berasal dari acara/event
`other`	Prospek berasal dari sumber lainnya

SalesPipeline — `interaction_history[].interaction_type`

Nilai	Deskripsi
`call`	Interaksi melalui panggilan telepon
`email`	Interaksi melalui email
`meeting`	Interaksi melalui pertemuan langsung
`message`	Interaksi melalui pesan teks/chat

RBAC Permission Matrix

Berikut adalah matriks permission berbasis role (Role-Based Access Control) untuk setiap entitas yang terlibat dalam sistem Automation. Permission ditentukan berdasarkan kombinasi User.role, WorkspaceMember.role, dan admin_type/admin_tier.

Automation (Level Workspace)

Role	Create	Read	Update	Delete	Keterangan
Owner (Workspace)	Ya	Ya	Ya	Ya	Kontrol penuh atas automasi di workspace
Admin (Workspace)	Ya	Ya	Ya	Ya	Bisa mengelola automasi di workspace
Member (Workspace)	Ya	Ya	Ya (milik sendiri)	Tidak	Bisa buat automasi sendiri, hanya edit milik sendiri
Viewer (Workspace)	Tidak	Ya	Tidak	Tidak	Hanya bisa melihat automasi buatkan oleh orang lain
Non-member	Tidak	Tidak	Tidak	Tidak	Tidak memiliki akses ke workspace ini

WorkflowAutomation (Level Company)

Role	Create	Read	Update	Delete	Keterangan
Admin (Company)	Ya	Ya	Ya	Ya	Kontrol penuh atas workflow automation company
User (Company member)	Ya	Ya (milik sendiri)	Ya (milik sendiri)	Ya (milik sendiri)	Bisa buat dan kelola workflow sendiri
User (Other company)	Tidak	Tidak	Tidak	Tidak	Tidak bisa akses workflow company lain

EmailCampaign

Role	Create	Read	Update	Delete	Keterangan
Admin (Company)	Ya	Ya (semua)	Ya (semua)	Ya (semua)	Kontrol penuh atas semua campaign di company
User (Marketing)	Ya	Ya (milik sendiri)	Ya (milik sendiri)	Ya (milik sendiri)	Bisa kelola campaign yang dibuat sendiri
User (Other)	Tidak	Tidak	Tidak	Tidak	Tidak memiliki akses ke campaign

NewsletterSubscriber

Role	Create	Read	Update	Delete	Keterangan
Admin	Ya	Ya	Ya	Ya	Kontrol penuh atas daftar subscriber
User (Marketing)	Ya	Ya	Ya	Tidak	Bisa kelola subscriber tapi tidak bisa hapus
Public (self)	Ya (subscribe)	Tidak	Tidak	Ya (unsubscribe)	Hanya bisa subscribe dan unsubscribe diri sendiri

Notification

Role	Create	Read	Update	Delete	Keterangan
Admin	Ya	Ya (semua)	Ya (semua)	Ya (semua)	Bisa kirim announcement dan kelola semua notifikasi
User	Tidak	Ya (milik sendiri)	Ya (mark as read)	Tidak	Hanya bisa baca dan update status baca notifikasi sendiri
System (WorkflowEngine)	Ya	Ya	Tidak	Tidak	Otomatis kirim notifikasi dari workflow_alert dan system events

ChatChannel

Role	Create	Read	Update	Delete	Keterangan
Admin (Company)	Ya	Ya (semua)	Ya (semua)	Ya (semua)	Kontrol penuh atas semua channel di company
Admin (Channel)	Ya	Ya	Ya (channel sendiri)	Tidak	Bisa kelola channel yang di-admin
Member (Channel)	Tidak	Ya (channel sendiri)	Tidak	Tidak	Hanya bisa membaca dan mengirim pesan di channel
Non-member	Tidak	Tidak	Tidak	Tidak	Tidak bisa akses channel privat

Customer

Role	Create	Read	Update	Delete	Keterangan
Admin (Company)	Ya	Ya (semua)	Ya (semua)	Ya (semua)	Kontrol penuh atas data customer
User (Sales/Marketing)	Ya	Ya (assigned)	Ya (assigned)	Tidak	Bisa tambah dan kelola customer yang di-assign
User (Other)	Tidak	Ya (limited)	Tidak	Tidak	Hanya bisa lihat data customer terbatas

CustomerLoyaltyLedger

Role	Create	Read	Update	Delete	Keterangan
Admin (Company)	Ya	Ya (semua)	Ya (semua)	Ya (semua)	Kontrol penuh atas ledger loyalty
Cashier (POS)	Ya	Ya (transaksi sendiri)	Tidak	Tidak	Bisa catat event loyalty dari transaksi POS
User (Other)	Tidak	Ya (customer sendiri)	Tidak	Tidak	Hanya bisa lihat riwayat loyalty customer terkait

CustomerMembership

Role	Create	Read	Update	Delete	Keterangan
Admin (Company)	Ya	Ya	Ya	Ya	Bisa konfigurasi level membership dan skema loyalty
User (Marketing)	Tidak	Ya	Ya (limited)	Tidak	Bisa lihat dan update level customer
User (Other)	Tidak	Ya (level sendiri)	Tidak	Tidak	Hanya bisa lihat level membership sendiri

Discount

Role	Create	Read	Update	Delete	Keterangan
Admin (Company)	Ya	Ya	Ya	Ya	Kontrol penuh atas diskon
User (Marketing)	Ya	Ya	Ya	Tidak	Bisa buat dan kelola diskon tapi tidak hapus
Cashier (POS)	Tidak	Ya (apply)	Tidak	Tidak	Hanya bisa apply diskon saat transaksi

Voucher

Role	Create	Read	Update	Delete	Keterangan
Admin (Company)	Ya	Ya	Ya	Ya	Kontrol penuh atas voucher
User (Marketing)	Ya	Ya	Ya	Tidak	Bisa buat dan kelola voucher tapi tidak hapus
User (Other)	Tidak	Ya (available)	Tidak	Tidak	Hanya bisa lihat voucher yang tersedia untuk digunakan

StockAlert

Role	Create	Read	Update	Delete	Keterangan
Admin (Company)	Ya	Ya (semua)	Ya (semua)	Ya (semua)	Kontrol penuh atas semua alert stok
User (Inventory)	Tidak	Ya (semua)	Ya (acknowledge/resolve)	Tidak	Bisa acknowledge dan resolve alert
User (Other)	Tidak	Ya (limited)	Tidak	Tidak	Hanya bisa lihat alert stok secara terbatas

SalesPipeline

Role	Create	Read	Update	Delete	Keterangan
Admin (Company)	Ya	Ya (semua)	Ya (semua)	Ya (semua)	Kontrol penuh atas pipeline penjualan
User (Sales)	Ya	Ya (assigned)	Ya (assigned)	Ya (milik sendiri)	Bisa kelola pipeline yang di-assign
User (Other)	Tidak	Ya (limited)	Tidak	Tidak	Hanya bisa lihat pipeline secara terbatas

Referral

Role	Create	Read	Update	Delete	Keterangan
Admin	Ya	Ya (semua)	Ya (semua)	Ya (semua)	Kontrol penuh atas data referral
User	Ya (refer someone)	Ya (milik sendiri)	Tidak	Tidak	Bisa refer orang lain dan lihat status referral sendiri

Ringkasan Permission Level

Level Akses	Deskripsi
Full Control	Bisa Create, Read, Update, Delete tanpa batasan
Manage Own	Bisa Create, Read, Update data milik sendiri saja
Read All	Bisa melihat semua data tapi tidak bisa mengubah
Read Own	Hanya bisa melihat data milik sendiri
No Access	Tidak memiliki akses sama sekali ke entitas ini

Mekanisme Enforce Permission

Mekanisme	Deskripsi	Implementasi
Row Level Security (RLS)	Filter data di level database berdasarkan `company_id` dan `user_id`	Supabase RLS policies pada setiap entitas
Workspace Role Check	Validasi role user di workspace sebelum operasi	`WorkspaceMember.role` dicek di middleware
Company Isolation	Data company A tidak bisa diakses company B	Filter `company_id` pada setiap query
API-Level Validation	Validasi permission sebelum memproses request	Check di `WorkflowAutomationManager` dan `WorkflowEngine`
UI-Level Hiding	Sembunyikan tombol/fitur yang tidak bisa diakses	Conditional rendering berdasarkan role di `Automation.jsx`

​title: “Automation” description: “Workflow automation dengan 12 trigger types, 7 action types, background engine, dan integrasi Google Sheets/Slack/Discord di SNISHOP ERP.”

​Automation

​Arsitektur Komponen

​Entity WorkflowAutomation

​12 Trigger Types

​Trigger Conditions

​7 Action Types

​Recipient Options

​Workflow Engine

​Background Polling

​Multi-Action Execution

​Cross-Module Integration

​Data Scoping

​DirectMessage Integration

​Contoh Workflow

​1. Reminder Deadline Task

​2. Low Stock Alert

​3. Invoice Overdue Notification

​Cara Akses

​Flow Penggunaan

​Tips

​Entity Relationship Diagram

​Entity Schema Tables

​WorkflowAutomation

​Automation

​Customer

​Notification

​EmailCampaign

​NewsletterSubscriber

​CustomerLoyaltyLedger

​CustomerMembership

​ChatChannel

​Discount

​Voucher

​Referral

​StockAlert

​SalesPipeline

​Siklus Hidup Automation Rule

​Sequence Diagrams

​1. Alur Trigger Rule

​2. Alur Eksekusi Kampanye Email

​3. Alur Customer Journey (Loyalty & Membership)

​4. Alur Pipeline Sales & Lead Automation

​Referensi Enum

​WorkflowAutomation — trigger_type

​WorkflowAutomation — actions[].action_type

​Automation — trigger_type

​Automation — action_type

​Customer — customer_type

​Customer — status

​Customer — last_contact_method

​Customer — payment_terms

​Customer — preferences.preferred_contact

​Notification — type

​Notification — priority

​EmailCampaign — status

​NewsletterSubscriber — subscribed_from

​CustomerLoyaltyLedger — event_type

​CustomerLoyaltyLedger — scheme_type

​CustomerMembership — scheme_type

​CustomerMembership — reward_type

​ChatChannel — channel_type

​Discount — discount_type

​Discount — applies_to

​Voucher — discount_type

​Voucher — applicable_plans[]

​Referral — status

​StockAlert — alert_type

​StockAlert — severity

​StockAlert — status

​SalesPipeline — pipeline_stage

​SalesPipeline — source_lead

​SalesPipeline — interaction_history[].interaction_type

​RBAC Permission Matrix

​Automation (Level Workspace)

​WorkflowAutomation (Level Company)

​EmailCampaign

​NewsletterSubscriber

​Notification

​ChatChannel

title: “Automation” description: “Workflow automation dengan 12 trigger types, 7 action types, background engine, dan integrasi Google Sheets/Slack/Discord di SNISHOP ERP.”

Automation

Arsitektur Komponen

Entity WorkflowAutomation

12 Trigger Types

Trigger Conditions

7 Action Types

Recipient Options

Workflow Engine

Background Polling

Multi-Action Execution

Cross-Module Integration

Data Scoping

DirectMessage Integration

Contoh Workflow

1. Reminder Deadline Task

2. Low Stock Alert

3. Invoice Overdue Notification

Cara Akses

Flow Penggunaan

Tips

Entity Relationship Diagram

Entity Schema Tables

WorkflowAutomation

Automation

Customer

Notification

EmailCampaign

NewsletterSubscriber

CustomerLoyaltyLedger

CustomerMembership

ChatChannel

Discount

Voucher

Referral

StockAlert

SalesPipeline

Siklus Hidup Automation Rule

Sequence Diagrams

1. Alur Trigger Rule

2. Alur Eksekusi Kampanye Email

3. Alur Customer Journey (Loyalty & Membership)

4. Alur Pipeline Sales & Lead Automation

Referensi Enum

WorkflowAutomation — `trigger_type`

WorkflowAutomation — `actions[].action_type`

Automation — `trigger_type`

Automation — `action_type`

Customer — `customer_type`

Customer — `status`

Customer — `last_contact_method`

Customer — `payment_terms`

Customer — `preferences.preferred_contact`

Notification — `type`

Notification — `priority`

EmailCampaign — `status`

NewsletterSubscriber — `subscribed_from`

CustomerLoyaltyLedger — `event_type`

CustomerLoyaltyLedger — `scheme_type`

CustomerMembership — `scheme_type`

CustomerMembership — `reward_type`

ChatChannel — `channel_type`

Discount — `discount_type`

Discount — `applies_to`

Voucher — `discount_type`

Voucher — `applicable_plans[]`

Referral — `status`

StockAlert — `alert_type`

StockAlert — `severity`

StockAlert — `status`

SalesPipeline — `pipeline_stage`

SalesPipeline — `source_lead`

SalesPipeline — `interaction_history[].interaction_type`

RBAC Permission Matrix

Automation (Level Workspace)

WorkflowAutomation (Level Company)

EmailCampaign

NewsletterSubscriber

Notification

ChatChannel