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. Product Category Code & Item Code

Field Baru (Auto-generated):

Category Code (product.category.code)
- 2 digit berdasarkan ID kategori
- Contoh: ID=1 → 01, ID=7 → 07, ID=10 → 10
Item Code (product.template.item_code)
- Kombinasi: parent_kode (2 digit) + kategori_kode (2 digit) + id_produk (4 digit) + nama_slug (lowercase, tanpa spasi)
- Contoh: Kategori 05 (anak dari 01), Produk ID=1, nama="Laptop ASUS"
  - → item_code = 01050001laptopasus
- Item Code otomatis diisi saat produk dibuat/diupdate.

5. 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)

6. Master Data Import

Kami menyediakan file template Excel untuk mempercepat input data:

Lokasi Template: /templates/
File tersedia:
- import-products.xlsx: Template produk.
- import-product-categories.xlsx: Template kategori.
- README-IMPORT.md: Panduan lengkap import master data.
Catatan: Jangan isi kolom Item Code saat import — sistem akan meng-generate-nya otomatis (format: parent+child+id+name_slug, koma → titik).

7. Perintah Manajemen Docker

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

README.md

Kos Barokah Odoo ERP (v19 Community)