# Kos Barokah Odoo ERP (v19 Community)

Sistem Enterprise Resource Planning (ERP) berbasis **Odoo 19 Community Edition** dan **PostgreSQL 16** menggunakan Docker Compose, yang dikustomisasi khusus untuk operasional bisnis Kos Barokah.

---

## 1. Arsitektur & Akses Docker

* **Lokasi Proyek:** `~/Application/odoo-erp`
* **Web UI Port:** `18070` (`http://<IP-SERVER>:18070`)
* **Database Name:** `erpdev`
* **Default Admin Login:** `admin` / `admin` (ubah setelah login pertama)

### Services & Containers
| Service | Container Name | Image | Port | Volume |
|---|---|---|---|---|
| **Database** | `odoo-erp-db` | `postgres:16` | 5432 (Internal) | `erp_pgdata` |
| **Odoo ERP** | `odoo-erp` | `odoo:19.0` | `18070:8069` | `erp_webdata`, `./config`, `./addons` |

---

## 2. Business Workflow (Alur Bisnis)

### A. Item Code & Import Excel
* **Modul:** `product` + `base_import`
* **Cara Pakai:**
  1. Masuk ke **Inventory / Purchase / Sales** → **Products** → **Products**.
  2. Klik tombol **Favorites** → **Import records**.
  3. Unggah file Excel (`.xlsx`) dengan kolom yang sesuai (misal: *Name* untuk Item Code, *Sale Price*, *Cost*, dll).
  4. Lakukan *Test* lalu *Import*.

### B. Sales Inquiry (CRM Pipeline)
* **Modul:** `crm`
* **Alur:**
  1. Catat prospek/pertanyaan pelanggan masuk ke **CRM** → **Pipeline**.
  2. Buat opportunity baru dengan tahap *Inquiry*.
  3. Setelah deal spesifikasi, konversi inquiry langsung menjadi **Quotation**.

### C. Sales Quotation & Sales Order (Custom Sequence)
* **Modul:** `sale_management` + Custom Addon (`kosbar_erp_ext`)
* **Alur & Penomoran:**
  1. **Quotation**: Dibuat dengan format nomor **`SQ/2026/00001`**.
  2. **Sales Order**: Saat Quotation di-*Confirm*, nomor otomatis berubah menjadi **`SO/2026/00001`**.

### D. Purchase Order (PO ke Warehouse)
* **Modul:** `purchase`
* **Alur:**
  1. Buat **Request for Quotation (RfQ)** ke supplier.
  2. Konfirmasi menjadi **Purchase Order (PO)**.
  3. Saat barang datang, lakukan penerimaan barang (*Receipts*) di gudang untuk menambah stok.

### E. Delivery Order (DO dari Warehouse)
* **Modul:** `stock` + Custom Addon
* **Alur:**
  1. Dari Sales Order yang telah dikonfirmasi, sistem otomatis membuat dokumen pengiriman (*Delivery Order*).
  2. Nomor DO menggunakan format khusus: **`DO/2026/00001`**.
  3. Validasi pengiriman (*Validate*) untuk memotong stok gudang.

---

## 3. Custom Settings & Akses Kontrol (`kosbar_erp_ext`)

Addon kustom dalam folder `./addons/kosbar_erp_ext/` menyediakan:

### Grup Akses Tambahan
* **Sales Manager**: Memiliki hak kelola penuh atas alur penjualan dan persetujuan khusus.
* **CFO / Finance Director**: Hak akses monitoring laporan keuangan dan data transaksi.

### Format Sequence Kustom
* **Quotation**: `SQ/%(year)s/#####`
* **Sales Order**: `SO/%(year)s/#####`
* **Delivery Order**: `DO/%(year)s/#####`

---

## 4. Struktur Database Utama (PostgreSQL)

Tabel inti Odoo 19 yang digunakan dalam alur di atas:

```
[res.partner] (Pelanggan / Supplier)
      │
      ├─► [crm.lead] (Sales Inquiry / Pipeline)
      │         │
      │         ▼
      ├─► [sale.order] (Quotation SQ/xxx ──► Sales Order SO/xxx)
      │         │
      │         ├─► [sale.order.line] (Item & Harga)
      │         │
      │         ▼
      └─► [stock.picking] (Delivery Order DO/xxx - Outgoing)
                │
[product.product] ◄─┤
[product.template] (Item Code & Stok)
                │
                ▲
[purchase.order] (PO ke Supplier - Incoming Receipts)
```

---

## 5. Perintah Manajemen Docker

* **Menjalankan stack:**
  ```bash
  docker compose up -d
  ```
* **Melihat log Odoo:**
  ```bash
  docker logs -f odoo-erp
  ```
* **Restart service Odoo:**
  ```bash
  docker compose restart odoo
  ```