Dokumen kebutuhan aplikasi: apa itu spesifikasi aplikasi dan mengapa Anda menyetujuinya

Spesifikasi satu halaman yang Anda setujui lebih dulu: sampul artikel blog Deployflix

Dokumen kebutuhan aplikasi, atau spesifikasi aplikasi, adalah rencana tertulis singkat sebuah aplikasi sebelum ada yang membangunnya: siapa yang akan memakainya, layar yang dilihat setiap orang, informasi yang disimpan, layanan yang terhubung dengannya, apa yang ditunda dulu, dan biaya maksimal build-nya. Anda membacanya, mempertanyakannya, dan mengubahnya, dan baru setelah spesifikasi itu menggambarkan aplikasi yang benar-benar Anda inginkan, Anda menyetujuinya.

Anda menyetujuinya lebih dulu karena spesifikasi adalah tempat termurah untuk menemukan kesalahan. Memindahkan satu baris di sebuah halaman tidak memakan biaya. Baru tahu setelah build bahwa tutor bisa melihat nomor telepon semua orang tua, atau bahwa biaya tidak bisa dicicil, berarti harus membangun ulang.

Apa itu spesifikasi software, dalam bahasa sederhana?

Dalam software, spesifikasi (dalam proyek besar sering disebut dokumen kebutuhan, atau SRS, singkatan dari software requirements specification) adalah kesepakatan antara orang yang membutuhkan aplikasi dan siapa pun yang membangunnya. Isinya menyebutkan apa yang harus dilakukan aplikasi, bukan bagaimana kodenya melakukannya. Untuk toko, klub, atau sekolah, satu halaman biasanya sudah cukup, asalkan spesifik dan ditulis dengan bahasa sederhana.

Ujian sebuah spesifikasi sederhana: bisakah dua pembuat aplikasi yang berbeda membacanya dan membuat aplikasi yang kurang lebih sama? Jika halamannya menyebutkan murid bisa melihat hasil mereka, itu masih keinginan. Jika menyebutkan murid masuk dengan nomor telepon dan melihat nilai ujiannya sendiri, per mata pelajaran, di samping rata-rata kelompok belajarnya, itulah kebutuhan yang bisa dibangun seseorang dan bisa Anda periksa.

Apa isi dokumen kebutuhan aplikasi satu halaman?

Misalkan ada lembaga bimbingan belajar yang menginginkan aplikasi untuk kelas, kehadiran, dan biaya. Spesifikasi satu halaman yang berguna untuknya memiliki bagian-bagian berikut:

Bagian spesifikasiIsinyaContoh untuk lembaga bimbingan belajar
Siapa yang memakainyaSetiap jenis orang yang masuk, dan apa yang boleh mereka lakukanPemilik, tutor, murid, dan orang tua; hanya pemilik yang melihat total biaya
Layar per peranHalaman yang dilihat setiap peran dan apa yang mereka lakukan di sanaTutor: kelas hari ini, mencatat kehadiran, memasukkan nilai ujian. Orang tua: kehadiran, nilai, biaya yang jatuh tempo
Data yang disimpanData yang disimpan aplikasi dan isi masing-masingMurid, kelas, kehadiran per sesi, ujian dan nilai, cicilan biaya dan kuitansi
IntegrasiLayanan luar yang terhubung, dan caranyaPembayaran biaya secara online melalui gateway pembayaran, dengan kuitansi untuk setiap cicilan
Ditunda duluApa yang tidak dilakukan versi iniTidak ada pengecekan bentrok jadwal; tidak ada impor data tahun lalu
Batas biayaBiaya maksimal build-nyaBatas maksimal yang ditampilkan sebelum persetujuan, bukan perkiraan setelah pekerjaan selesai

Layar per peran adalah bagian yang sering hanya dibaca sekilas, padahal paling penting. Sebuah aplikasi sebenarnya adalah beberapa aplikasi yang berbagi satu kumpulan data: tampilan pemilik, tampilan tutor, dan tampilan orang tua. Dengan membaca layar per peran, Anda bisa menyadari bahwa tutor bisa mencatat kehadiran tetapi tidak ada yang bisa memperbaiki kesalahan di dalamnya.

Baris ditunda dulu sama pentingnya. Baris ini memberi tahu apa yang tidak Anda dapatkan, yang biasanya menjadi sumber kekecewaan setelah build. Daftar pengecualian yang singkat dan jujur adalah tanda spesifikasi yang baik, bukan yang lemah.

Saat Anda menjelaskan aplikasi kepada Deployflix, spesifikasi yang ditulisnya mengikuti bentuk ini: siapa yang memakai aplikasi, layar-layarnya, data yang disimpan, apa yang ditunda dulu, dan biaya maksimal build-nya, dalam bahasa yang Anda pakai untuk menulis. Jika ada yang kurang jelas dalam penjelasan Anda, Deployflix bertanya sebelum menyusun rencana. Cara kerjanya menunjukkan posisi spesifikasi di antara langkah-langkahnya.

