Versi 1

Field	Isi
Dokumen ID	VBS-PRD-004
Deskripsi	Halaman kerja operator produksi: menampilkan SPK per cabang, tanggal, dan line, memulai produksi, mencatat realisasi bahan dan hasil, menunda laporan realisasi, hingga menyelesaikan dan mencetak dokumen produksi
Nomor Revisi	1
Tanggal	2026-10-04
Keterangan	Dokumentasi baseline dari dokumentasi fitur demo dan kode FE

1. Ringkasan

a. In scope

• Operator memilih cabang, tanggal produksi, dan line produksi, lalu menampilkan SPK yang relevan.
• Operator melihat SPK dalam empat tab: Belum Dikerjakan, Dalam Proses, Kurang Laporan Realisasi, dan Selesai, dengan kolom nomor SPK, tanggal produksi, dan nama formula.
• Operator memulai produksi untuk SPK yang belum dikerjakan.
• Operator mengubah informasi kepala SPK (cabang, tanggal, line) sebelum produksi dimulai.
• Operator mencatat realisasi bahan baku, bahan pendukung, biaya langsung, bahan jadi, dan modifier (khusus SPK berformula) lalu menyelesaikan produksi atau menyimpannya untuk dilengkapi nanti.
• Operator melengkapi laporan realisasi untuk SPK yang ditunda.
• Operator melihat detail SPK dan mencetak dokumen sesuai tahap (surat perintah dan pengambilan barang, atau laporan realisasi dan penyerahan bahan jadi).

b. Catatan

c. Kesimpulan

• [FE] -
• [BE] -

2. Functional Requirement

Kode	Deskripsi
FR-01	Sistem menyediakan pencarian cabang (wajib), tanggal (default hari ini), dan line (mesin di cabang terpilih) dengan tombol Tampilkan
FR-02	Tab Belum Dikerjakan menampilkan SPK tercetak berstatus to do
FR-03	Tab Dalam Proses menampilkan SPK tercetak berstatus in progress
FR-04	Tab Kurang Laporan Realisasi menampilkan SPK tercetak berstatus selesai draft
FR-05	Tab Selesai menampilkan SPK tercetak berstatus selesai
FR-06	Operator dengan hak dasar dapat memulai produksi sehingga SPK berstatus sedang berjalan
FR-07	Operator dengan hak dasar dapat mengubah cabang, tanggal, dan line SPK yang belum dikerjakan
FR-08	Operator dapat mencatat realisasi lalu memilih Lakukan Nanti (status selesai draft) atau Simpan (status selesai)
FR-09	Saat menyimpan realisasi, total pembagian HPP hasil jadi wajib tepat 100
FR-10	Operator dapat melihat detail SPK dan berpindah ke form realisasi sesuai status
FR-11	Operator dengan hak cetak ulang dapat mencetak dokumen SPK sesuai tab

3. Use Case List

Kode	Deskripsi
UC-01	Menampilkan antrean SPK operator per cabang, tanggal, dan line
UC-02	Memulai produksi SPK
UC-03	Mengubah informasi kepala SPK sebelum dikerjakan
UC-04	Mencatat realisasi dan menyelesaikan produksi
UC-05	Melengkapi laporan realisasi yang tertunda
UC-06	Melihat detail SPK
UC-07	Mencetak dokumen SPK dari halaman operator

4. Use Case Scenario

UC-01 : Menampilkan antrean SPK operator per cabang, tanggal, dan line

Aktor	Operator produksi
Deskripsi	Operator menampilkan SPK yang harus dikerjakan pada cabang, tanggal, dan line tertentu
Prekondisi	User sudah login dan memilih brand
Alur utama	1. Operator membuka menu Transaksi, Produksi, Operator Produksi. 2. Operator memilih cabang, tanggal, dan line (opsional). 3. Operator klik Tampilkan. 4. Sistem menampilkan empat tab status dan memuat SPK pada tab aktif.
Alur negatif	- Jika cabang belum dipilih, tombol Tampilkan nonaktif. - Jika gagal memuat, daftar tab dikosongkan.
Bisnis rule	- Filter tanggal memakai start produksi pada hari terpilih. - Line hanya menampilkan mesin dari cabang terpilih. - Semua tab hanya menampilkan SPK yang sudah tercetak (SPK final). - Pencarian dipulihkan dari query URL saat kembali dari halaman lain.
Postkondisi	Antrean SPK tampil per tab
Trigger	Operator klik Tampilkan
Kode FR	FR-01 FR-02 FR-03 FR-04 FR-05

