Doc_chelvyn/Mito/Sfa/FDD/Mito - FDD - CMS - Master P...

12 KiB
Raw Permalink Blame History

judul proyek terkait kategori tipe versi tanggal_dokumen status sumber tags
Mito — FDD — CMS — Master Product (Revised) SFA CMS Mito · Odoo 18 FDD dokumen-eksternal 1.0 2026-09-08 Draft — approver & distribution belum diisi dokumen FDD dari tim SFA/CMS (bukan tulisan internal)
sfa
cms
mito
fdd
integrasi
master-product

Index: SFA — Index · Kategori: FDD · Dokumen pihak luar — jangan diedit isinya, catatan/tanggapan internal ditulis di SFA — Index.

FDD integrasi Master Product Odoo 18 → CMS → SFA Mobile, pola pull: scheduler ada di sisi CMS, Odoo cuma jadi source of truth + API provider.

Master Product

Customizations

SFA - Content Management System

Item Details
Prepared for Mito
Project SFA–CMS Integration with Odoo 18
Document Title Functional Design Document
Version 1.0
Date 08/09/2026

Mito – FDD – CMS – Master Product | Version 1.0

Revision & Sign-off Sheet

Change Record

Date Author Version Change Reference
08/09/2026 Project Team 1.0 Initial FDD–Master Product integration

Approvers

Name Version Approved Position Date
istribution
Name
Position

Distribution

Document Properties

Item Details
Document Title Functional Design Document
Author Project Team
Creation Date 08/09/2026
Last Updated 08/09/2026

Mito – FDD – CMS – Master Product | Version 1.0

Table of Contents

  • 1 Introduction

  • 2 Justification

  • 3 Modification Description

Arsitektur integrasi menggunakan pola pull: CMS menjadi pihak yang menginisiasi request melalui scheduler. Odoo 18 tidak menjalankan scheduler untuk proses ini; Odoo 18 berperan sebagai source system/API provider yang mengembalikan data Master Product kepada CMS.

  • 3.1 Integration Overview

  • 3.2 Detail Fitur

  • 3.3 Integration Flow

  • 3.4 Data Mapping

  • 3.5 Validation

  • 4 Access Right

  • 5 Error Handling

  • 6 Test Scripts

Mito – FDD – CMS – Master Product | Version 1.0

1 Introduction

Background

Master Product pada Odoo 18 menjadi sumber data produk yang diakses oleh CMS untuk menyediakan data produk kepada aplikasi mobile SFA. Integrasi dirancang menggunakan scheduler/cron job pada CMS yang secara berkala mengambil data master product dari Odoo 18 melalui API.

Purpose

Dokumen ini mendefinisikan kebutuhan fungsional dan alur integrasi Master Product antara Odoo 18, CMS, dan aplikasi mobile SFA, termasuk proses pengiriman data, validasi, create/update product pada CMS, logging, dan distribusi data ke SFA.

Audience

Customer Project : PT Mahakarya Sukses Indonesia

  • PT Stein Perkasa Internasional

Partner Consultant :

Partner Project Mgr :

2 Justification

Standard

Odoo 18 berfungsi sebagai source of truth untuk master product. CMS menjadi layer integrasi yang mengambil data dari Odoo dan penyedia data product untuk SFA.

Purpose of the modification

Menyediakan mekanisme sinkronisasi otomatis Master Product dari Odoo 18 ke CMS dan selanjutnya dari CMS ke aplikasi mobile SFA.

Considerations

  • Scheduler/cron dijalankan dari sisi CMS sesuai interval yang disepakati.

  • CMS melakukan validasi ID product sebelum melakukan create atau update.

  • CMS menyimpan log success dan error untuk kebutuhan monitoring dan troubleshooting.

  • Data yang berhasil diproses CMS diteruskan ke SFA.

  • Detail interval scheduler, endpoint API, authentication, dan field teknis final mengikuti technical design/API specification.

3 Modification Description

3.1 Integration Overview

