> ## Documentation Index
> Fetch the complete documentation index at: https://docs.quinnsambal.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Documents
***
title: "Documents — Manajemen Dokumen"
description: "Manajemen dokumen terpusat dengan Cloudinary upload, image compression, 6 kategori, search, sharing, versioning, approval workflow, dan access control di SNISHOP ERP."
-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
# Documents — Manajemen Dokumen
Halaman Documents adalah pusat penyimpanan dan manajemen seluruh dokumen bisnis kamu. Dibangun di atas `Documents.jsx` (377 baris) dengan integrasi **Cloudinary** untuk upload file dan **image compression** untuk optimasi ukuran file sebelum upload.
Sistem ini mendukung 6 kategori dokumen, pencarian full-text, filter berdasarkan kategori, organising dokumen ke dalam folder, versioning dokumen, sharing dokumen ke user tertentu, penguncian dokumen, tanggal kedaluwarsa, dan access control melalui `ERPAccessGuard`.
## Fitur Utama
* **Upload & Compression** — Upload file ke Cloudinary dengan kompresi otomatis untuk gambar
* **6 Kategori Dokumen** — Klasifikasi dokumen ke dalam kategori yang terstruktur
* **Folder Organisation** — Kelompokkan dokumen ke dalam folder virtual
* **Versioning** — Lacak versi dokumen secara otomatis
* **Sharing & Collaboration** — Bagikan dokumen ke user tertentu berdasarkan email
* **Document Locking** — Kunci dokumen untuk mencegah perubahan tidak sah
* **Expiry Tracking** — Tandai dokumen dengan tanggal kedaluwarsa
* **Tagging System** — Tambahkan tag untuk klasifikasi tambahan
* **Search & Filter** — Cari dokumen berdasarkan nama, deskripsi, kategori, dan tag
* **Access Control** — Permission berbasis role melalui ERPAccessGuard
## Arsitektur Komponen
```mermaid theme={null}
graph TD
A[Documents.jsx
377 lines] --> B[ERPAccessGuard
module=documents]
A --> C[Upload Pipeline]
A --> D[Document List
Grid/Table View]
A --> E[Category Filter
6 kategori]
A --> F[Search Bar]
A --> G[Document Preview
Modal]
A --> K[Folder Navigation]
A --> L[Share Dialog]
A --> M[Version History]
C --> C1[File Selection
Input file]
C --> C2[Image Compression
Canvas API]
C --> C3[Cloudinary Upload
preset: snishop_erp]
C --> C4[Metadata Save
base44 entity]
D --> H[Document Card]
H --> H1[Thumbnail Preview]
H --> H2[File Name / Title]
H --> H3[Category Badge]
H --> H4[File Size]
H --> H5[Upload Date]
H --> H6[Download/Delete Actions]
H --> H7[Version Indicator]
H --> H8[Lock Status Icon]
H --> H9[Tag Badges]
A --> I[base44.entities.Document]
A --> J[Cloudinary API]
A --> N[base44.entities.ApprovalRequest]
A --> O[base44.entities.WorkflowAutomation]
```
## Entity Relationship Diagram
```mermaid theme={null}
erDiagram
Document {
string company_id "ID perusahaan (null untuk personal)"
string title "Judul dokumen"
string description "Deskripsi dokumen"
string category "contract|invoice|report|presentation|spreadsheet|other"
string file_url "URL file dokumen"
string file_type "pdf, docx, xlsx, etc"
number file_size "Ukuran file dalam bytes"
array tags "Daftar tag dokumen"
array shared_with "Email user yang bisa akses"
string folder "Nama folder"
number version "Nomor versi dokumen"
boolean is_locked "Status penguncian dokumen"
date expiry_date "Tanggal kedaluwarsa"
}
User {
string email "Email pengguna"
string full_name "Nama lengkap"
string role "admin|user"
string subscription_plan "free|pro|business|advanced|enterprise"
string active_company_id "ID perusahaan aktif"
}
Workspace {
string company_id "ID perusahaan"
string name "Nama workspace"
string description "Deskripsi workspace"
string owner_id "ID pemilik workspace"
boolean is_personal "Apakah workspace pribadi"
}
WorkspaceMember {
string workspace_id "ID workspace"
string user_id "ID pengguna"
string role "owner|admin|member|viewer"
string invited_by "Email pengundang"
datetime joined_at "Waktu bergabung"
}
ApprovalWorkflow {
string company_id "ID perusahaan"
string workflow_name "Nama alur persetujuan"
string description "Penjelasan workflow"
string document_type "expense_request|leave_request|purchase_order|discount_request|budget_adjustment"
array approval_levels "Daftar level persetujuan"
boolean is_active "Status aktif workflow"
}
ApprovalRequest {
string company_id "ID perusahaan"
string workflow_id "ID ApprovalWorkflow"
string document_type "Tipe dokumen"
string document_id "ID dokumen yang diminta persetujuan"
string requester_id "User yang mengajukan"
date submission_date "Tanggal pengajuan"
number current_approval_level "Level persetujuan saat ini"
array approval_history "Riwayat persetujuan"
string overall_status "pending|approved|rejected|on_hold"
date final_approval_date "Tanggal persetujuan final"
}
Comment {
string entity_type "task|note"
string entity_id "ID entitas yang dikomentari"
string workspace_id "ID workspace"
string content "Isi komentar"
string user_id "ID pengguna"
string user_name "Nama pengguna"
array mentions "User IDs yang di-mention"
string parent_comment_id "ID komentar parent"
}
Label {
string name "Nama label"
string color "Warna label"
string icon "Icon label"
string description "Penjelasan label"
string user_id "ID pemilik label"
string workspace_id "ID workspace"
}
WorkflowAutomation {
string company_id "ID perusahaan"
string user_id "Email pemilik workflow"
string name "Nama workflow automation"
string trigger_type "Jenis trigger"
array actions "Daftar aksi"
boolean is_active "Status aktif"
}
Document ||--o{ ApprovalRequest : "memiliki"
Document }o--|| User : "diupload oleh"
Document }o--|| Document : "versi sebelumnya"
Document }o--o{ User : "shared_with"
Document }o--|| Workspace : "berada di"
ApprovalRequest ||--|| ApprovalWorkflow : "menggunakan"
ApprovalRequest }o--|| User : "diajukan oleh"
Workspace ||--o{ WorkspaceMember : "memiliki anggota"
WorkspaceMember }o--|| User : "anggota adalah"
Workspace ||--o{ Comment : "memiliki komentar"
Workspace ||--o{ Label : "memiliki label"
WorkflowAutomation }o--|| User : "dimiliki oleh"
```
## Entity Schema — Document
| Field | Tipe | Wajib | Deskripsi |
| - | - | - | - |
| `title` | string | **Ya** | Judul dokumen — nama yang ditampilkan dalam daftar dan pencarian |
| `file_url` | string | **Ya** | URL file dokumen yang tersimpan di Cloudinary |
| `company_id` | string | Tidak | ID perusahaan (null untuk dokumen personal) |
| `description` | string | Tidak | Deskripsi atau catatan tentang dokumen |
| `category` | enum | Tidak | Kategori dokumen — default: `other` |
| `file_type` | string | Tidak | Tipe file: pdf, docx, xlsx, dll |
| `file_size` | number | Tidak | Ukuran file dalam bytes |
| `tags` | array\ | Tidak | Daftar tag untuk klasifikasi tambahan |
| `shared_with` | array\ | Tidak | Array email user yang memiliki akses ke dokumen |
| `folder` | string | Tidak | Nama folder virtual untuk organisir dokumen |
| `version` | number | Tidak | Nomor versi dokumen — default: 1, auto-increment |
| `is_locked` | boolean | Tidak | Status penguncian dokumen — default: false |
| `expiry_date` | date | Tidak | Tanggal kedaluwarsa dokumen (format: YYYY-MM-DD) |
## Entity Schema — ApprovalRequest
| Field | Tipe | Wajib | Deskripsi |
| - | - | - | - |
| `company_id` | string | **Ya** | ID perusahaan |
| `workflow_id` | string | **Ya** | ID ApprovalWorkflow yang digunakan |
| `document_type` | string | **Ya** | Tipe dokumen yang diminta persetujuan |
| `document_id` | string | **Ya** | ID dokumen yang diminta persetujuan |
| `requester_id` | string | **Ya** | User yang mengajukan persetujuan |
| `submission_date` | datetime | Tidak | Tanggal dan waktu pengajuan |
| `amount` | number | Tidak | Jumlah terkait (jika ada, misalnya nominal invoice) |
| `description` | string | Tidak | Deskripsi pengajuan persetujuan |
| `current_approval_level` | number | Tidak | Level persetujuan saat ini — default: 1 |
| `approval_history` | array\