Gambaran Besar
Bayangin kamu baru beli motor baru. Ada buku manual, ada servis berkala, ada catatan siapa yang boleh servis dan gimana caranya. Nah, lab komputer sekolah juga butuh hal yang sama, tapi versi profesional.
Dokumentasi teknis adalah sekumpulan dokumen yang menjelaskan: apa isinya, bagaimana cara pakainya, siapa yang bertanggung jawab, dan apa yang harus dilakukan kalau ada masalah. Kalau dokumentasi ini bagus, teknisi baru pun bisa langsung kerja tanpa perlu tanya-tanya dari awal.
Ada 6 dokumen utama yang perlu dibuat, lalu digabung jadi satu paket dokumen lengkap.
Dokumen 1: Technical Specification Document
Ini adalah “kartu identitas” lab kamu. Semua spesifikasi teknis dicatat di sini.
Isinya:
- Deskripsi proyek: Lab ini untuk apa? Berapa siswa? Dipakai untuk mata pelajaran apa saja?
- Spesifikasi hardware (dalam bentuk tabel):
| No | Nama Perangkat | Merek/Model | Prosesor | RAM | Storage | Jumlah |
|---|---|---|---|---|---|---|
| 1 | PC Siswa | Lenovo ThinkCentre | Core i5 Gen 12 | 8 GB | 256 GB SSD | 30 unit |
| 2 | PC Guru | HP ProDesk | Core i7 Gen 12 | 16 GB | 512 GB SSD | 1 unit |
| 3 | Switch | TP-Link TL-SG1024 | – | – | – | 2 unit |
- Spesifikasi software: OS apa (misal Windows 11 Education), aplikasi apa saja yang terinstal, versi berapa.
- Arsitektur jaringan: gambar diagram sederhana, dari ISP → router → switch → PC.
- Skema IP addressing:
| Perangkat | IP Address | Subnet Mask | Gateway | Keterangan |
|---|---|---|---|---|
| Router | 192.168.1.1 | /24 | – | Gateway utama |
| PC Siswa 01 | 192.168.1.101 | /24 | 192.168.1.1 | – |
| PC Siswa 02 | 192.168.1.102 | /24 | 192.168.1.1 | – |
Dokumen 2: SOP (Standard Operating Procedure)
SOP itu seperti resep masakan. Langkahnya harus urut, jelas, dan siapapun yang baca bisa mengikutinya tanpa salah.
Format standar setiap SOP:
Judul SOP : Instalasi OS dari Master Image
Kode SOP : SOP-TKJ-001
Versi : 1.0
Tanggal : [tanggal berlaku]
Penanggung : Teknisi Lab / Guru TKJ
Isi prosedur (contoh untuk instalasi OS):
- Nyalakan PC, masuk ke BIOS dengan tombol F2/Del
- Set boot priority ke USB/Network (tergantung metode cloning)
- Jalankan software cloning (misal Clonezilla atau Acronis)
- Pilih master image yang sudah disiapkan
- Tunggu proses restore (biasanya 15-20 menit per unit)
- Setelah selesai, cabut media instalasi, restart
- Verifikasi: cek semua software berjalan normal
SOP lain yang perlu dibuat:
- SOP konfigurasi keamanan (password, antivirus, Windows Update)
- SOP backup harian (folder apa yang di-backup, jam berapa, ke mana)
- SOP troubleshooting (masalah umum + solusinya)
Setiap SOP dilengkapi formulir tanda tangan — bukti bahwa prosedur sudah dijalankan.
Dokumen 3: Network Documentation
Ini khusus untuk jaringan. Bedanya dengan Tech Spec: kalau Tech Spec bicara soal semua perangkat, Network Documentation fokus ke jaringan saja, lebih dalam.
Yang harus ada:
- Topologi fisik: kabel mana colok ke mana, jenis kabel (UTP Cat6), panjang kabel per segmen
- Topologi logis: bagaimana data mengalir, siapa dapat IP dari mana
- Tabel IP addressing (lebih lengkap dari Tech Spec, termasuk MAC address)
- Konfigurasi perangkat: konfigurasi router dan switch (bisa berupa screenshot atau copy-paste config)
- VLAN (kalau ada pemisahan jaringan, misal VLAN guru dan VLAN siswa)
- Daftar port switch: port 1 ke PC siapa, port 2 ke PC siapa, dst.
Dokumen 4: User Manual
User manual dibuat dua versi: satu untuk guru, satu untuk siswa. Bahasanya harus paling sederhana dari semua dokumen.
Isi User Manual Siswa:
- Cara login ke Windows (username dan password standar)
- Cara akses folder bersama (shared folder) di jaringan
- Cara mencetak dokumen ke printer lab
- Aturan penggunaan lab (larangan instal software sendiri, dll.)
- Siapa yang dihubungi kalau ada masalah (nama teknisi + nomor HP/ruangan)
Isi User Manual Guru:
- Cara login ke akun guru (privilege lebih tinggi dari siswa)
- Cara membagikan file ke semua PC siswa
- Cara mematikan semua PC sekaligus (kalau pakai software manajemen lab)
- Cara request perbaikan perangkat
Dokumen 5: Asset Inventory
Ini daftar semua aset lab, mirip laporan barang milik negara. Setiap barang punya nomor inventaris unik.
Format tabel:
| No Inv | Nama Aset | Merek/Model | Serial Number | Tgl Pengadaan | Kondisi | Lokasi | Keterangan |
|---|---|---|---|---|---|---|---|
| LAB-PC-001 | PC Siswa | Lenovo M70q | PF3XXXXX | 12 Jan 2024 | Baik | Meja 1 | – |
| LAB-PC-002 | PC Siswa | Lenovo M70q | PF3XXXXX | 12 Jan 2024 | Baik | Meja 2 | – |
| LAB-MON-001 | Monitor | LG 22MK400 | 401XXXXXX | 12 Jan 2024 | Baik | Meja 1 | – |
Kolom Kondisi diisi: Baik / Rusak Ringan / Rusak Berat / Hilang.
Dokumen 6: Menggabungkan Semua Dokumen
Setelah semua dokumen selesai, gabungkan jadi satu file master dengan struktur ini:
COVER PAGE
DOCUMENT INFORMATION
- Document ID : DOC-LAB-TKJ-2024
- Versi : 1.0
- Dibuat oleh : [nama]
- Disetujui : [kepala sekolah/ketua jurusan]
- Tanggal : [tanggal]
REVISION HISTORY
Ver | Tanggal | Perubahan | Oleh
1.0 | Jan 2024 | Dokumen pertama dibuat | [nama]
DAFTAR ISI
1. Technical Specification .............. hal. X
2. SOP ....................................... hal. X
3. Network Documentation ............. hal. X
4. User Manual ............................. hal. X
5. Asset Inventory ......................... hal. X
Apa yang Bisa Salah (Jebakan Umum)
Jebakan 1 – IP address tidak konsisten. Kamu tulis 192.168.1.101 di Tech Spec tapi 192.168.10.101 di Network Docs. Akibatnya dokumentasi tidak bisa dipercaya. Solusi: buat satu tabel IP master, semua dokumen lain merujuk ke sana.
Jebakan 2 – SOP terlalu umum. “Lakukan konfigurasi keamanan” itu bukan SOP. SOP harus spesifik: “Buka Control Panel → User Accounts → ubah password menjadi format NIS#Kelas.” Kalau teknisi baru masih harus menebak-nebak, SOP-nya gagal.
Jebakan 3 – Lupa update setelah ada perubahan. Lab dapat printer baru, tapi Asset Inventory tidak diupdate. Ini sangat umum terjadi. Buat kebiasaan: setiap ada perubahan, langsung update dokumen dan naikkan nomor versi.
Jebakan 4 – User manual pakai bahasa teknis. Tulis untuk orang yang tidak tahu teknologi. Jangan tulis “mount network drive,” tapi tulis “buka File Explorer, klik This PC, klik kanan → Add a network location.”
Tes Terakhir: Uji Dokumentasimu
Sebelum dinyatakan selesai, tanya satu pertanyaan ini:
“Apakah teknisi baru yang belum pernah lihat lab ini, bisa mengelola lab hanya dengan membaca dokumentasi ini?”
Kalau jawabannya tidak, cari bagian mana yang masih kurang jelas lalu perbaiki.
Kuis Singkat
-
Apa perbedaan utama antara Technical Specification Document dan Network Documentation? Mengapa keduanya perlu dibuat secara terpisah?
-
Sebuah SOP berisi langkah: “Lakukan instalasi OS sesuai kebutuhan.” Apa yang salah dari SOP ini, dan bagaimana cara memperbaikinya?
-
Kamu menemukan satu PC rusak di lab. Dokumen mana saja yang perlu diupdate setelah PC tersebut diperbaiki atau diganti? Sebutkan minimal dua.