Dokumen keperluan aplikasi: maksud spesifikasi aplikasi dan sebab anda perlu meluluskannya

Spesifikasi satu halaman yang anda luluskan dahulu: kulit catatan blog Deployflix

Dokumen keperluan aplikasi, atau spesifikasi aplikasi, ialah pelan bertulis ringkas bagi sebuah aplikasi sebelum sesiapa membinanya: siapa yang akan menggunakannya, skrin yang dilihat oleh setiap pengguna, maklumat yang disimpan, perkhidmatan yang disambungkan, perkara yang belum disertakan buat masa ini dan kos maksimum binaan. Anda membacanya, mengemukakan soalan dan mengubahnya. Anda hanya meluluskannya apabila spesifikasi itu benar-benar menerangkan aplikasi yang anda mahukan.

Anda perlu meluluskannya terlebih dahulu kerana spesifikasi ialah tempat paling murah untuk mengesan kesilapan. Mengalihkan satu baris pada halaman tidak melibatkan sebarang kos. Jika anda hanya mengetahui selepas aplikasi dibina bahawa tutor boleh melihat nombor telefon setiap ibu bapa, atau yuran tidak boleh dibayar secara ansuran, aplikasi itu perlu dibina semula.

Apakah spesifikasi perisian dalam bahasa mudah?

Dalam perisian, spesifikasi (bagi projek lebih besar, sering disebut dokumen keperluan atau SRS, iaitu spesifikasi keperluan perisian) ialah persetujuan antara orang yang memerlukan aplikasi dengan pihak yang membinanya. Spesifikasi menerangkan perkara yang mesti dilakukan oleh aplikasi, bukan cara kod melakukannya. Untuk kedai, kelab atau sekolah, satu halaman biasanya mencukupi, asalkan butirannya khusus dan ditulis dalam bahasa mudah.

Ujian bagi sesebuah spesifikasi mudah sahaja: bolehkah dua pembangun berbeza membacanya dan menghasilkan aplikasi yang lebih kurang sama? Jika halaman itu menyatakan pelajar boleh melihat keputusan mereka, itu sekadar hasrat. Jika dinyatakan pelajar log masuk menggunakan nombor telefon dan melihat markah ujian mereka sendiri mengikut mata pelajaran, bersebelahan purata kumpulan, itu ialah keperluan yang boleh dibina dan anda boleh semak.

Apakah yang perlu ada dalam dokumen keperluan aplikasi satu halaman?

Ambil contoh sebuah pusat tuisyen yang mahukan aplikasi untuk kelas, kehadiran dan yuran. Spesifikasi satu halaman yang berguna merangkumi bahagian berikut:

Bahagian spesifikasiPerkara yang dinyatakanContoh untuk pusat tuisyen
Siapa yang menggunakannyaSetiap jenis pengguna yang log masuk dan perkara yang boleh mereka lakukanPemilik, tutor, pelajar dan ibu bapa; hanya pemilik boleh melihat jumlah yuran
Skrin mengikut perananHalaman yang dilihat oleh setiap peranan dan perkara yang dilakukan di situTutor: kelas hari ini, catat kehadiran, masukkan markah ujian. Ibu bapa: kehadiran, markah, yuran yang perlu dibayar
Data yang disimpanRekod yang disimpan oleh aplikasi dan butiran dalam setiap rekodPelajar, kelas, kehadiran setiap sesi, ujian dan markah, ansuran yuran serta resit
PenyepaduanPerkhidmatan luar yang disambungkan dan cara sambungannyaPembayaran yuran dalam talian melalui gerbang pembayaran, dengan resit bagi setiap ansuran
Ditangguhkan buat masa iniPerkara yang tidak akan dilakukan oleh versi iniTiada semakan pertembungan jadual; tiada import rekod tahun lalu
Had kosKos maksimum binaanJumlah maksimum dipaparkan sebelum kelulusan, bukan anggaran selepas kerja dilakukan

