Home

Halaman Home adalah landing page personal yang muncul setelah pengguna berhasil login ke QUINNOFSPICY ERP. Berbeda dengan Dashboard yang berfokus pada metrik bisnis secara keseluruhan, Home dirancang sebagai pusat aktivitas personal — menampilkan tugas yang perlu diselesaikan, notifikasi dari tim dan sistem, serta aktivitas terakhir yang relevan dengan peran dan perusahaan aktif pengguna. Halaman ini mengintegrasikan data dari berbagai entitas inti seperti User, Company, CompanyMember, Task, Notification, Workspace, ApprovalRequest, InternalMessage, dan Achievement untuk memberikan pengalaman yang terpersonalisasi berdasarkan role, subscription plan, dan preferensi masing-masing pengguna.

Perbedaan Home vs Dashboard

Aspek	Home	Dashboard
Fokus	Aktivitas personal & tugas	Metrik bisnis keseluruhan
Scope	Individual user dalam konteks perusahaan aktif	Seluruh perusahaan
Data	Tugas, notifikasi, feed aktivitas, achievement	Penjualan, stok, keuangan, produksi
Pengguna	Semua role (owner, admin, supervisor, employee, dll)	Terutama Owner & Manager
Update	Real-time per aktivitas	Real-time per transaksi
Tujuan	”Apa yang harus saya kerjakan hari ini?"	"Bagaimana performa bisnis saya?”
Widget Count	5 komponen utama	8+ widget + charts
Interactivity	Task completion, feed filtering, quick actions	Chart drill-down, export
Personalisasi	Berdasarkan role, preferensi, dan streak	Berdasarkan modul aktif perusahaan
Konfigurasi	`HomeSettings` + `User.preferences`	`CustomDashboardConfig`

Arsitektur Home Page

Komponen Utama

1. Feed Aktivitas & Notifikasi

Feed aktivitas menampilkan stream notifikasi dan update terbaru dari berbagai modul secara kronologis. Setiap entry dalam feed mencakup informasi dari entitas Notification dan InternalMessage.

Kolom	Deskripsi
Ikon Tipe	Menandakan tipe notifikasi (SYSTEM, TASK, STOCK, INVOICE, ORDER, dll)
Judul	Ringkasan notifikasi, misal “Stok menipis: Produk ABC”
Pesan	Detail notifikasi atau konteks tambahan
Prioritas	Indikator visual berdasarkan level prioritas (low, normal, high)
Timestamp	Waktu kejadian relatif (5 menit lalu, 1 jam lalu)
Status Baca	Indikator `is_read` — badge biru untuk belum dibaca
Tombol Aksi	Aksi kontekstual berdasarkan tipe (Terima/Tolak untuk INVITATION, dll)

Filter Feed:

Semua — tampilkan semua notifikasi dari seluruh modul dan tipe
Belum Dibaca — hanya notifikasi dengan is_read = false
Prioritas Tinggi — notifikasi dengan priority = high
Tugas Saya — notifikasi bertipe TASK yang melibatkan pengguna langsung
Tim — notifikasi dari anggota tim dalam perusahaan aktif
Sistem — notifikasi otomatis dari sistem (tipe SYSTEM, LOW_STOCK, EXPIRY, BACKUP)

Feed Entry Schema (berdasarkan entitas Notification):

Field	Type	Required	Deskripsi
`user_id`	String	Ya	Email pengguna yang menerima notifikasi
`title`	String	Ya	Judul notifikasi
`message`	String	Ya	Pesan notifikasi
`description`	String	Tidak	Detail tambahan atau konteks (maks 1000 karakter)
`url`	String	Tidak	URL tujuan saat notifikasi diklik
`type`	Enum	Tidak	Tipe notifikasi: SYSTEM, INVITATION, TASK, STOCK, INVOICE, WORKFLOW, ANNOUNCEMENT, ORDER, PAYMENT, LOW_STOCK, DISCREPANCY, EXPIRY, BACKUP, BTT_PENDING, PAYMENT_DUE, RECALL
`metadata`	Object	Tidak	Payload tambahan (invitationId, companyId, companyName)
`priority`	Enum	Tidak	Prioritas: low, normal, high (default: normal)
`is_read`	Boolean	Tidak	Status apakah sudah dibaca (default: false)
`event_id`	String	Tidak	Idempotency key — format `{type}:{entity}:{id}`
`company_id`	String	Tidak	ID perusahaan untuk scope filter
`location_id`	String	Tidak	ID lokasi untuk scope filter (opsional)
`source_entity`	String	Tidak	Nama entity sumber (POSTransaction, Invoice, ProductionBatch, dll)
`source_id`	String	Tidak	ID record sumber
`correlation_id`	String	Tidak	Correlation ID untuk observability (NFR-04)