UC-02 : Memulai produksi SPK

Aktor	Operator dengan hak dasar operator produksi
Deskripsi	Operator menandai SPK mulai dikerjakan
Prekondisi	SPK berada di tab Belum Dikerjakan
Alur utama	1. Operator klik Mulai Produksi pada baris SPK. 2. Sistem mengubah status SPK menjadi sedang berjalan. 3. Sistem memuat ulang tab Belum Dikerjakan.
Alur negatif	- Jika gagal, muncul "Gagal Update Status Invoice Produksi ...".
Bisnis rule	- Butuh hak #operator-produksi basic. - Cabang, start produksi, penanda tercetak, dan jenis SPK dikirim ulang tanpa perubahan.
Postkondisi	SPK pindah ke tab Dalam Proses
Trigger	Operator klik Mulai Produksi
Kode FR	FR-06

UC-03 : Mengubah informasi kepala SPK sebelum dikerjakan

Aktor	Operator dengan hak dasar operator produksi
Deskripsi	Operator menyesuaikan cabang, tanggal, atau line SPK yang belum dikerjakan
Prekondisi	SPK berada di tab Belum Dikerjakan
Alur utama	1. Operator memilih Edit pada menu baris. 2. Sistem memuat detail SPK dan menampilkan cabang, tanggal, line, serta cluster dan formula sebagai informasi. 3. Operator mengubah cabang, tanggal, atau line. 4. Operator klik Simpan. 5. Sistem memperbarui SPK, menampilkan "Berhasil Update Perintah Produksi", dan kembali ke antrean.
Alur negatif	- Jika cabang atau tanggal kosong, simpan tidak diproses. - Jika gagal, muncul "Gagal Update Perintah Produksi".
Bisnis rule	- Status SPK tidak berubah saat mengubah kepala SPK. - Cluster dan formula tidak dapat diubah di halaman ini.
Postkondisi	Kepala SPK terbarui
Trigger	Operator klik Simpan pada halaman edit kepala
Kode FR	FR-07

UC-04 : Mencatat realisasi dan menyelesaikan produksi

Aktor	Operator produksi
Deskripsi	Operator mencatat realisasi pemakaian dan hasil lalu menyelesaikan produksi atau menundanya
Prekondisi	SPK berada di tab Dalam Proses
Alur utama	1. Operator klik Selesai pada baris SPK. 2. Sistem memuat detail SPK dan, bila berformula, detail formula. 3. Operator mengisi realisasi bahan baku, bahan pendukung, biaya langsung, bahan jadi, dan modifier. 4. Operator klik Simpan untuk menyelesaikan, atau Lakukan Nanti untuk menunda laporan. 5. Sistem memperbarui SPK, menampilkan "Berhasil Update Invoice Produksi", dan kembali ke antrean.
Alur negatif	- Jika bahan baku tidak valid, muncul "Form Bahan Baku Wajib Diisi". - Jika bahan pendukung tidak valid, muncul "Oops ada yang salah di form Bahan Penolong!". - Jika biaya langsung tidak valid, muncul "Oops ada yang salah di form Biaya Langsung!". - Jika bahan jadi tidak valid, muncul "Form Bahan Jadi Wajib Diisi". - Jika total HPP bukan 100, muncul "HPP hasil jadi tidak sama dengan 100! Total HPP Anda X%". - Jika gagal, muncul "Gagal Mengupdate Operator Produksi".
Bisnis rule	- Simpan menghasilkan status selesai, Lakukan Nanti menghasilkan status selesai draft. - Tab modifier hanya tampil untuk SPK berformula. - Validasi HPP 100 berlaku untuk kedua tombol.
Postkondisi	SPK pindah ke tab Selesai atau Kurang Laporan Realisasi
Trigger	Operator klik Simpan atau Lakukan Nanti
Kode FR	FR-08 FR-09

