LAB_LINGKUNGAN/lab_env_quotation_flow_diagram.md

# Diagram Alur Penawaran, Quotation, dan Pengisian Data Teknis

Berikut adalah diagram yang menggambarkan alur proses detail untuk penawaran, quotation, dan pengisian data teknis oleh Admin laboratorium lingkungan.

## 1. Diagram Alur Keseluruhan

```mermaid
flowchart TD
    subgraph "Tahap 1: Permintaan & Penawaran"
        A1[Permintaan Pelanggan] -->|Diterima oleh| A2[Admin Lab]
        A2 -->|Mencatat Permintaan| A3[Entry Permintaan di Sistem]
        A3 -->|Analisis Kebutuhan| A4[Identifikasi Parameter]
        A4 -->|Kalkulasi Biaya| A5[Penyiapan Penawaran]
        A5 -->|Generate Dokumen| A6[Penawaran]
    end

    subgraph "Tahap 2: Quotation & Persetujuan"
        B1[Pembuatan Quotation] -->|Generate Dokumen Resmi| B2[Quotation]
        B2 -->|Pengiriman ke Pelanggan| B3[Menunggu Persetujuan]
        B3 -->|Diterima| B4[Approval dari Pelanggan]
        B4 -->|Pembayaran DP| B5[Verifikasi Pembayaran]
        B5 -->|Konfirmasi| B6[Status Order: Approved]
    end

    subgraph "Tahap 3: Data Teknis & Registrasi"
        C1[Pengisian Data Teknis] -->|Detail Sampling| C2[Protokol Sampling]
        C1 -->|Jadwal & Tim| C3[Penjadwalan Sampling]
        C1 -->|Peralatan| C4[Requisition Peralatan]
        C2 --> C5[Registrasi Order]
        C3 --> C5
        C4 --> C5
        C5 -->|Generate| C6[Surat Perintah Kerja]
        C6 -->|Pelaksanaan| C7[Sampling & Analisis]
    end

    A6 --> B1
    B6 --> C1
    
    classDef requestStage fill:#ffcccc,stroke:#ff6666
    classDef quotationStage fill:#ccffcc,stroke:#66ff66
    classDef technicalStage fill:#ccccff,stroke:#6666ff
    
    class A1,A2,A3,A4,A5,A6 requestStage
    class B1,B2,B3,B4,B5,B6 quotationStage
    class C1,C2,C3,C4,C5,C6,C7 technicalStage
```

## 2. Diagram Detail: Proses Pembuatan Quotation

```mermaid
sequenceDiagram
    actor Customer as Pelanggan
    actor Admin as Admin Lab
    participant QuotSystem as Sistem Quotation
    participant PriceDB as Database Harga
    participant ApprovalFlow as Alur Persetujuan
    
    Customer->>Admin: Permintaan Layanan
    Admin->>QuotSystem: Login ke Modul Quotation
    
    QuotSystem->>Admin: Tampilkan Form Quotation Baru
    
    Admin->>QuotSystem: Input Data Pelanggan
    Admin->>QuotSystem: Pilih Jenis Permintaan<br/>(Sampling & Analisis/Analisis Saja)
    
    Admin->>QuotSystem: Tambahkan Parameter Analisis
    QuotSystem->>PriceDB: Query Harga Parameter
    PriceDB-->>QuotSystem: Return Data Harga
    
    Admin->>QuotSystem: Input Jumlah Titik/Sampel
    Admin->>QuotSystem: Tambahkan Biaya Tambahan<br/>(Sampling, Transport, dll)
    
    QuotSystem->>QuotSystem: Kalkulasi Total
    QuotSystem-->>Admin: Tampilkan Preview Quotation
    
    Admin->>QuotSystem: Terapkan Diskon (jika ada)
    Admin->>QuotSystem: Tambahkan Syarat & Ketentuan
    
    opt Quotation Kompleks/Nilai Besar 
        Admin->>ApprovalFlow: Submit untuk Persetujuan
        ApprovalFlow->>ApprovalFlow: Review oleh Supervisor
        ApprovalFlow-->>Admin: Persetujuan Diberikan
    end
    
    Admin->>QuotSystem: Finalisasi Quotation
    QuotSystem-->>Admin: Generate Dokumen PDF
    
    Admin->>Customer: Kirim Quotation via Email
    
    Customer->>Admin: Konfirmasi Persetujuan
    Admin->>QuotSystem: Catat Persetujuan
    
    Customer->>Admin: Kirim Bukti Pembayaran DP
    Admin->>QuotSystem: Upload Bukti Pembayaran
    
    QuotSystem->>QuotSystem: Update Status Order
    QuotSystem-->>Admin: Konfirmasi Order Disetujui
```

## 3. Diagram Detail: Pengisian Data Teknis