Bahagian skrin mengikut peranan sering dibaca sepintas lalu, tetapi bahagian inilah yang paling penting. Sesebuah aplikasi sebenarnya terdiri daripada beberapa aplikasi yang berkongsi satu set data: paparan pemilik, paparan tutor dan paparan ibu bapa. Dengan membaca skrin mengikut setiap peranan, anda boleh menyedari bahawa tutor boleh mencatat kehadiran tetapi tiada sesiapa boleh membetulkan kesilapan pada rekod itu.

Baris tidak disertakan buat masa ini juga sama penting. Baris ini menjelaskan perkara yang tidak akan anda peroleh, yang biasanya menjadi punca kekecewaan selepas binaan siap. Senarai pengecualian yang ringkas dan jujur menandakan spesifikasi yang baik, bukannya spesifikasi yang lemah.

Apabila anda menerangkan aplikasi kepada Deployflix, spesifikasi yang dihasilkannya mengikut susunan ini: siapa yang menggunakan aplikasi, skrin aplikasi, data yang disimpan, perkara yang tidak disertakan buat masa ini dan kos maksimum binaan, semuanya dalam bahasa yang anda gunakan. Jika ada perkara yang kurang jelas dalam penerangan anda, Deployflix akan bertanya sebelum menyediakan rancangan. Cara ia berfungsi menunjukkan kedudukan spesifikasi dalam keseluruhan proses.

Bagaimanakah anda membaca dan menilai spesifikasi aplikasi?

Jangan baca spesifikasi seperti kontrak, dari awal hingga akhir. Bacalah seolah-olah anda menjalani satu hari dalam perniagaan anda.

  1. Teliti satu hari sebenar bagi setiap peranan. Apakah yang mereka ketik, lihat dan masukkan? Kemudian lakukan perkara yang sama untuk setiap peranan lain.
  2. Ikuti satu rekod dari mula hingga akhir. Pilih seorang pelajar, satu pesanan atau satu tempahan. Siapa yang menciptanya, siapa yang mengubahnya, siapa yang boleh memadamkannya dan ke manakah rekod itu akhirnya pergi?
  3. Periksa situasi apabila berlaku masalah. Tempahan yang dibatalkan, bayaran balik, catatan yang salah, pembayaran yang gagal atau ahli yang berhenti. Jika spesifikasi hanya menerangkan keadaan apabila semuanya berjalan lancar, tanyakan perkara yang berlaku apabila sebaliknya.
  4. Semak setiap nombor dan perkataan yang akan dicetak. Format invois, ansuran yuran, butiran cukai dan nombor resit hendaklah sepadan dengan cara anda bekerja sekarang. Jika invois anda perlu memaparkan cukai seperti GST, VAT atau cukai jualan, semak butirannya dengan akauntan anda.
  5. Tanyakan apa-apa yang kurang jelas. Perkataan seperti urus, jejak, mudah dan laporan boleh menyembunyikan keputusan yang perlu dibuat. Tanyakan: laporan yang mana, memaparkan apa dan untuk siapa?

Apakah jurang yang perlu anda cari sebelum meluluskan?

Kebanyakan spesifikasi yang menimbulkan masalah sebenarnya bukan salah, tetapi tidak lengkap. Berikut ialah jurang yang paling kerap berlaku.

Siapa boleh melihat apa

Peranan mudah dinamakan tetapi juga mudah dibiarkan kabur. Semak perkara yang boleh dilihat oleh setiap peranan, bukan sekadar perkara yang boleh dilakukan. Bolehkah tutor melihat yuran? Bolehkah seorang ibu atau bapa melihat markah anak orang lain? Bolehkah pekerja memuat turun senarai pelanggan? Jika aplikasi menyimpan maklumat peribadi, tentukan sekarang siapa yang boleh melihatnya.

Mengedit, membatalkan dan membuat asal