Integrasi menggunakan pola Odoo → CMS → SFA. CMS secara otomatis menjalankan scheduler untuk mengambil data product dari Odoo 18 melalui API. CMS menerima response, melakukan mapping dan validasi ID product, kemudian menentukan apakah product perlu dibuat baru atau di-update. Setelah proses berhasil, CMS mengirimkan data product ke SFA.

Mito – FDD – CMS – Master Product | Version 1.0

_ a ia |=
‘—
a(|
‘Sync Lastce Update <—— Scheduler/Cron
| Job
| =‘CMs.
a=
wt
aes as
a ha
u
=

Gambar 1. High-level integration flow Master Product

3.2 Detail Fitur

Action Description
Create CMS membuat record product baru apabila Product ID dari Odoo belum tersedia di
CMS.
Edit / Update CMS memperbarui record product apabila Product ID dari Odoo sudah tersedia di
CMS.
View Data product yang tersimpan di CMS dapat digunakan sebagai sumber data product
untuk SFA.
Delete Tidak didefinisikan pada flow ini. Status/archive handling mengikuti kebutuhan bisnis
dan technical design.
Search / Filter Tidak menjadi bagian utama proses integrasi; mekanisme pencarian/filter pada
CMS/SFA mengikuti kebutuhan aplikasi.
Sync Scheduler CMS mengambil data product dari Odoo 18 untuk diproses secara otomatis.

3.3 Integration Flow

No. Process Functional Description
1 Scheduler / Cron Job CMS menjalankan scheduler secara berkala sesuai
konfigurasi interval.
2 Request Product Data CMS melakukan request/get data Master Product dari
Odoo 18 melalui API.
3 Odoo API Response Odoo 18 mengembalikan data product kepada CMS
berdasarkan request dari CMS.
4 Receive API & Sync/Map
Product
CMS menerima response dan melakukan mapping data
product Odoo ke struktur data CMS.
5 Validasi Product ID CMS memvalidasi Product ID. Jika tidak valid, proses
masuk ke error handling dan error code dicatat.
6 Check Product ID CMS mengecek apakah Product ID sudah tersedia di
CMS.
6A Product belum ada CMS membuat product baru.

Mito – FDD – CMS – Master Product | Version 1.0

6B Product sudah ada CMS melakukan update terhadap product existing.
7 Receive Success CMS menghasilkan status sukses setelah proses
create/update berhasil.
8 Log CMS mencatat log success atau error sesuai hasil
proses.
9 Send Data to SFA CMS mengirimkan data product yang berhasil diproses
ke aplikasi mobile SFA.
10 Receive Data in SFA SFA menerima data product dari CMS untuk digunakan
pada aplikasi.

3.4 Data Mapping

Field teknis Odoo 18 belum ditentukan secara eksplisit pada source flow. Oleh karena itu, mapping berikut menggunakan logical business field dan kolom Odoo Field diberi status TBD untuk dikonfirmasi pada technical/API design.

Name Field Odoo Field CMS Field Type Condition
Product ID TBD product_id Integer / String Mandatory; digunakan sebagai
unique identifier
Product Name TBD product_name String Mandatory
SKU / Internal
Reference
TBD sku String Jika digunakan oleh master
product
Product Type TBD product_type Selection / String Mengikuti konfigurasi product
type
Product Status TBD status Selection /
Boolean
Mengikuti status product pada
Odoo
UOM TBD uom String /
Reference
Mengikuti konfigurasi UOM
Product Category TBD category Reference Mengikuti master category
Last Updated TBD updated_at Date Time Digunakan untuk informasi
sinkronisasi

3.5 Validation

No. Validation Condition Expected Result Error / Handling
1 Product ID tersedia Product ID valid Proses dilanjutkan ke
pengecekan existing product.
-
2 Product ID tidak valid ID kosong / format tidak sesuai
/ tidak dapat dipetakan
Data tidak diproses. Send/record error
code dan Log Error.
3 Product belum ada Product ID tidak ditemukan di
CMS
CMS membuat product baru. -
4 Product sudah ada Product ID ditemukan di CMS CMS melakukan update
product.
-
5 Create/Update gagal Error saat penyimpanan data Transaksi dianggap gagal. Log Error dan error
code.
6 Sync berhasil Create/Update berhasil CMS mencatat success dan
meneruskan data ke SFA.
-

4 Access Right

Component Access / Responsibility
Odoo 18 Menyediakan API Master Product dan mengembalikan data product
berdasarkan request dari CMS.
CMS Menjalankan scheduler, request data dari Odoo, menerima response,
mapping, validasi, create/update, logging, dan mengirim data product
ke SFA.
SFA Mobile Menerima dan menggunakan data product dari CMS.
User Tidak menjalankan scheduler secara manual sebagai bagian dari
normal business flow, kecuali disediakan oleh administrator.

Mito – FDD – CMS – Master Product | Version 1.0

5 Error Handling

Error handling digunakan untuk memastikan kegagalan integrasi dapat ditelusuri dan tidak dianggap sebagai sinkronisasi berhasil.

No. Scenario Handling Log
1 Invalid Product ID CMS menolak data yang tidak valid dan
menghasilkan/menyimpan error code.
Log Error
2 Mapping gagal Data tidak diproses sampai mapping dapat dilakukan
dengan benar.
Log Error
3 Create product gagal Record tidak dianggap sukses; error dicatat untuk
troubleshooting.
Log Error
4 Update product gagal Record tidak dianggap sukses; error dicatat untuk
troubleshooting.
Log Error
5 API communication failure Request dari CMS ke Odoo dianggap gagal dan dicatat
untuk monitoring/retry sesuai technical design.
Log Error
6 Successful synchronization CMS mencatat hasil sukses setelah create/update selesai. Log Success

6 Test Scripts

No. Skenario
Pengujian
Langkah Pengujian oleh
User/System
Data yang
Diuji
Hasil yang
Diharapkan
Error
Message (jika
ada)
Notes
1 Scheduler
berhasil
dijalankan
Jalankan/menunggu
scheduler CMS sesuai
jadwal.
Product valid
di Odoo
Data product dikirim
dari Odoo ke CMS.
-
2 CMS menerima
data product
CMS melakukan request
ke API Odoo dan
menerima response
payload product.
Payload
product valid
CMS menerima dan
memproses payload.
-
3 Validasi Product
ID berhasil

CMS melakukan validasi
Product ID.
Product ID
valid
Proses dilanjutkan. -
4 Product baru
dibuat
Kirim Product ID yang
belum ada di CMS.
Product baru CMS membuat product
baru.
-
5 Product existing
di-update
Kirim Product ID yang
sudah ada di CMS dengan
perubahan data.
Product
existing
CMS memperbarui
product.
-
6 Product ID
invalid

Kirim payload dengan
Product ID kosong/tidak
valid.
Invalid
Product ID
Data ditolak dan error
dicatat.
Error code
sesuai API
specification
7 Create gagal Simulasikan kegagalan
penyimpanan saat create.
Product baru Proses dianggap gagal
dan Log Error
terbentuk.
Error code
sesuai API
specification
8 Update gagal Simulasikan kegagalan
penyimpanan saat update.
Product
existing
Proses dianggap gagal
dan Log Error
terbentuk.
Error code
sesuai API
specification
9 Send data ke
SFA berhasil
Setelah create/update
sukses, cek proses
outbound CMS ke SFA.
Product valid SFA menerima data
product.
-
10 End-to-end sync Jalankan scheduler CMS
dan verifikasi data dari
Odoo→CMS→SFA.
Product valid Data tersedia di CMS
dan SFA sesuai hasil
mapping.
-

Note: Dokumen ini merupakan FDD berdasarkan flow integrasi yang diberikan. Endpoint API, authentication, scheduler interval, exact Odoo field technical name, payload JSON, retry mechanism, dan detail database belum dispesifikasikan pada source dan perlu dikonfirmasi pada tahap Technical Design/API Specification.

Mito – FDD – CMS – Master Product | Version 1.0