2. Panel Tugas & Reminder

Panel ini menampilkan daftar tugas yang perlu diselesaikan, diurutkan berdasarkan prioritas dan deadline. Data diambil dari entitas Task dan RecurringTask yang terkait dengan pengguna melalui assignee_id atau workspace_id.

Status	Warna	Deskripsi
Urgent	Merah	Deadline hari ini atau sudah overdue
High	Oranye	Deadline 1-2 hari ke depan
Medium	Biru	Deadline minggu ini
Low	Abu-abu	Tidak ada deadline spesifik

Fitur Tugas:

Snooze — tunda tugas untuk muncul lagi nanti (1 jam, besok, atau custom)
Quick Complete — tandai selesai langsung dari Home tanpa buka detail (mengubah status ke completed)
Delegasi — tugaskan ke anggota tim lain melalui assignee_id jika memiliki hak akses can_edit_tasks
Link ke Sumber — setiap tugas terhubung ke halaman terkait (invoice, PO, dll)
Time Tracking — catat waktu pengerjaan melalui time_entries jika is_time_tracked = true
Sub-tasks — tugas dapat memiliki sub-tugas melalui parent_task_id dan sub_tasks

Task Entity Schema (dari entitas Task):

Field	Type	Required	Deskripsi
`workspace_id`	String	Ya	ID workspace tempat tugas berada
`company_id`	String	Tidak	ID perusahaan (null untuk personal)
`title`	String	Ya	Judul tugas
`content`	String	Tidak	Detail/deskripsi tugas
`status`	Enum	Tidak	Status: todo, in_progress, completed, done (default: todo)
`priority`	Enum	Tidak	Prioritas: low, medium, high, urgent (default: medium)
`due_date`	DateTime	Tidak	Batas waktu penyelesaian
`assignee_id`	String	Tidak	ID pengguna yang ditugaskan
`tags`	String[]	Tidak	Label/tag custom untuk kategorisasi
`estimated_time`	Number	Tidak	Estimasi waktu dalam menit
`actual_time`	Number	Tidak	Waktu aktual yang dihabiskan dalam menit
`is_time_tracked`	Boolean	Tidak	Apakah time tracking aktif (default: false)
`time_entries`	Array	Tidak	Daftar entri waktu (start, end, duration)
`parent_task_id`	String	Tidak	ID parent task untuk sub-tasks
`sub_tasks`	String[]	Tidak	Array of sub-task IDs
`recurring_task_id`	String	Tidak	ID recurring task jika dibuat otomatis
`completed_at`	DateTime	Tidak	Timestamp saat tugas diselesaikan
`reminder_sent`	Boolean	Tidak	Apakah reminder sudah dikirim (default: false)
`google_event_id`	String	Tidak	ID event pada Google Calendar
`reminder_config`	Object	Tidak	Konfigurasi notifikasi sebelum tugas

3. Kartu Ringkasan

Kartu informasi singkat yang memberikan gambaran kondisi bisnis hari ini berdasarkan data dari perusahaan aktif pengguna (User.active_company_id):

Kartu	Isi	Sumber Data	Aksi Cepat
Penjualan Hari Ini	Total transaksi & revenue	`CompanyPOSTransaction`	Klik → buka modul POS
Order Baru	Jumlah order masuk belum diproses	`MarketplaceOrder`, `ProductOrder`	Klik → buka modul Order
Stok Menipis	Jumlah produk di bawah minimum	`CompanyPOSInventory`	Klik → buka Inventory Alert
Approval Pending	Dokumen menunggu approval	`ApprovalRequest` (status: pending)	Klik → buka approval queue
Tugas Hari Ini	Jumlah tugas dengan deadline hari ini	`Task` (due_date = today)	Klik → buka Panel Tugas

4. Kalender Mini

Widget kalender yang menampilkan jadwal penting dari berbagai sumber:

Deadline Tugas — tugas dengan due_date terdekat dari entitas Task
Recurring Tasks — tugas berulang dari entitas RecurringTask berdasarkan frequency dan days_of_week
Approval Deadline — batas waktu persetujuan dari ApprovalRequest
Event Perusahaan — jadwal shift dari CompanyMember.working_hours

5. Shortcut Kontekstual

Shortcut yang ditampilkan berdasarkan peran pengguna (CompanyMember.role) dan profil akses menu (MenuAccessProfile):