Bagaimana cara membaca dan mempertanyakan spesifikasi aplikasi?

Jangan membaca spesifikasi seperti kontrak, dari atas ke bawah. Bacalah seperti menjalani satu hari di bisnis Anda.

  1. Jalani satu hari nyata sebagai setiap peran. Apa yang mereka ketuk, apa yang mereka lihat, apa yang mereka masukkan? Lalu lakukan hal yang sama untuk setiap peran lainnya.
  2. Ikuti satu data dari awal sampai akhir. Pilih satu murid, pesanan, atau booking. Siapa yang membuatnya, siapa yang mengubahnya, siapa yang bisa menghapusnya, dan di mana ujungnya?
  3. Cari jalur yang tidak mulus. Booking yang dibatalkan, pengembalian dana, entri yang salah, pembayaran yang gagal, anggota yang keluar. Jika spesifikasinya hanya menggambarkan hal-hal yang berjalan lancar, tanyakan apa yang terjadi jika tidak.
  4. Periksa setiap angka dan kata yang akan Anda cetak. Format faktur, cicilan biaya, baris pajak, dan nomor kuitansi harus sesuai dengan cara kerja Anda saat ini. Jika faktur Anda harus mencantumkan pajak seperti GST, PPN, atau pajak penjualan, periksa detailnya dengan akuntan Anda.
  5. Tanyakan apa pun yang samar. Kata-kata seperti mengelola, melacak, mudah, dan laporan menyembunyikan keputusan. Tanyakan: laporan yang mana, menampilkan apa, untuk siapa?

Celah apa saja yang perlu dicari sebelum menyetujui?

Sebagian besar spesifikasi yang bermasalah sebenarnya tidak salah; spesifikasi itu tidak lengkap. Berikut celah yang paling sering muncul.

Siapa boleh melihat apa

Peran mudah disebutkan dan mudah dibiarkan samar. Periksa apa yang bisa dilihat setiap peran, bukan hanya apa yang bisa dilakukannya. Bisakah tutor melihat biaya? Bisakah satu orang tua melihat nilai anak lain? Bisakah staf mengunduh daftar pelanggan? Jika aplikasi menyimpan informasi pribadi, tentukan sekarang siapa yang boleh melihatnya.

Mengedit, membatalkan, dan mengurungkan

Setiap data suatu hari pasti perlu dikoreksi. Pastikan spesifikasinya menyebutkan siapa yang bisa mengedit atau membatalkan sebuah entri, dan apakah nilai lamanya tetap disimpan.

Uang

Jika aplikasi menerima pembayaran, spesifikasi harus menunjukkan langkah-langkah pembayarannya: metode yang dapat digunakan pelanggan (kartu dan metode pembayaran lokal), apa yang dibayar, apakah pembayaran sebagian diperbolehkan, apa yang diterima pelanggan setelahnya, dan apa yang terjadi jika pembayaran belum dilakukan atau gagal. Aturan pengembalian dana adalah keputusan bisnis, jadi tuliskan aturan Anda. Gerbang pembayaran biasanya mengenakan persentase per transaksi, ditambah biaya tetap di banyak negara, jadi periksa halaman harga penyedia Anda. Aplikasi Deployflix menerima pembayaran melalui gerbang pembayaran seperti Razorpay atau Cashfree; gerbang pembayaran internasional akan segera tersedia. Halaman integrasi kami menampilkan layanan yang saat ini dapat dihubungkan.

Pesan dan pengingat

Jika Anda mengharapkan pengingat, sebutkan bagaimana pengingat itu sampai ke orang: lewat email, di dalam aplikasi, atau cara lain. Jika spesifikasinya tidak menyebutkan salurannya, anggap saja fitur itu tidak ada.

Data yang sudah Anda punya

Spreadsheet dan buku catatan lama sering kali perlu dipindahkan ke aplikasi baru. Tanyakan apakah memindahkannya termasuk dalam spesifikasi atau masuk ke daftar ditunda dulu.

Perangkat dan bahasa

Apakah orang akan menggunakannya di ponsel, komputer di meja kasir, atau keduanya? Apakah aplikasi juga perlu tersedia dalam bahasa Spanyol, Arab, Prancis, atau bahasa lain selain Inggris? Hal-hal ini menentukan desain layar, jadi tetapkan sebelum pembangunan dimulai. Deployflix menulis teks aplikasi Anda dalam bahasa yang Anda minta, dan Deployflix sendiri tersedia dalam 41 bahasa.

Mengapa menyetujui spesifikasi sebelum apa pun dibangun?

Karena mengubah satu kalimat lebih murah daripada mengubah aplikasi. Sebelum build, menambahkan peran orang tua atau cicilan biaya hanyalah mengedit sebuah halaman. Setelah build, perubahan yang sama bisa menyentuh layar, data, dan izin akses yang sudah selesai.

