Dokumen Apa yang Harus Diserahkan Vendor Perangkat Lunak Industri saat Serah Terima?

Apa yang terjadi jika sistem berjalan tetapi dokumen tidak pernah tiba?

Rapat serah terima sering memperlakukan dokumen sebagai sisa pekerjaan kertas. Sistem sudah jalan, operator sudah diajak melihat layar, berkas sisanya dijanjikan minggu depan. Minggu itu menjadi kuartal. Tim proyek bubar, dan orang yang bisa menjelaskan tag, tabel, atau pemetaan layar tidak lagi ditugaskan di lapangan.

Dampak dokumen yang hilang tidak muncul pada hari penerimaan. Ia muncul belakangan, dalam situasi yang hampir setiap pabrik temui. Proyek perangkat lunak industri — SCADA, MES, manajemen energi, atau integrasi lini — hanya bisa dirawat sejauh dokumennya masih bisa ditemukan dan dibaca.

• PLC diganti dan sebuah tag harus dipetakan ulang, tetapi tidak ada yang menemukan titik I/O atau register yang semula ditempatinya
• Laporan produksi harus diubah, tetapi tidak ada yang menuliskan tabel basis data mana yang dibacanya dan aturan agregasi mana yang dipakai
• Insinyur vendor semula sudah meninggalkan lokasi, dan pabrik tidak bisa melatih operator baru dari bahan yang benar-benar ada di tangan
• Kontraktor berikutnya diminta memperluas sistem, dan harus merekonstruksi alamat, layar, serta antarmuka sebelum pekerjaan baru bisa dimulai
• Sengketa pemeliharaan muncul, dan tidak ada daftar pemeliharaan yang bergulir atau laporan pemeliharaan tahunan yang menunjukkan apa yang benar-benar dikerjakan

Lima situasi ini adalah kehidupan biasa sistem setelah go-live, bukan kecelakaan langka. Empat belas jenis dokumen ada agar perubahan lini, pergantian staf, integrasi belakangan, dan tinjauan pemeliharaan tetap pekerjaan rutin, bukan penggalian arkeologi.

Empat belas dokumen mana yang masuk paket serah terima?

Satu set dokumen proyek industri yang lengkap mencakup empat belas jenis: proposal proyek, kesepakatan teknis, dokumen spesifikasi, tabel alokasi I/O, tabel alokasi alamat, diagram topologi jaringan, dokumen desain layar, panduan operasi, deskripsi tabel basis data, spesifikasi antarmuka data, laporan pengujian, berkas serah terima, daftar pemeliharaan, dan laporan pemeliharaan tahunan. Daftar datar nama berkas tidak membantu pembeli memeriksa kotak arsip. Mengelompokkannya menurut pertanyaan yang dijawab tiap kelompok justru membantu.

Tabel di bawah ditulis untuk rapat serah terima. Kolom ketiga bukan syarat keluar tahap; itu yang harus dilihat sebelum menandatangani lembar penerimaan.

Cantumkan daftar ini di kesepakatan teknis sebelum pekerjaan dimulai. Dokumen yang tidak disebut saat tanda tangan akan dibicarakan setelah tim proyek bubar, saat penyusunan ulang lambat dan sengketa sulit ditutup.

Apa yang harus dicek pembeli sebelum menandatangani serah terima?

Tanda tangan pada lembar penerimaan menutup proyek bagi vendor. Bagi pabrik, itu membuka masa di mana dokumen harus berdiri sendiri. Pertanyaan di bawah bisa diajukan satu per satu dalam rapat serah terima; jika jawabannya «akan dikirim nanti», butir itu belum diserahkan.

• Apakah keempat belas jenis disebut satu per satu dalam kesepakatan teknis, atau kontrak hanya menulis «dokumentasi» tanpa daftar?
• Untuk setiap dokumen yang disebut, apakah ini versi as-built yang cocok dengan I/O, alamat, layar, dan antarmuka yang terpasang?
• Dapatkah orang yang tidak ikut proyek mengikuti panduan operasi dan menyelesaikan satu shift tanpa menelepon vendor?
• Apakah laporan pengujian menyatakan kriteria, metode, hasil, dan tanggal, sehingga orang ketiga bisa membedakan lulus dan tidak lulus?
• Apakah deskripsi tabel basis data dan spesifikasi antarmuka data menyebut tabel, field, arah, dan pemilik data induk?
• Apakah daftar pemeliharaan dan laporan pemeliharaan tahunan sudah ada dalam templat yang bisa dipakai, sehingga pekerjaan tahun berikutnya punya garis dasar?
• Siapa yang memegang berkas sumber yang bisa diedit setelah serah terima — pabrik, atau hanya PDF yang disimpan vendor?

Pertanyaan terakhir paling sering dilewati. PDF yang sudah ditandatangani adalah catatan. Tabel I/O, tabel alamat, dan diagram jaringan yang bisa diedit adalah alat yang dibutuhkan pabrik ketika lini berubah. Catatan dan alat keduanya diperlukan; yang satu tidak menggantikan yang lain.

Dalam bahasa dan format apa dokumen harus diserahkan?

Dokumen yang tidak bisa dibaca operator tidak akan dipakai setelah go-live. Bahasa adalah syarat serah terima, bukan tugas terjemahan yang diselesaikan belakangan, dan harus ditulis di samping nama setiap dokumen dalam kesepakatan teknis. Untuk pabrik yang berkoordinasi dengan kontraktor luar negeri, set dokumen teknik biasanya perlu berbahasa Inggris.

Format juga menentukan apakah dokumen masih bisa dipakai. Pindaian gambar yang penuh coretan adalah catatan. Tabel alokasi I/O, tabel alokasi alamat, dan diagram topologi jaringan yang bisa diedit adalah alat lapangan. Keduanya diperlukan.

• Bahasa kerja rapat dan kontak tetap — kontak berbahasa Inggris yang bertahan sepanjang proyek, bukan penerjemah yang masuk sekali
• Bahasa spesifikasi dan panduan operasi — bahasa Inggris bagi operator dan staf pemeliharaan yang akan memakainya; berkas yang hanya sampulnya diterjemahkan, isi masih bahasa lain, tidak dihitung sudah diserahkan
• Format berkas — sumber yang bisa diedit (spreadsheet, gambar, dokumen) plus PDF bertanda tangan untuk arsip; nyatakan dokumen mana yang wajib dalam kedua bentuk
• Kendali revisi — setiap dokumen membawa versi, tanggal, dan tanda yang membedakan terbitan desain dari terbitan as-built

Tulis bahasa dan format ke tabel yang sama dengan nama dokumen. Vendor yang bisa mengisi tabel itu sebelum tanda tangan sudah memperlakukan dokumen sebagai hasil serah terima, bukan berkas yang dikumpulkan di ujung.