Role	Shortcut yang Ditampilkan
Owner	Laporan Keuangan, Dashboard Analytics, Approval, Manajemen Member
Admin	Dashboard, Manajemen Tugas, Laporan, Pengaturan
Supervisor	Monitoring Tim, Approval, Laporan Shift
Store Admin	Transaksi Baru, Buka Kasir, Tutup Kasir, Laporan POS
Stock Admin	Stock Opname, Terima Barang, Transfer Stok, Inventory Alert
Finance Admin	Invoice Baru, Catat Expense, Rekonsiliasi, Laporan Keuangan
HR Admin	Absensi, Leave Approval, Payroll, Manajemen Karyawan
Transaction Admin	Transaksi Baru, Riwayat Transaksi, Retur
Employee	Tugas Saya, Notifikasi, Kalender
Production Operator	Production Order Baru, QC Check, BOM List
QC Inspector	QC Check, HACCP Verification, Quality Report
Sales Marketing	Pelanggan Baru, Order Baru, Kirim WhatsApp
Partner Distributor	Distribution Order, Shipment, Invoice B2B

6. Panel Gamifikasi & Achievement

Panel yang menampilkan progres gamifikasi berdasarkan entitas Achievement dan statistik produktivitas pengguna (User):

Metrik	Sumber	Deskripsi
Productivity Score	`User.productivity_score`	Skor produktivitas kumulatif
Current Streak	`User.current_streak`	Hari berturut-turut menyelesaikan tugas
Longest Streak	`User.longest_streak`	Rekor hari berturut-turut terbaik
Level	`User.user_level`	Level berdasarkan achievement points
Achievement Points	`User.achievement_points`	Total poin pencapaian
Total Tasks Completed	`User.total_tasks_completed`	Akumulasi tugas yang diselesaikan
Total Notes Created	`User.total_notes_created`	Akumulasi catatan yang dibuat

Feed Aktivitas — Detail Arsitektur

Flow Penggunaan Harian

Notifikasi & Alert

Sistem notifikasi di Home menggunakan entitas Notification yang terbagi menjadi beberapa tipe dan prioritas. Setiap notifikasi memiliki mekanisme idempotency melalui event_id untuk mencegah duplikasi.

Kategori	Tipe Notifikasi	Contoh	Prioritas Default
Transaksi	ORDER, PAYMENT	Order baru, pembayaran diterima	Normal
Inventori	STOCK, LOW_STOCK	Stok menipis, barang masuk	High
Produksi	SYSTEM	Batch selesai, QC failed, EXPIRY	High
Keuangan	INVOICE, PAYMENT_DUE	Invoice overdue, BTT pending	High
Tim	TASK, ANNOUNCEMENT	Tugas baru, mention di komentar	Normal
Workflow	WORKFLOW	Approval request, workflow alert	Normal
Undangan	INVITATION	Undangan bergabung perusahaan	Normal
Sistem	SYSTEM, BACKUP, RECALL	Maintenance, backup selesai, product recall	Low
Discrepancy	DISCREPANCY	Selisih stock opname	High

Notifikasi vs Tugas

Cara Akses

Metode	Cara
Setelah Login	Otomatis diarahkan ke Home
Sidebar	Klik ikon Rumah di pojok kiri atas sidebar
Keyboard	Tekan tombol `Home` di keyboard
Breadcrumb	Klik “Home” di breadcrumb navigation

Tips

Jadikan Home sebagai starting point setiap hari kerja untuk melihat apa yang perlu ditindaklanjuti sebelum mulai aktivitas lain
Selesaikan tugas urgent di Home sebelum pindah ke modul lain supaya tidak ada yang terlewat
Gunakan fitur snooze untuk tugas yang belum bisa dikerjakan sekarang — tugas akan muncul lagi sebagai reminder
Filter feed berdasarkan “Tugas Saya” jika kamu hanya ingin fokus pada tugas personal tanpa terganggu aktivitas tim
Kustomisasi shortcut dengan frequently used actions supaya akses ke fitur favorit lebih cepat

Entity Relationship Diagram

Entity Schema Tables

HomeSettings

Field	Type	Required	Description
`setting_key`	string	Ya	Kunci pengaturan unik, gunakan nilai `'main'` untuk konfigurasi utama
`description`	string	Tidak	Penjelasan mengenai konfigurasi halaman utama ini (maks. 1000 karakter)
`hero_title`	string	Tidak	Judul utama yang ditampilkan pada hero section halaman Home
`hero_subtitle`	string	Tidak	Subtitle yang ditampilkan di bawah judul hero
`hero_cta_text`	string	Tidak	Teks pada tombol call-to-action di hero section
`hero_image_url`	string	Tidak	URL gambar yang ditampilkan pada hero section
`features`	array[object]	Tidak	Daftar fitur utama yang ditampilkan, masing-masing memiliki `title`, `description`, dan `icon`
`testimonials`	array[object]	Tidak	Testimoni pengguna yang ditampilkan, masing-masing memiliki `name`, `role`, `content`, dan `avatar_url`
`stats`	object	Tidak	Statistik aplikasi berisi `users`, `tasks`, dan `workspaces` dalam tipe number
`contact_email`	string	Tidak	Alamat email kontak, default: `snishopsolusinetwork@gmail.com`
`contact_whatsapp`	string	Tidak	Nomor WhatsApp kontak, default: `081532168812`
`social_links`	object	Tidak	Tautan media sosial dengan key `facebook`, `instagram`, `twitter`, dan `linkedin`

