# Modul 01 - Marketing Tender

Dokumen ini menjadi acuan awal flow ERP kontraktor di aplikasi AHSP. Modul 1 dimulai dari marketing mencari peluang tender sampai tender siap diserahkan ke project execution.

## Tujuan Modul

- Mencatat client, lead, tender, dan dokumen awal.
- Mengatur PIC lintas departemen untuk isi data teknis, RAB, quotation, safety, PPIC, HRD, dan procurement.
- Melacak status tender dari input awal sampai client approval.
- Menentukan hasil akhir tender: won, lost, hold, atau revisi.
- Menjadi pintu masuk pembuatan project/job number setelah tender dimenangkan.

## Menu Awal

- `Master Client`
- `Lead Client`
- `Tender Qualification`
- `Quotation / Penawaran`
- `Tender Task`
- `Tender Document`
- `Tender Approval`
- `Tender Handover`

## Role Utama

| Role | Tugas |
|---|---|
| Marketing | Cari client, input lead/tender, submit quotation ke client, update status tender. |
| Engineering | Isi scope teknis, RAB, drawing, BOQ, metode teknis. |
| Administrasi | Validasi format dokumen, legalitas, kelengkapan quotation. |
| Safety | Isi JSA, metode kerja aman, requirement safety. |
| PPIC | Isi schedule plan, manpower plan, planning eksekusi awal. |
| HRD | Requirement manpower, estimasi gaji, rekrutmen jika perlu. |
| Procurement | Estimasi vendor/subvendor/material awal. |
| Management | Approval margin, nilai tender, dan keputusan submit. |

## Status Tender

| Status | Arti |
|---|---|
| `draft` | Baru dibuat marketing, belum lengkap. |
| `qualification` | Sedang dinilai kelayakan tender. |
| `task_open` | Task lintas departemen sedang berjalan. |
| `quotation_review` | Quotation/RAB sedang dicek internal. |
| `submitted_to_client` | Penawaran sudah dikirim ke client. |
| `client_revision` | Client meminta revisi. |
| `client_approved` | Client menyetujui penawaran. |
| `won` | Tender menang dan siap dibuat project/job. |
| `lost` | Tender kalah. |
| `hold` | Tender ditunda. |
| `cancelled` | Tender dibatalkan. |

## Flow Proses

```text
Marketing mencari peluang
        |
        v
Input Lead Client
        |
        v
Input Tender Detail
        |
        v
Tender Qualification
        |
        +-- Tidak layak -> Lost / Hold / Arsip
        |
        v
Buat Task Departemen
        |
        +-- Engineering: RAB, BOQ, drawing, scope teknis
        +-- Safety: JSA, metode kerja, requirement safety
        +-- PPIC: schedule plan, manpower plan
        +-- HRD: kebutuhan manpower dan estimasi biaya orang
        +-- Procurement: estimasi material, vendor, subvendor
        |
        v
Review Dokumen Internal
        |
        +-- Revisi -> kembali ke task terkait
        |
        v
Approval Internal Quotation
        |
        +-- Reject/Revisi -> perbaiki quotation
        |
        v
Submit Quotation ke Client
        |
        +-- Client Revisi -> update quotation -> submit ulang
        +-- Client Reject -> Lost
        |
        v
Client Approved
        |
        v
Tender Won
        |
        v
Handover ke Modul Project
```

## Data Lead Client

Field minimal:

- No Lead auto.
- Client dari `master_clients`.
- Nama proyek.
- PIC marketing.
- Contact person.
- Sumber tender: email, website, rekanan, referral, lainnya.
- URL akses tender.
- Username akses tender.
- Password akses tender, masked.
- Deadline tender.
- Estimasi nilai tender.
- Area tender.
- Estimasi UMR area.
- Estimasi meal.
- Rate BBM.
- Rate manpower.
- Scope pekerjaan.
- Catatan.
- Lampiran multiple.

## Data Tender Qualification

Field minimal:

- Nilai tender atau budget client.
- Target margin persen.
- Target margin rupiah.
- Complexity.
- Deadline submit quotation.
- Kompetitor: nama dan kisaran nilai.
- Self perform forecast.
- Subvendor forecast.
- Rekomendasi: self perform atau subvendor.
- Qualification score.
- Risiko utama.
- Keputusan lanjut atau tidak.

## Task Departemen

Task dibuat dari lead/tender dan bisa ditujukan ke PIC tertentu.

| Departemen | Output |
|---|---|
| Engineering | RAB, BOQ, drawing, technical spec, scope detail. |
| Safety | JSA, safety method, permit requirement. |
| PPIC | Time schedule, manpower planning, resource planning. |
| HRD | Estimasi tenaga kerja, status ketersediaan, rencana rekrutmen. |
| Procurement | Estimasi vendor, material, subvendor, lead time. |
| Administrasi | Validasi format dokumen dan kelengkapan legal. |

## Approval Internal

Approval dilakukan sebelum quotation dikirim ke client.

Checklist:

- Scope pekerjaan sudah jelas.
- RAB sudah ada.
- Quotation value sudah benar.
- Margin persen dan margin rupiah terlihat.
- Risiko sudah dicatat.
- Dokumen lampiran lengkap.
- Deadline submit masih aman.

## Setelah Client Approved

Saat client menyetujui quotation:

1. Status tender menjadi `client_approved`.
2. Marketing/Admin set hasil menjadi `won`.
3. Sistem membuka tombol `Create Project`.
4. Project/job number dibuat dari tender.
5. Data yang dibawa:
   - client
   - nama proyek
   - scope
   - quotation value
   - RAB summary
   - task output
   - dokumen tender
   - PIC project awal

## Handover ke Modul 02

Output Modul 01 menjadi input Modul 02.

Modul berikutnya:

```text
Modul 02 - Project Setup & Engineering Release
```

Isi Modul 02:

- Create project/job number.
- Final RAB.
- Final BOQ/BOM.
- Time schedule.
- Curva S.
- Work breakdown structure.
- Assign construction PIC.
- Approval project execution.

## Catatan Implementasi AHSP

Menu yang sudah bisa menjadi fondasi:

- `/master-client`
- `/lead-client`
- CRM pipeline/detail project
- Master Project
- RAB/Quotation

Prioritas pengerjaan:

1. Rapikan `Lead Client` sebagai pintu masuk tender.
2. Tambah `Tender Qualification`.
3. Tambah `Tender Task` per departemen.
4. Tambah `Quotation Review`.
5. Tambah `Create Project` hanya saat tender `won`.

## Deliberate Simplification

`ponytail:` Modul 1 belum perlu accounting lengkap. Batasnya hanya sampai tender `won` dan handover project. Finance detail, progress invoice, payment, dan final account masuk modul setelah project berjalan.