
เอกสารข้อกำหนดของแอป หรือสเปกแอป คือแผนสั้นๆ แบบลายลักษณ์อักษรของแอปก่อนที่ใครจะเริ่มสร้าง: ใครจะใช้ หน้าจอที่แต่ละคนเห็น ข้อมูลที่แอปเก็บ บริการที่เชื่อมต่อ สิ่งที่ยังไม่รวมในตอนนี้ และค่าใช้จ่ายสูงสุดของการบิลด์ คุณอ่าน ตั้งคำถาม และแก้ไข และเมื่อมันอธิบายแอปที่คุณต้องการจริงๆ แล้วเท่านั้น คุณจึงอนุมัติ
คุณอนุมัติสเปกก่อน เพราะสเปกคือที่ที่หาข้อผิดพลาดได้ถูกที่สุด การย้ายบรรทัดหนึ่งบนหน้ากระดาษไม่มีค่าใช้จ่าย แต่การมารู้หลังสร้างเสร็จว่าติวเตอร์เห็นเบอร์โทรของผู้ปกครองทุกคน หรือจ่ายค่าเรียนเป็นงวดไม่ได้ หมายถึงต้องสร้างใหม่
ข้อกำหนดซอฟต์แวร์ (software specification) คืออะไร แบบเข้าใจง่าย
ในงานซอฟต์แวร์ ข้อกำหนด (ในโครงการขนาดใหญ่มักเรียกว่าเอกสารข้อกำหนด หรือ SRS ย่อมาจาก software requirements specification) คือข้อตกลงระหว่างคนที่ต้องการแอปกับผู้ที่สร้างแอป ระบุว่าแอปต้องทำอะไร ไม่ใช่ว่าโค้ดทำอย่างไร สำหรับร้านค้า ชมรม หรือโรงเรียน หนึ่งหน้ามักเพียงพอ ตราบใดที่เจาะจงและเขียนด้วยภาษาง่ายๆ
วิธีทดสอบสเปกนั้นง่าย: ถ้าผู้สร้างสองคนอ่านแล้ว จะสร้างแอปที่ใกล้เคียงกันได้ไหม ถ้าในหน้าเขียนว่า นักเรียนดูผลการเรียนได้ นั่นคือความปรารถนา ถ้าเขียนว่า นักเรียนลงชื่อเข้าใช้ด้วยเบอร์โทรศัพท์ และเห็นคะแนนสอบของตัวเองแยกตามวิชา เทียบกับค่าเฉลี่ยของกลุ่มเรียน นั่นคือข้อกำหนดที่มีคนสร้างได้และคุณตรวจสอบได้
เอกสารข้อกำหนดของแอปหนึ่งหน้ามีอะไรบ้าง
ลองนึกถึงศูนย์กวดวิชาที่ต้องการแอปสำหรับชั้นเรียน การเช็กชื่อ และค่าเรียน สเปกหนึ่งหน้าที่มีประโยชน์สำหรับศูนย์นี้มีส่วนต่าง ๆ ดังนี้:
| ส่วนของสเปก | ระบุอะไร | ตัวอย่างสำหรับศูนย์กวดวิชา |
|---|---|---|
| ใครใช้ | คนแต่ละประเภทที่ลงชื่อเข้าใช้ และสิ่งที่เขาทำได้ | เจ้าของ ติวเตอร์ นักเรียน และผู้ปกครอง มีเพียงเจ้าของที่เห็นยอดรวมค่าเรียน |
| หน้าจอตามบทบาท | หน้าที่แต่ละบทบาทเห็น และสิ่งที่ทำในหน้านั้น | ติวเตอร์: ชั้นเรียนวันนี้ เช็กชื่อ กรอกคะแนนสอบ ผู้ปกครอง: การเข้าเรียน คะแนน ค่าเรียนที่ต้องจ่าย |
| ข้อมูลที่เก็บ | ข้อมูลที่แอปจัดเก็บ และสิ่งที่แต่ละอย่างมี | นักเรียน ชั้นเรียน การเช็กชื่อในแต่ละคาบ การสอบและคะแนน งวดค่าเรียนและใบเสร็จ |
| การเชื่อมต่อ | บริการภายนอกที่เชื่อมต่อ และเชื่อมต่ออย่างไร | ชำระค่าเรียนออนไลน์ผ่านเกตเวย์การชำระเงิน พร้อมใบเสร็จสำหรับแต่ละงวด |
| ยังไม่รวมในตอนนี้ | สิ่งที่เวอร์ชันนี้จะไม่ทำ | ไม่ตรวจสอบตารางเรียนที่ชนกัน ไม่นำเข้าข้อมูลของปีที่แล้ว |
| เพดานค่าใช้จ่าย | ค่าใช้จ่ายสูงสุดของการบิลด์ | ยอดสูงสุดที่แสดงก่อนอนุมัติ ไม่ใช่ค่าประมาณหลังทำงานเสร็จ |
หน้าจอตามบทบาทคือส่วนที่คนมักอ่านผ่าน ๆ แต่สำคัญที่สุด แอปหนึ่งแอปจริง ๆ คือหลายแอปที่ใช้ข้อมูลชุดเดียวกัน: มุมมองของเจ้าของ มุมมองของติวเตอร์ และมุมมองของผู้ปกครอง การอ่านหน้าจอทีละบทบาทคือวิธีที่คุณจะสังเกตเห็นว่าติวเตอร์เช็กชื่อได้ แต่ไม่มีใครแก้ข้อผิดพลาดในการเช็กชื่อได้เลย
บรรทัดยังไม่รวมในตอนนี้ก็สำคัญไม่แพ้กัน บอกคุณว่าอะไรที่คุณจะไม่ได้ ซึ่งมักเป็นต้นเหตุของความผิดหวังหลังสร้างเสร็จ รายการสิ่งที่ไม่รวมที่สั้นและตรงไปตรงมาคือสัญญาณของสเปกที่ดี ไม่ใช่สเปกที่อ่อน
เมื่อคุณอธิบายแอปให้ Deployflix สเปกที่ระบบเขียนจะมีรูปแบบนี้: ใครใช้แอป หน้าจอ ข้อมูลที่เก็บ สิ่งที่ยังไม่รวมในตอนนี้ และค่าใช้จ่ายสูงสุดของการบิลด์ ในภาษาที่คุณเขียน ถ้ามีอะไรในคำอธิบายไม่ชัดเจน ระบบจะถามก่อนวางแผน วิธีการทำงานแสดงว่าสเปกอยู่ตรงไหนในขั้นตอนทั้งหมด
จะอ่านสเปกแอปและตั้งคำถามอย่างไร
อย่าอ่านสเปกเหมือนสัญญาจากบนลงล่าง ให้อ่านเหมือนหนึ่งวันในธุรกิจของคุณ
- ไล่ดูหนึ่งวันจริงในฐานะแต่ละบทบาท เขาแตะอะไร เห็นอะไร กรอกอะไร แล้วทำแบบเดียวกันกับทุกบทบาท
- ติดตามข้อมูลหนึ่งรายการตั้งแต่ต้นจนจบ เลือกนักเรียน คำสั่งซื้อ หรือการจองหนึ่งรายการ ใครสร้าง ใครแก้ไข ใครลบได้ และสุดท้ายไปอยู่ที่ไหน
- มองหากรณีที่ไม่เป็นไปตามแผน การจองที่ถูกยกเลิก การคืนเงิน การกรอกผิด การชำระเงินที่ล้มเหลว สมาชิกที่ลาออก ถ้าสเปกอธิบายแค่กรณีที่ทุกอย่างราบรื่น ให้ถามว่าจะเกิดอะไรขึ้นเมื่อไม่ราบรื่น
- ตรวจทุกตัวเลขและทุกคำที่คุณจะพิมพ์ออกมา รูปแบบใบแจ้งหนี้ งวดค่าเรียน บรรทัดภาษี และเลขที่ใบเสร็จควรตรงกับวิธีที่คุณทำงานอยู่ทุกวันนี้ ถ้าใบแจ้งหนี้ของคุณต้องแสดงภาษี เช่น GST, VAT หรือภาษีขาย ให้ตรวจรายละเอียดกับนักบัญชีของคุณ
- ถามทุกอย่างที่คลุมเครือ คำอย่าง จัดการ ติดตาม ง่าย และ รายงาน ซ่อนการตัดสินใจไว้ ให้ถามว่า: รายงานไหน แสดงอะไร สำหรับใคร
ควรมองหาช่องโหว่อะไรก่อนอนุมัติ
สเปกส่วนใหญ่ที่ผิดพลาดไม่ได้ผิด แต่ไม่ครบ ต่อไปนี้คือช่องโหว่ที่พบบ่อยที่สุด
ใครเห็นอะไรได้
บทบาทตั้งชื่อได้ง่ายและปล่อยให้คลุมเครือได้ง่าย ตรวจว่าแต่ละบทบาทเห็นอะไรได้ ไม่ใช่แค่ทำอะไรได้ ติวเตอร์เห็นค่าเรียนได้ไหม ผู้ปกครองคนหนึ่งเห็นคะแนนของลูกคนอื่นได้ไหม พนักงานดาวน์โหลดรายชื่อลูกค้าได้ไหม ถ้าแอปเก็บข้อมูลส่วนบุคคล ให้ตัดสินใจตอนนี้ว่าใครเห็นได้
การแก้ไข การยกเลิก และการย้อนกลับ
ทุกข้อมูลสักวันจะต้องแก้ไข ตรวจว่าสเปกระบุว่าใครแก้ไขหรือยกเลิกรายการได้ และค่าเดิมถูกเก็บไว้หรือไม่
เงิน
หากแอปรับชำระเงิน สเปกควรแสดงขั้นตอนการชำระเงิน ได้แก่ ลูกค้าจ่ายด้วยวิธีใดได้บ้าง (บัตรและวิธีชำระเงินในท้องถิ่น) จ่ายค่าอะไร อนุญาตให้จ่ายบางส่วนหรือไม่ ลูกค้าจะได้รับอะไรหลังชำระเงิน และจะเกิดอะไรขึ้นหากยังไม่ชำระหรือชำระไม่สำเร็จ กติกาการคืนเงินเป็นสิ่งที่ธุรกิจต้องตัดสินใจ คุณจึงควรเขียนกติกาของคุณไว้ให้ชัดเจน ผู้ให้บริการรับชำระเงินมักคิดค่าธรรมเนียมเป็นเปอร์เซ็นต์ต่อธุรกรรม และในหลายประเทศมีค่าธรรมเนียมคงที่เพิ่มด้วย จึงควรตรวจสอบหน้าราคาของผู้ให้บริการที่คุณใช้ แอปของ Deployflix รับชำระเงินผ่านผู้ให้บริการ เช่น Razorpay หรือ Cashfree และจะรองรับผู้ให้บริการระดับสากลเร็ว ๆ นี้ หน้าการเชื่อมต่อของเราแสดงบริการที่เชื่อมต่อได้ในปัจจุบัน
ข้อความและการเตือน
ถ้าคุณต้องการการเตือน ให้บอกว่าควรส่งถึงคนอย่างไร: ทางอีเมล ภายในแอป หรือวิธีอื่น ถ้าสเปกไม่ได้ระบุช่องทาง ให้ถือว่าไม่มี
ข้อมูลที่คุณมีอยู่แล้ว
สเปรดชีตและสมุดบันทึกเก่ามักต้องย้ายเข้าแอปใหม่ ถามว่าการนำเข้าข้อมูลเหล่านั้นเป็นส่วนหนึ่งของสเปก หรืออยู่ในรายการยังไม่รวม
อุปกรณ์และภาษา
ผู้คนจะใช้แอปนี้บนมือถือ คอมพิวเตอร์ที่เคาน์เตอร์ร้านค้า หรือทั้งสองแบบ แอปต้องรองรับภาษาสเปน อาหรับ ฝรั่งเศส หรือภาษาอื่นนอกเหนือจากภาษาอังกฤษด้วยหรือไม่ เรื่องเหล่านี้มีผลต่อหน้าจอ จึงควรตัดสินใจให้เรียบร้อยก่อนเริ่มสร้าง Deployflix เขียนข้อความในแอปของคุณเป็นภาษาที่คุณขอ และตัวระบบเองรองรับ 41 ภาษา
ทำไมต้องอนุมัติสเปกก่อนเริ่มสร้าง
เพราะการแก้ประโยคถูกกว่าการแก้แอป ก่อนสร้าง การเพิ่มบทบาทผู้ปกครองหรืองวดค่าเรียนเป็นแค่การแก้ไขหน้ากระดาษ หลังสร้าง การเปลี่ยนแปลงเดียวกันอาจกระทบหน้าจอ ข้อมูล และสิทธิ์ที่ทำเสร็จไปแล้ว
การอนุมัติยังทำให้คุณมีสิ่งที่ใช้ตรวจเทียบกับแอปที่สร้างเสร็จ เมื่อสร้างเสร็จ ให้เปิดสเปกแล้วติ๊กไล่ไปทีละข้อ: ทุกบทบาท ทุกหน้าจอ ทุกข้อมูล อะไรที่ขาดไปเป็นประเด็นที่ยกขึ้นมาได้อย่างเป็นธรรม
สเปกยังช่วยให้ค่าใช้จ่ายชัดเจนก่อนที่คุณจะตกลง เมื่อระบุค่าใช้จ่ายสูงสุดของบิลด์ไว้ในสเปก คุณก็ตัดสินใจได้โดยมีตัวเลขให้เห็นชัดเจน Deployflix จะแสดงเพดานค่าใช้จ่ายนี้ก่อนที่คุณจะอนุมัติ และคุณจ่ายเฉพาะส่วนที่บิลด์ใช้จริงเท่านั้น ตามที่อธิบายไว้ในหน้าราคา
การเปลี่ยนแปลงหลังสร้างแอปเสร็จวางแผนอย่างไร
แอปแทบไม่เคยเสร็จสมบูรณ์ หลักสูตรใหม่ สาขาที่สอง วิธีเก็บค่าเรียนแบบใหม่ แต่ละอย่างควรได้รับความใส่ใจเท่ากับการสร้างครั้งแรก
วางแผนการเปลี่ยนแปลงเป็นสเปกเล็กๆ ของตัวเอง: อะไรเปลี่ยน กระทบบทบาทและหน้าจอไหน ข้อมูลอะไรถูกเพิ่มหรือแก้ไข อะไรคงเดิม และมีค่าใช้จ่ายเท่าไร อ่านด้วยคำถามชุดเดียวกัน และอนุมัติก่อนเริ่มงาน เก็บเวอร์ชันก่อนหน้าไว้ เพื่อที่ว่าถ้าการเปลี่ยนแปลงผิดพลาด คุณจะย้อนกลับไปยังเวอร์ชันที่ใช้งานได้
นี่คือวิธีที่ Deployflix จัดการการเปลี่ยนแปลง: คุณบอกว่าจะเปลี่ยนอะไร ระบบวางแผนการเปลี่ยนแปลงเป็นเวอร์ชันถัดไป และไม่มีอะไรถูกสร้างจนกว่าจะได้รับอนุมัติ ทุกเวอร์ชันก่อนหน้าถูกเก็บไว้ ในองค์กร มีเพียงคนที่บทบาทอนุญาตเท่านั้นที่อนุมัติได้ ตามที่หน้าความปลอดภัยอธิบายไว้
เทมเพลตสเปกแอปที่คุณนำไปใช้ได้
ถ้าคุณเขียนสเปกเอง ให้คัดลอกหัวข้อเหล่านี้แล้วเติมแต่ละหัวข้อด้วยประโยคง่าย ๆ:
- แอปในหนึ่งประโยค: สำหรับใคร และทำงานอะไร
- บทบาท: ผู้ใช้แต่ละประเภท และสิ่งที่เขาเห็นและทำได้
- หน้าจอตามบทบาท: สำหรับแต่ละบทบาท มีหน้าจออะไรบ้าง และเกิดอะไรขึ้นในแต่ละหน้า
- ข้อมูลที่เก็บ: ข้อมูลแต่ละประเภทและรายละเอียดที่มี
- การเชื่อมต่อ: การชำระเงิน โดเมนของคุณ แอปสโตร์ ที่เก็บโค้ด และสิ่งอื่นที่แอปเชื่อมต่อ
- กฎ: ค่าธรรมเนียม ขีดจำกัด กำหนดเวลา การยกเลิก และการคืนเงิน
- ยังไม่รวมในตอนนี้: สิ่งที่เวอร์ชันนี้จะไม่ทำ
- เพดานค่าใช้จ่ายและการอนุมัติ: ค่าใช้จ่ายสูงสุด และใครเป็นผู้อนุมัติ
ดูตัวอย่างบทบาท หน้าจอ และข้อมูลได้จากระบบจัดการกลุ่มเรียนของสถาบันกวดวิชาEN หรือแอปจองนัดคลินิกEN ผู้ก่อตั้งที่กำลังทดสอบไอเดียทำสเปกให้สั้นกว่านั้นได้อีก มีบทบาทเดียว หน้าจอไม่กี่หน้า และรายการสิ่งที่ไม่รวมที่ชัดเจน เช่นเดียวกับเว็บแอป MVP สำหรับสตาร์ทอัปEN
คำถาม
สเปกแอปกับเอกสารข้อกำหนดต่างกันอย่างไร
ส่วนใหญ่ต่างกันที่ความยาวและความเป็นทางการ เอกสารข้อกำหนดของโครงการใหญ่อาจยาวหลายหน้าพร้อมข้อกำหนดที่มีเลขกำกับ ส่วนสเปกแอปของธุรกิจขนาดเล็กครอบคลุมเรื่องเดียวกัน (ใครใช้ ทำอะไร เก็บอะไร) ในหน้าเดียว ด้วยภาษาง่ายๆ
ใครควรเป็นคนเขียนสเปกแอป
คนที่รู้จักธุรกิจเป็นผู้ให้เนื้อหา: บทบาท งานประจำวัน และกฎ ผู้สร้างแปลงสิ่งนั้นเป็นสเปกที่มีโครงสร้างได้ แต่มีเพียงคุณที่บอกได้ว่าถูกต้องหรือไม่
แก้ไขสเปกหลังอนุมัติแล้วได้ไหม
ได้ ให้ถือเป็นการเปลี่ยนแปลง: อธิบายว่าอะไรต่างไป อ่านแผนที่อัปเดตแล้ว และอนุมัติอีกครั้ง เก็บเวอร์ชันก่อนหน้าไว้เพื่อเปรียบเทียบหรือย้อนกลับ
สเปกแอปควรยาวแค่ไหน
ยาวพอที่จะไม่มีเรื่องสำคัญถูกปล่อยให้เดา และสั้นพอที่คุณจะอ่านจนจบ สำหรับแอปของธุรกิจขนาดเล็กส่วนใหญ่ หนึ่งหน้ากำลังดี ถ้ายาวกว่านั้นมาก ให้พิจารณาสร้างเป็นระยะ
อธิบายแอปของคุณ
เขียนสิ่งที่คุณต้องการด้วยคำพูดของคุณเอง Deployflix จะเขียนแผนหนึ่งหน้าพร้อมค่าใช้จ่าย และจะสร้างหลังจากที่คุณอนุมัติแล้วเท่านั้น
คัดลอกแล้ว วางลงใน Deployflix ได้เลยหลังลงชื่อเข้าใช้