Notification

Field	Type	Required	Description
`user_id`	string	Ya	Email pengguna yang menerima notifikasi
`title`	string	Ya	Judul notifikasi yang ditampilkan kepada pengguna
`message`	string	Ya	Pesan utama notifikasi
`description`	string	Tidak	Detail tambahan atau konteks dari notifikasi (maks. 1000 karakter)
`url`	string	Tidak	URL tujuan saat notifikasi diklik oleh pengguna
`type`	enum	Tidak	Tipe notifikasi untuk menentukan render aksi, default: `SYSTEM`
`metadata`	object	Tidak	Payload tambahan berisi `invitationId`, `companyId`, `companyName` untuk konteks notifikasi
`priority`	enum	Tidak	Prioritas notifikasi: `low`, `normal`, atau `high`, default: `normal`
`is_read`	boolean	Tidak	Status apakah notifikasi sudah dibaca, default: `false`
`event_id`	string	Tidak	Idempotency key dengan format `{type}:{entity}:{id}` untuk mencegah notifikasi duplikat
`company_id`	string	Tidak	ID perusahaan untuk filter scope notifikasi
`location_id`	string	Tidak	ID lokasi untuk filter scope notifikasi (opsional)
`source_entity`	string	Tidak	Nama entity sumber seperti POSTransaction, Invoice, ProductionBatch
`source_id`	string	Tidak	ID record sumber yang memicu notifikasi
`correlation_id`	string	Tidak	Correlation ID dari request kritis untuk keperluan observability (NFR-04)

Task

Field	Type	Required	Description
`workspace_id`	string	Ya	ID workspace tempat tugas ini berada
`company_id`	string	Tidak	ID perusahaan, null untuk tugas personal
`title`	string	Ya	Judul tugas yang ditampilkan
`content`	string	Tidak	Isi atau deskripsi detail tugas
`status`	enum	Tidak	Status tugas: `todo`, `in_progress`, `completed`, atau `done`, default: `todo`
`priority`	enum	Tidak	Tingkat prioritas: `low`, `medium`, `high`, atau `urgent`, default: `medium`
`due_date`	datetime	Tidak	Batas waktu penyelesaian tugas
`assignee_id`	string	Tidak	ID pengguna yang ditugaskan mengerjakan tugas ini
`tags`	array[string]	Tidak	Label atau tag untuk kategorisasi tugas
`estimated_time`	number	Tidak	Estimasi waktu penyelesaian dalam satuan menit
`actual_time`	number	Tidak	Waktu aktual yang dihabiskan dalam satuan menit
`is_time_tracked`	boolean	Tidak	Penanda apakah waktu pengerjaan dilacak, default: `false`
`time_entries`	array[object]	Tidak	Daftar catatan waktu, masing-masing berisi `start`, `end`, dan `duration`
`parent_task_id`	string	Tidak	ID parent task untuk relasi sub-tugas hierarkis
`sub_tasks`	array[string]	Tidak	Array berisi ID dari sub-task yang terkait
`recurring_task_id`	string	Tidak	ID RecurringTask jika tugas ini dibuat secara otomatis oleh jadwal berulang
`completed_at`	datetime	Tidak	Timestamp saat tugas ditandai selesai
`reminder_sent`	boolean	Tidak	Penanda apakah reminder sudah dikirimkan, default: `false`
`google_event_id`	string	Tidak	ID event pada Google Calendar untuk sinkronisasi kalender
`reminder_config`	object	Tidak	Konfigurasi notifikasi reminder sebelum tugas jatuh tempo

CustomDashboardConfig

Field	Type	Required	Description
`company_id`	string	Ya	ID perusahaan pemilik dashboard
`user_id`	string	Ya	ID pengguna yang membuat konfigurasi dashboard
`dashboard_name`	string	Ya	Nama dashboard yang ditampilkan
`description`	string	Tidak	Deskripsi singkat mengenai dashboard
`role`	string	Tidak	Role yang diizinkan mengakses dashboard ini (opsional)
`is_public`	boolean	Tidak	Apakah dashboard dapat diakses oleh anggota lain, default: `false`
`widgets`	array[object]	Ya	Daftar widget yang ditampilkan pada dashboard
`layout`	enum	Tidak	Tata letak dashboard: `grid` atau `list`, default: `grid`
`created_date`	datetime	Tidak	Timestamp kapan dashboard pertama kali dibuat
`last_modified_date`	datetime	Tidak	Timestamp terakhir kali dashboard dimodifikasi