Setiap rekod akhirnya perlu dibetulkan. Pastikan spesifikasi menyatakan siapa yang boleh mengedit atau membatalkan catatan dan sama ada nilai lama disimpan.

Wang

Jika aplikasi menerima pembayaran, spesifikasi perlu menunjukkan langkah pembayaran: cara pelanggan boleh membayar (kad dan kaedah pembayaran tempatan), perkara yang dibayar, sama ada bayaran sebahagian dibenarkan, perkara yang diterima pelanggan selepas itu, dan apa yang berlaku jika bayaran belum dibuat atau pembayaran gagal. Peraturan bayaran balik ialah keputusan perniagaan, jadi tuliskan peraturan anda. Gerbang pembayaran biasanya mengenakan caj peratusan bagi setiap transaksi, ditambah caj tetap di banyak negara, jadi semak halaman harga gerbang pembayaran anda. Aplikasi Deployflix menerima pembayaran melalui gerbang pembayaran seperti Razorpay atau Cashfree; gerbang pembayaran antarabangsa akan tersedia tidak lama lagi. Halaman penyepaduan kami menunjukkan perkhidmatan yang boleh disambungkan pada masa ini.

Mesej dan peringatan

Jika anda mahu menghantar peringatan, nyatakan cara peringatan itu perlu disampaikan: melalui e-mel, dalam aplikasi atau cara lain. Jika spesifikasi tidak menyebut salurannya, anggap saluran itu tidak disediakan.

Data sedia ada anda

Data dalam hamparan dan daftar lama selalunya perlu dipindahkan ke aplikasi baharu. Tanyakan sama ada proses memasukkan data itu termasuk dalam spesifikasi atau berada dalam senarai tidak disertakan.

Peranti dan bahasa

Adakah pengguna akan menggunakannya pada telefon, komputer di kaunter kedai atau kedua-duanya? Adakah aplikasi perlu tersedia dalam bahasa Sepanyol, Arab, Perancis atau bahasa lain selain bahasa Inggeris? Perkara ini menentukan reka bentuk skrin, jadi putuskan sebelum binaan bermula. Deployflix menulis kandungan aplikasi anda dalam bahasa yang anda minta dan boleh digunakan dalam 41 bahasa.

Mengapakah spesifikasi perlu diluluskan sebelum apa-apa dibina?

Kerana mengubah ayat lebih murah daripada mengubah aplikasi. Sebelum binaan bermula, menambah peranan ibu bapa atau ansuran yuran hanya memerlukan suntingan pada satu halaman. Selepas binaan siap, perubahan yang sama boleh melibatkan skrin, data dan kebenaran yang sudah disiapkan.

Kelulusan juga memberi anda sesuatu untuk dijadikan rujukan semasa menyemak aplikasi yang siap. Setelah binaan selesai, buka spesifikasi dan semak satu demi satu: setiap peranan, setiap skrin dan setiap data. Jika ada yang tiada, anda berhak membangkitkannya.

Spesifikasi juga menetapkan kos sebelum anda membuat komitmen. Apabila kos maksimum pembinaan dinyatakan dalam spesifikasi, anda boleh membuat keputusan dengan mengetahui jumlahnya. Di Deployflix, had kos itu dipaparkan sebelum anda meluluskan pembinaan, dan anda hanya membayar untuk penggunaan sebenar semasa pembinaan, seperti yang diterangkan di halaman harga.

Bagaimanakah perubahan dirancang selepas aplikasi dibina?

Sesebuah aplikasi jarang benar-benar siap. Kursus baharu, lokasi kedua atau cara baharu mengutip yuran: setiap perubahan perlu dirancang dengan teliti seperti binaan pertama.

Rancang setiap perubahan sebagai spesifikasi kecil yang tersendiri: perkara yang berubah, peranan dan skrin yang terlibat, data yang ditambah atau diubah, perkara yang kekal sama serta kos maksimumnya. Baca dengan soalan yang sama dan luluskan sebelum kerja bermula. Simpan versi terdahulu supaya anda boleh kembali kepada versi yang berfungsi jika perubahan itu menimbulkan masalah.