UC-05 : Melengkapi laporan realisasi yang tertunda

Aktor	Operator produksi
Deskripsi	Operator melengkapi realisasi SPK yang sebelumnya disimpan dengan Lakukan Nanti
Prekondisi	SPK berada di tab Kurang Laporan Realisasi
Alur utama	1. Operator klik Simpan pada baris SPK. 2. Sistem membuka form realisasi lanjutan dengan data sebelumnya. 3. Operator melengkapi realisasi lalu klik Simpan. 4. Sistem memperbarui SPK menjadi selesai.
Alur negatif	- Validasi bahan, biaya, bahan jadi, dan HPP sama seperti UC-04. - Jika gagal, muncul "Gagal Mengupdate Operator Produksi".
Bisnis rule	- Simpan menghasilkan status selesai.
Postkondisi	SPK pindah ke tab Selesai
Trigger	Operator klik Simpan pada form realisasi lanjutan
Kode FR	FR-08 FR-09

UC-06 : Melihat detail SPK

Aktor	Operator dengan hak lihat operator produksi
Deskripsi	Operator melihat isi SPK dari tab mana pun
Prekondisi	SPK tampil di salah satu tab
Alur utama	1. Operator memilih Lihat. 2. Sistem memuat detail SPK dan formula. 3. Sistem menampilkan tab bahan baku, bahan jadi, bahan pendukung, biaya langsung, dan modifier. 4. Bila SPK belum selesai, operator dapat klik Edit untuk pindah ke form sesuai status.
Alur negatif	- Jika detail gagal dimuat, muncul pesan error dan operator dikembalikan ke antrean.
Bisnis rule	- Tombol Edit hanya tampil untuk user dengan hak dasar dan SPK yang belum selesai. - SPK selesai draft diarahkan ke form realisasi lanjutan, SPK in progress ke form realisasi.
Postkondisi	Detail SPK tampil
Trigger	Operator memilih Lihat
Kode FR	FR-10

UC-07 : Mencetak dokumen SPK dari halaman operator

Aktor	Operator dengan hak cetak ulang operator produksi
Deskripsi	Operator mencetak dokumen pendukung pengerjaan produksi
Prekondisi	SPK berada di tab Belum Dikerjakan atau Selesai
Alur utama	1. Operator memilih Print. 2. Sistem memuat detail SPK. 3. Dari tab Belum Dikerjakan, sistem membuka cetak surat perintah produksi dan surat pengambilan barang. 4. Dari tab Selesai, sistem membuka cetak laporan realisasi dan penyerahan bahan jadi. 5. Operator memilih format lalu mencetak.
Alur negatif	- Jika detail gagal dimuat, muncul pesan error dari BE.
Bisnis rule	- Cetak dari tab Belum Dikerjakan butuh hak #operator-produksi reprint.
Postkondisi	Dokumen tercetak
Trigger	Operator memilih Print
Kode FR	FR-11

5. Data Flow Diagram

DFD-01

6. Sequence Diagram

SD-01 — UC-01 : Menampilkan antrean SPK operator per cabang, tanggal, dan line

SD-02 — UC-02 : Memulai produksi SPK

SD-03 — UC-03 : Mengubah informasi kepala SPK sebelum dikerjakan

SD-04 — UC-04 : Mencatat realisasi dan menyelesaikan produksi

SD-05 — UC-05 : Melengkapi laporan realisasi yang tertunda

SD-06 — UC-06 : Melihat detail SPK

SD-07 — UC-07 : Mencetak dokumen SPK dari halaman operator

7. Table Schema

8. API Schema

Endpoint	Status	Perubahan
GET /invoice-spk	existing	-
GET /invoice-spk/:id	existing	-
PUT /invoice-spk/update-all/:id	existing	-
GET /invoice-bom/:id	existing	-
GET /kop-surat	existing	-