Struktur Widget (dalam array widgets):

Field	Type	Description
`widget_id`	string	Identifier unik untuk widget
`widget_type`	enum	Tipe widget: `chart`, `table`, `metric`, `list`, `calendar`, atau `forecast`
`title`	string	Judul widget yang ditampilkan
`data_source`	string	Tipe entity sumber data (Invoice, FinancialRecord, dll)
`filters`	object	Konfigurasi filter data untuk widget
`chart_type`	enum	Tipe visualisasi chart: `line`, `bar`, `pie`, atau `area`
`position`	object	Posisi widget berisi `row`, `column`, `width`, dan `height`
`refresh_interval`	number	Interval auto-refresh dalam satuan detik

StockAlert

Field	Type	Required	Description
`company_id`	string	Ya	ID perusahaan tempat alert ini berlaku
`inventory_id`	string	Tidak	ID record inventori yang terkait
`product_id`	string	Tidak	ID produk yang memicu alert
`product_name`	string	Tidak	Nama produk yang terkait
`location_id`	string	Tidak	ID lokasi gudang tempat alert terdeteksi
`location_name`	string	Tidak	Nama lokasi gudang
`alert_type`	enum	Ya	Tipe alert stok, menentukan kategori anomali yang terdeteksi
`current_quantity`	number	Tidak	Jumlah stok saat ini
`threshold_quantity`	number	Tidak	Jumlah ambang batas yang memicu alert
`severity`	enum	Tidak	Tingkat keparahan: `low`, `medium`, `high`, atau `critical`, default: `medium`
`status`	enum	Tidak	Status penanganan: `active`, `acknowledged`, `dismissed`, atau `resolved`, default: `active`
`title`	string	Tidak	Ringkasan singkat alert untuk tampilan daftar
`description`	string	Tidak	Penjelasan detail mengenai anomali atau kondisi yang terdeteksi
`recommended_action`	string	Tidak	Tindakan yang disarankan oleh sistem untuk menangani alert
`fingerprint`	string	Tidak	Key stabil per anomali untuk mencegah notifikasi duplikat antar perangkat
`source`	string	Tidak	Asal deteksi alert, misalnya `stock_anomaly_detector`
`entity_ref_id`	string	Tidak	ID entitas terkait seperti LotBatch atau StockMovement
`movement_ids`	array[string]	Tidak	Array ID StockMovement yang memicu anomali
`detected_at`	datetime	Tidak	Timestamp kapan anomali terdeteksi oleh scanner
`acknowledged_by`	string	Tidak	ID pengguna yang mengakui alert
`acknowledged_at`	datetime	Tidak	Timestamp kapan alert diakui
`resolved_at`	datetime	Tidak	Timestamp kapan alert diselesaikan
`auto_reorder_triggered`	boolean	Tidak	Penanda apakah proses reorder otomatis sudah dipicu, default: `false`
`notes`	string	Tidak	Catatan tambahan dari pengguna terkait penanganan alert

ApprovalRequest

Field	Type	Required	Description
`company_id`	string	Ya	ID perusahaan tempat approval diajukan
`workflow_id`	string	Ya	ID ApprovalWorkflow yang mengatur alur persetujuan
`document_type`	string	Ya	Tipe dokumen yang memerlukan persetujuan
`document_id`	string	Ya	ID dokumen yang diminta persetujuan
`requester_id`	string	Ya	ID pengguna yang mengajukan persetujuan
`submission_date`	datetime	Tidak	Tanggal dan waktu pengajuan
`amount`	number	Tidak	Jumlah nilai dokumen (jika ada)
`description`	string	Tidak	Deskripsi atau catatan pengajuan
`current_approval_level`	number	Tidak	Level approval yang sedang aktif, default: `1`
`approval_history`	array[object]	Tidak	Riwayat approval per level, berisi `level`, `approver_id`, `approval_date`, `status`, dan `comments`
`overall_status`	enum	Tidak	Status keseluruhan: `pending`, `approved`, `rejected`, atau `on_hold`, default: `pending`
`final_approval_date`	datetime	Tidak	Timestamp saat approval final diberikan

RecurringTask