Menyetujui juga memberi Anda acuan untuk memeriksa aplikasi yang sudah jadi. Setelah build selesai, buka spesifikasinya dan centang satu per satu: setiap peran, setiap layar, setiap data. Apa pun yang terlewat wajar untuk Anda sampaikan.

Spesifikasi juga memperjelas biaya sebelum Anda memutuskan untuk melanjutkan. Saat biaya maksimum proses pembangunan tercantum dalam spesifikasi, Anda dapat mengambil keputusan dengan mengetahui angkanya. Di Deployflix, batas biaya itu ditampilkan sebelum Anda menyetujuinya, dan Anda hanya membayar sesuai penggunaan sebenarnya selama proses pembangunan, seperti yang dijelaskan di halaman harga.

Bagaimana perubahan direncanakan setelah aplikasi dibangun?

Aplikasi jarang benar-benar selesai. Kursus baru, lokasi kedua, cara baru menagih biaya: masing-masing layak ditangani dengan kecermatan yang sama seperti build pertama.

Rencanakan perubahan sebagai spesifikasi kecil tersendiri: apa yang berubah, peran dan layar mana yang terdampak, data apa yang ditambahkan atau diubah, apa yang tetap sama, dan berapa biayanya. Bacalah dengan pertanyaan yang sama dan setujui sebelum pekerjaan dimulai. Simpan versi sebelumnya, supaya jika perubahannya bermasalah, Anda bisa kembali ke versi yang berfungsi.

Begitulah cara Deployflix menangani perubahan: Anda menyebutkan apa yang perlu diubah, Deployflix merencanakan perubahan itu sebagai versi berikutnya, dan tidak ada yang dibangun sebelum disetujui. Setiap versi sebelumnya tetap disimpan. Dalam sebuah organisasi, hanya orang yang perannya mengizinkan yang bisa menyetujui, seperti dijelaskan di halaman keamanan.

Template spesifikasi aplikasi yang bisa Anda pakai

Jika Anda menulis spesifikasi sendiri, salin judul-judul berikut dan isi masing-masing dengan kalimat sederhana:

  • Aplikasi dalam satu kalimat: untuk siapa dan tugas apa yang dikerjakannya.
  • Peran: setiap jenis pengguna dan apa yang boleh mereka lihat dan lakukan.
  • Layar per peran: untuk setiap peran, layar-layarnya dan apa yang terjadi di masing-masing.
  • Data yang disimpan: setiap jenis data dan detail yang dimuatnya.
  • Integrasi: pembayaran, domain Anda, toko aplikasi, tempat kode disimpan, dan apa pun yang terhubung dengannya.
  • Aturan: biaya, batasan, tenggat waktu, pembatalan, dan pengembalian dana.
  • Ditunda dulu: apa yang tidak dilakukan versi ini.
  • Batas biaya dan persetujuan: biaya maksimalnya, dan siapa yang memberi persetujuan akhir.

Untuk contoh peran, layar, dan data, lihat sistem pengelolaan kelompok belajar bimbelEN atau aplikasi booking janji temu klinikEN. Pendiri yang sedang menguji ide bisa membuat spesifikasinya lebih singkat lagi, dengan satu peran, beberapa layar, dan daftar tegas tentang apa yang ditunda, seperti untuk aplikasi web MVP startupEN.

Pertanyaan

Apa perbedaan spesifikasi aplikasi dan dokumen kebutuhan?

Terutama panjang dan tingkat formalitasnya. Dokumen kebutuhan untuk proyek besar bisa berisi banyak halaman kebutuhan bernomor. Spesifikasi aplikasi untuk usaha kecil membahas hal yang sama (siapa yang memakainya, apa yang dilakukannya, apa yang disimpannya) dalam satu halaman, dengan bahasa sederhana.

Siapa yang sebaiknya menulis spesifikasi aplikasi?

Orang yang memahami bisnisnya yang menyediakan isinya: peran, pekerjaan sehari-hari, dan aturannya. Pembuat aplikasi bisa mengubahnya menjadi spesifikasi yang terstruktur, tetapi hanya Anda yang bisa menilai apakah isinya sudah benar.

Bisakah saya mengubah spesifikasi setelah menyetujuinya?

Bisa. Perlakukan sebagai perubahan: jelaskan apa yang berbeda, baca rencana yang diperbarui, lalu setujui lagi. Simpan versi sebelumnya agar Anda bisa membandingkan atau kembali.

Seberapa panjang spesifikasi aplikasi seharusnya?

Cukup panjang agar tidak ada hal penting yang dibiarkan ditebak, dan cukup pendek agar Anda mau membaca seluruhnya. Untuk sebagian besar aplikasi usaha kecil, satu halaman sudah tepat; jika jauh lebih panjang, pertimbangkan untuk membangunnya secara bertahap.

Jelaskan aplikasi Anda

Tuliskan kebutuhan Anda dengan kata-kata Anda sendiri. Deployflix menulis rencana satu halaman beserta biayanya, dan baru membangun setelah Anda menyetujuinya.