Beginilah Deployflix mengendalikan perubahan: anda nyatakan perkara yang perlu diubah, Deployflix merancang perubahan itu sebagai versi seterusnya dan tiada apa-apa dibina sehingga anda meluluskannya. Setiap versi terdahulu disimpan. Dalam sesebuah organisasi, hanya pengguna yang peranannya membenarkan kelulusan boleh meluluskannya, seperti yang diterangkan pada halaman keselamatan.

Templat spesifikasi aplikasi yang boleh anda gunakan

Jika anda menulis spesifikasi sendiri, salin tajuk berikut dan isi setiap bahagian dengan ayat yang mudah:

  • Aplikasi dalam satu ayat: untuk siapa aplikasi itu dan tugas yang dilakukannya.
  • Peranan: setiap jenis pengguna serta perkara yang boleh mereka lihat dan lakukan.
  • Skrin mengikut peranan: skrin bagi setiap peranan dan perkara yang berlaku pada setiap skrin.
  • Data yang disimpan: setiap jenis rekod dan butiran yang terkandung di dalamnya.
  • Penyepaduan: pembayaran, domain anda, kedai aplikasi, tempat kod disimpan dan apa-apa perkhidmatan lain yang disambungkan.
  • Peraturan: yuran, had, tarikh akhir, pembatalan dan bayaran balik.
  • Tidak disertakan buat masa ini: perkara yang tidak akan dilakukan oleh versi ini.
  • Had kos dan kelulusan: kos maksimum dan siapa yang memberikan kelulusan.

Untuk melihat contoh lengkap bagi peranan, skrin dan data, rujuk sistem pengurusan kumpulan bimbinganEN atau aplikasi tempahan janji temu klinikEN. Pengasas yang sedang menguji idea boleh menyediakan spesifikasi yang lebih ringkas, dengan satu peranan, beberapa skrin dan senarai jelas perkara yang tidak disertakan, seperti aplikasi web MVP syarikat pemulaEN.

Soalan

Apakah perbezaan antara spesifikasi aplikasi dengan dokumen keperluan?

Perbezaannya terutama pada panjang dan tahap formaliti. Dokumen keperluan bagi projek besar boleh merangkumi banyak halaman keperluan bernombor. Spesifikasi aplikasi untuk perniagaan kecil merangkumi perkara yang sama (siapa yang menggunakannya, perkara yang dilakukannya dan data yang disimpan) dalam satu halaman dengan bahasa yang mudah.

Siapakah yang patut menulis spesifikasi aplikasi?

Orang yang memahami perniagaan menyediakan kandungannya: peranan, kerja harian dan peraturan. Pembangun boleh menyusunnya menjadi spesifikasi yang teratur, tetapi hanya anda boleh menentukan sama ada spesifikasi itu tepat.

Bolehkah saya mengubah spesifikasi selepas meluluskannya?

Ya. Anggapnya sebagai satu perubahan: terangkan perkara yang berbeza, baca rancangan yang dikemas kini dan luluskan sekali lagi. Simpan versi terdahulu supaya anda boleh membandingkan atau kembali kepadanya.

Berapa panjangkah spesifikasi aplikasi yang sepatutnya?

Cukup panjang agar tiada perkara penting dibiarkan sebagai tekaan, tetapi cukup ringkas agar anda membacanya hingga habis. Bagi kebanyakan aplikasi perniagaan kecil, satu halaman sudah sesuai; jika terlalu panjang, pertimbangkan untuk membinanya secara berperingkat.

Terangkan aplikasi anda

Tulis perkara yang anda perlukan dengan kata-kata anda sendiri. Deployflix menyediakan pelan satu halaman berserta kosnya dan hanya mula membina selepas anda meluluskannya.