Field	Type	Required	Description
`task_id`	string	Tidak	ID tugas template yang menjadi acuan
`workspace_id`	string	Ya	ID workspace tempat tugas berulang dibuat
`title`	string	Ya	Judul tugas yang akan dibuat berulang
`content`	string	Tidak	Isi atau deskripsi tugas
`frequency`	enum	Ya	Frekuensi pengulangan: `daily`, `weekly`, `monthly`, atau `yearly`
`interval`	number	Tidak	Interval pengulangan, default: `1` (setiap 1 periode)
`days_of_week`	array[number]	Tidak	Array hari dalam seminggu (0-6) untuk jadwal weekly
`day_of_month`	number	Tidak	Hari dalam sebulan untuk jadwal monthly
`start_date`	datetime	Ya	Tanggal mulai berlakunya tugas berulang
`end_date`	datetime	Tidak	Tanggal berakhirnya tugas berulang (opsional)
`is_active`	boolean	Tidak	Penanda apakah jadwal berulang masih aktif, default: `true`
`last_generated`	datetime	Tidak	Timestamp terakhir kali tugas baru dibuat dari jadwal
`priority`	enum	Tidak	Prioritas tugas: `low`, `medium`, `high`, atau `urgent`, default: `medium`
`assignee_id`	string	Tidak	ID pengguna yang ditugaskan secara default

AuditLog

Field	Type	Required	Description
`company_id`	string	Ya	ID perusahaan tempat aksi dilakukan
`user_id`	string	Ya	ID pengguna yang melakukan aksi
`user_email`	string	Tidak	Email pengguna yang melakukan aksi
`action`	enum	Ya	Aksi yang dilakukan terhadap entitas
`entity_type`	string	Ya	Tipe entitas yang diakses (Task, Invoice, Product, dll)
`entity_id`	string	Tidak	ID entitas yang diakses
`old_value`	object	Tidak	Nilai lama sebelum perubahan (khusus aksi update)
`new_value`	object	Tidak	Nilai baru setelah perubahan (khusus aksi update)
`timestamp`	datetime	Ya	Waktu kejadian aksi dicatat
`ip_address`	string	Tidak	Alamat IP dari mana aksi dilakukan
`device_info`	string	Tidak	User Agent atau informasi device pengguna
`description`	string	Tidak	Deskripsi detail mengenai aksi yang dilakukan
`status`	enum	Tidak	Status eksekusi: `success` atau `failed`, default: `success`

Comment

Field	Type	Required	Description
`entity_type`	enum	Ya	Jenis entitas yang dikomentari: `task` atau `note`
`entity_id`	string	Ya	ID dari task atau note yang dikomentari
`workspace_id`	string	Tidak	ID workspace tempat komentar dibuat
`content`	string	Ya	Isi teks komentar
`user_id`	string	Ya	ID pengguna yang menulis komentar
`user_name`	string	Tidak	Nama lengkap pengguna saat komentar ditulis
`user_email`	string	Tidak	Email pengguna saat komentar ditulis
`mentions`	array[string]	Tidak	Array ID pengguna yang di-mention dalam komentar
`parent_comment_id`	string	Tidak	ID parent comment untuk membalas komentar lain (threaded)
`edited_at`	datetime	Tidak	Timestamp terakhir kali komentar diedit

Workspace

Field	Type	Required	Description
`company_id`	string	Tidak	ID perusahaan, null untuk workspace personal
`name`	string	Ya	Nama workspace yang ditampilkan
`description`	string	Tidak	Deskripsi singkat mengenai workspace
`icon`	string	Tidak	Icon atau emoji yang mewakili workspace
`color`	string	Tidak	Warna tema workspace dalam format hex, default: `#2563eb`
`owner_id`	string	Ya	ID pengguna pemilik workspace
`is_personal`	boolean	Tidak	Penanda apakah workspace bersifat pribadi, default: `false`
`settings`	object	Tidak	Pengaturan workspace berisi `allow_public_sharing` dan `default_task_priority`

WorkspaceMember

Field	Type	Required	Description
`workspace_id`	string	Ya	ID workspace yang diikuti
`user_id`	string	Ya	Email pengguna anggota workspace
`role`	enum	Tidak	Peran dalam workspace: `owner`, `admin`, `member`, atau `viewer`, default: `member`
`invited_by`	string	Tidak	Email pengguna yang mengundang anggota ini
`joined_at`	datetime	Tidak	Timestamp kapan anggota bergabung
`description`	string	Tidak	Catatan atau keterangan tambahan mengenai anggota (maks. 1000 karakter)
`permissions`	object	Tidak	Hak akses anggota berisi `can_create_tasks`, `can_edit_tasks`, `can_delete_tasks`, `can_invite_members`, `can_access_all_tasks`

Status Lifecycle — State Diagrams

Task Status Lifecycle

Notification Read State

StockAlert Status Lifecycle

ApprovalRequest Status Lifecycle

Sequence Diagrams — Alur Data Utama

1. Pemuatan Halaman Home