```mermaid
flowchart LR
    A[Admin Lab] -->|Akses| B[Modul Data Teknis]
    
    subgraph "Pengisian Data Teknis"
        B --> C1[Data Lokasi Sampling]
        B --> C2[Metode Sampling]
        B --> C3[Metode Preservasi]
        B --> C4[Kebutuhan Peralatan]
        B --> C5[Instruksi Khusus]
        B --> C6[Tim & Jadwal]
        
        C1 --> D1[Koordinat GPS]
        C1 --> D2[Deskripsi Lokasi]
        C1 --> D3[Akses Lokasi]
        
        C2 --> E1[Protokol Sampling]
        C2 --> E2[Jenis Sampling]
        C2 --> E3[Volume Sampel]
        
        C3 --> F1[Preservasi Kimia]
        C3 --> F2[Preservasi Fisik]
        C3 --> F3[Waktu Holding]
        
        C4 --> G1[Alat Sampling]
        C4 --> G2[Alat Uji Lapangan]
        C4 --> G3[Media Preservasi]
        
        C5 --> H1[Persyaratan Pelanggan]
        C5 --> H2[Kontrol Kualitas]
        C5 --> H3[Dokumentasi]
        
        C6 --> I1[Petugas Sampling]
        C6 --> I2[Tanggal & Waktu]
        C6 --> I3[Durasi Pengerjaan]
    end
    
    subgraph "Finalisasi"
        J[Sistem Lab] <--> C1 & C2 & C3 & C4 & C5 & C6
        J --> K[Registrasi Order]
        K --> L[Work Order]
        L --> M[Pelaksanaan]
    end
    
    classDef adminClass fill:#ffdddd,stroke:#ff9999
    classDef moduleClass fill:#ddffdd,stroke:#99ff99
    classDef dataClass fill:#ddddff,stroke:#9999ff
    classDef detailClass fill:#ffffdd,stroke:#ffff99
    classDef finalClass fill:#ddffff,stroke:#99ffff
    
    class A adminClass
    class B moduleClass
    class C1,C2,C3,C4,C5,C6 dataClass
    class D1,D2,D3,E1,E2,E3,F1,F2,F3,G1,G2,G3,H1,H2,H3,I1,I2,I3 detailClass
    class J,K,L,M finalClass
```

## 4. Status Permintaan Layanan

```mermaid
stateDiagram-v2
    [*] --> Draft: Admin membuat permintaan baru
    
    Draft --> Submitted: Admin submit permintaan ke sistem
    
    Submitted --> Quote_Preparation: Admin menyiapkan penawaran
    Quote_Preparation --> Quotation_Sent: Penawaran dikirim ke pelanggan
    
    Quotation_Sent --> Approved: Pelanggan menyetujui
    Quotation_Sent --> Rejected: Pelanggan menolak
    Quotation_Sent --> Negotiation: Pelanggan minta revisi
    
    Negotiation --> Quote_Preparation: Perlu revisi penawaran
    
    Approved --> Technical_Details: Admin lengkapi data teknis
    Technical_Details --> Registered: Order diregistrasi
    
    Registered --> In_Progress: Sampling/analisis dimulai
    In_Progress --> Completed: Analisis selesai
    Completed --> Verified: Hasil diverifikasi
    Verified --> Reported: Laporan dibuat
    
    Rejected --> [*]
    Reported --> [*]
    
    state Quotation_Process {
        [*] --> Quote_Draft
        Quote_Draft --> Quote_Review
        Quote_Review --> Quote_Approval
        Quote_Approval --> Quote_Final
        Quote_Final --> [*]
    }
```

## Penjelasan Diagram

### 1. Diagram Alur Keseluruhan
Diagram ini menampilkan alur proses dari awal permintaan pelanggan hingga pelaksanaan sampling dan analisis, dibagi menjadi tiga tahap utama:
- **Tahap 1**: Proses menerima permintaan dan menyiapkan penawaran
- **Tahap 2**: Proses membuat quotation, mendapatkan persetujuan, dan verifikasi pembayaran
- **Tahap 3**: Proses melengkapi data teknis dan registrasi order

### 2. Diagram Detail: Proses Pembuatan Quotation
Diagram sequence ini menunjukkan interaksi detail antara Pelanggan, Admin Lab, dan berbagai komponen sistem saat menyiapkan quotation, termasuk:
- Proses query harga parameter dari database
- Proses kalkulasi biaya
- Proses persetujuan internal (untuk quotation nilai besar)
- Proses pengiriman, persetujuan, dan verifikasi pembayaran

### 3. Diagram Detail: Pengisian Data Teknis
Diagram ini memperlihatkan komponen-komponen data teknis yang perlu dilengkapi oleh Admin Lab, termasuk:
- Data lokasi sampling dengan detail koordinat dan akses
- Metode sampling dan preservasi
- Kebutuhan peralatan
- Instruksi khusus dari pelanggan
- Informasi tim dan jadwal

### 4. Status Permintaan Layanan
Diagram status ini menunjukkan berbagai status yang mungkin dialami oleh permintaan layanan dari awal hingga akhir, termasuk:
- Proses persetujuan quotation
- Proses negosiasi jika diperlukan
- Alur kerja setelah order disetujui

## Keuntungan Diagram Ini untuk Pengembangan Sistem

1. **Pemahaman Alur Kerja yang Jelas**: Memberikan pemahaman yang jelas tentang alur kerja proses penawaran, quotation, dan pengisian data teknis.

2. **Identifikasi Interaksi Sistem**: Memetakan interaksi antara pengguna (Admin dan Pelanggan) dengan berbagai komponen sistem.

3. **Panduan Pengembangan UI/UX**: Dapat digunakan sebagai panduan untuk merancang antarmuka pengguna sesuai dengan alur kerja.

4. **Dokumentasi Proses Bisnis**: Berfungsi sebagai dokumentasi proses bisnis yang dapat digunakan untuk pelatihan staf baru.

5. **Identifikasi Kebutuhan Validasi Data**: Menunjukkan titik-titik di mana validasi data diperlukan dalam sistem.

Diagram-diagram ini dapat digunakan sebagai referensi dalam pengembangan modul penawaran, quotation, dan pengisian data teknis dalam sistem aplikasi laboratorium lingkungan.