3. Pengiriman Notifikasi

4. Penanganan StockAlert dari Deteksi hingga Resolusi

Referensi Enum

Notification Type

Nilai	Deskripsi
`SYSTEM`	Notifikasi sistem umum dari platform
`INVITATION`	Undangan bergabung ke workspace atau perusahaan
`TASK`	Notifikasi terkait tugas baru atau pembaruan tugas
`STOCK`	Notifikasi perubahan stok umum
`INVOICE`	Notifikasi terkait invoice (baru, jatuh tempo, dibayar)
`WORKFLOW`	Notifikasi alur kerja atau approval
`ANNOUNCEMENT`	Pengumuman dari admin atau sistem
`ORDER`	Notifikasi order baru atau pembaruan status order
`PAYMENT`	Notifikasi terkait pembayaran diterima atau gagal
`LOW_STOCK`	Peringatan stok produk menipis di bawah threshold
`DISCREPANCY`	Peringatan ketidaksesuaian stok (anomali)
`EXPIRY`	Peringatan produk mendekati tanggal kedaluwarsa
`BACKUP`	Notifikasi status backup data perusahaan
`BTT_PENDING`	Peringatan transaksi BTT (Buyer Take Take) yang menggantung
`PAYMENT_DUE`	Peringatan tagihan atau pembayaran yang jatuh tempo
`RECALL`	Notifikasi penarikan produk (recall)

Notification Priority

Nilai	Deskripsi
`low`	Prioritas rendah, tidak mendesak — ditampilkan tanpa badge khusus
`normal`	Prioritas standar — ditampilkan sebagai notifikasi biasa
`high`	Prioritas tinggi — ditampilkan dengan badge merah dan push notification

Task Status

Nilai	Deskripsi
`todo`	Tugas baru yang belum dimulai pengerjaannya
`in_progress`	Tugas sedang dalam proses pengerjaan
`completed`	Tugas telah selesai dikerjakan, menunggu verifikasi
`done`	Tugas telah diverifikasi dan sepenuhnya selesai

Task Priority

Nilai	Deskripsi
`low`	Prioritas rendah — dapat dikerjakan setelah tugas lain selesai
`medium`	Prioritas sedang — prioritas default untuk tugas baru
`high`	Prioritas tinggi — perlu diselesaikan dalam 1-2 hari
`urgent`	Prioritas mendesak — harus diselesaikan hari ini atau sudah overdue

StockAlert — Alert Type

Nilai	Deskripsi
`low_stock`	Stok produk berada di bawah threshold minimum
`out_of_stock`	Stok produk habis (jumlah = 0)
`overstock`	Stok produk melebihi kapasitas atau batas maksimum
`expiring_soon`	Produk mendekati tanggal kedaluwarsa
`reconciliation_needed`	Diperlukan rekonsiliasi stok antara sistem dan fisik
`negative_stock`	Stok menunjukkan nilai negatif (anomali)
`rapid_depletion`	Stok berkurang secara tidak wajar dalam periode singkat
`orphaned_movement`	Pergerakan stok tanpa referensi dokumen yang valid
`duplicate_movement`	Pergerakan stok terdeteksi duplikat
`futuristic_date`	Tanggal pergerakan stok berada di masa depan (anomali)
`lot_negative`	Nomor lot menunjukkan kuantitas negatif

StockAlert — Severity

Nilai	Deskripsi
`low`	Keparahan rendah — informasi, tidak perlu tindakan segera
`medium`	Keparahan sedang — perlu perhatian dalam waktu dekat
`high`	Keparahan tinggi — perlu tindakan segera
`critical`	Keparahan kritis — harus ditangani sekarang, bisa mengganggu operasional

StockAlert — Status

Nilai	Deskripsi
`active`	Alert baru terdeteksi dan belum ditindaklanjuti
`acknowledged`	Alert sudah diakui oleh pengguna namun belum diselesaikan
`dismissed`	Alert diabaikan karena dianggap tidak relevan
`resolved`	Alert telah diselesaikan dan masalah ditangani

ApprovalRequest — Overall Status

Nilai	Deskripsi
`pending`	Approval sedang menunggu keputusan dari approver
`approved`	Semua level approval telah menyetujui dokumen
`rejected`	Salah satu level approval menolak dokumen
`on_hold`	Approval ditunda sementara untuk review tambahan

ApprovalRequest — Approval History Status

Nilai	Deskripsi
`approved`	Approver menyetujui dokumen pada level ini
`rejected`	Approver menolak dokumen pada level ini
`pending`	Approver belum memberikan keputusan pada level ini

RecurringTask — Frequency

Nilai	Deskripsi
`daily`	Tugas diulang setiap hari (dengan interval)
`weekly`	Tugas diulang setiap minggu pada hari tertentu
`monthly`	Tugas diulang setiap bulan pada tanggal tertentu
`yearly`	Tugas diulang setiap tahun pada tanggal tertentu

AuditLog — Action

Nilai	Deskripsi
`create`	Pengguna membuat record baru
`read`	Pengguna mengakses atau melihat record
`update`	Pengguna memperbarui data pada record
`delete`	Pengguna menghapus record
`approve`	Pengguna menyetujui dokumen atau request
`reject`	Pengguna menolak dokumen atau request
`lock`	Pengguna mengunci record agar tidak dapat diubah
`unlock`	Pengguna membuka kunci record
`unlock_request`	Pengguna mengajukan permintaan untuk membuka kunci record

AuditLog — Status

Nilai	Deskripsi
`success`	Aksi berhasil dieksekusi tanpa error
`failed`	Aksi gagal dieksekusi (misalnya karena validasi atau permission)

Nilai	Deskripsi
`chart`	Widget visualisasi grafik (line, bar, pie, area)
`table`	Widget tampilan data dalam format tabel
`metric`	Widget angka metrik tunggal (KPI card)
`list`	Widget daftar item (feed aktivitas, tugas, dll)
`calendar`	Widget tampilan kalender dengan event
`forecast`	Widget prediksi atau proyeksi data

CustomDashboardConfig — Chart Type

Nilai	Deskripsi
`line`	Grafik garis — cocok untuk tren data dari waktu ke waktu
`bar`	Grafik batang — cocok untuk perbandingan antar kategori
`pie`	Grafik lingkaran — cocok untuk proporsi atau distribusi
`area`	Grafik area — cocok untuk volume data kumulatif

CustomDashboardConfig — Layout

Nilai	Deskripsi
`grid`	Tata letak grid — widget disusun dalam grid yang dapat dikustomisasi
`list`	Tata letak daftar — widget disusun secara vertikal berurutan

WorkspaceMember — Role

Nilai	Deskripsi
`owner`	Pemilik workspace dengan akses penuh, bisa ada multiple owners
`admin`	Administrator workspace dengan hak kelola anggota dan pengaturan
`member`	Anggota biasa yang dapat membuat dan mengedit tugas sendiri
`viewer`	Hanya dapat melihat tugas, tidak dapat membuat atau mengubah

Comment — Entity Type

Nilai	Deskripsi
`task`	Komentar ditujukan untuk entitas Task
`note`	Komentar ditujukan untuk entitas Note

Related Documentation:

​title: “Home” description: “Landing page personal setelah login dengan feed aktivitas terbaru, tugas pending, notifikasi real-time, dan shortcut kontekstual ke fitur utama QUINNOFSPICY ERP.”

​Home

​Perbedaan Home vs Dashboard

​Arsitektur Home Page

​Komponen Utama

​1. Feed Aktivitas & Notifikasi

​2. Panel Tugas & Reminder

​3. Kartu Ringkasan

​4. Kalender Mini

​5. Shortcut Kontekstual

​6. Panel Gamifikasi & Achievement

​Feed Aktivitas — Detail Arsitektur

​Flow Penggunaan Harian

​Notifikasi & Alert

​Notifikasi vs Tugas

​Cara Akses

​Tips

​Entity Relationship Diagram

​Entity Schema Tables

​HomeSettings

​Notification

​Task

​CustomDashboardConfig

​StockAlert

​ApprovalRequest

​RecurringTask

​AuditLog

​Comment

​Workspace

​WorkspaceMember

​Status Lifecycle — State Diagrams

​Task Status Lifecycle

​Notification Read State

​StockAlert Status Lifecycle

​ApprovalRequest Status Lifecycle

​Sequence Diagrams — Alur Data Utama

​1. Pemuatan Halaman Home

​2. Widget Refresh pada CustomDashboardConfig

​3. Pengiriman Notifikasi

​4. Penanganan StockAlert dari Deteksi hingga Resolusi

​Referensi Enum

​Notification Type

​Notification Priority

​Task Status

​Task Priority

​StockAlert — Alert Type

​StockAlert — Severity

​StockAlert — Status

​ApprovalRequest — Overall Status

​ApprovalRequest — Approval History Status

​RecurringTask — Frequency

​AuditLog — Action

​AuditLog — Status

​CustomDashboardConfig — Widget Type

​CustomDashboardConfig — Chart Type

​CustomDashboardConfig — Layout

​WorkspaceMember — Role

​Comment — Entity Type

title: “Home” description: “Landing page personal setelah login dengan feed aktivitas terbaru, tugas pending, notifikasi real-time, dan shortcut kontekstual ke fitur utama QUINNOFSPICY ERP.”