ข้ามไปยังเนื้อหา
คู่มือทั้งหมด

ก่อนเริ่มโครงการ

เขียนบรีฟซอฟต์แวร์ให้เริ่มงานได้จริง

บรีฟที่ดีช่วยให้ทุกฝ่ายเห็นงานเดียวกัน ระบุผู้ใช้ ขอบเขต ข้อมูลที่ต้องใช้ และหลักฐานที่จะใช้ตรวจรับ โดยไม่ต้องออกแบบระบบทั้งหมดล่วงหน้า

ไปที่รายการตรวจ

เริ่มจากงานที่ต้องทำให้สำเร็จ

แทนที่จะเริ่มด้วยรายชื่อเทคโนโลยี ให้เล่าว่าตอนนี้ใครทำงานอะไร ใช้เครื่องมือใด และติดขัดตรงไหน จากนั้นระบุว่าหลังมีระบบแล้ว คนเดิมควรทำอะไรได้ต่างจากเดิม ข้อมูลนี้ช่วยแยกปัญหาที่ซอฟต์แวร์ช่วยได้ออกจากปัญหาที่ต้องปรับกระบวนการทำงานด้วย

เลือกงานหลักสำหรับรุ่นแรกเพียงไม่กี่เส้นทาง ระบุผลลัพธ์ที่สังเกตได้ เช่น ตรวจสถานะคำขอได้โดยไม่ต้องถามเจ้าหน้าที่ หรือส่งรายการให้ผู้อนุมัติพร้อมเอกสารครบ คำว่าใช้งานง่ายหรือเร็วขึ้นยังต้องแปลงเป็นกรณีทดสอบที่ตกลงร่วมกัน

ระบุผู้ใช้ สิทธิ์ และกรณีที่งานไม่เป็นไปตามปกติ

ชื่อบทบาทควรสัมพันธ์กับงาน เช่น ผู้ส่งคำขอ ผู้ตรวจ และผู้ดูแลระบบ อย่าใช้เพียงคำว่ามีระบบสมาชิก เพราะยังไม่บอกว่าแต่ละคนเห็นหรือแก้ไขข้อมูลใดได้ ระบุด้วยว่าคนหนึ่งมีหลายบทบาทได้หรือไม่ และใครเป็นผู้เพิ่มหรือถอนสิทธิ์

ลองเดินตามงานหนึ่งรายการตั้งแต่เริ่มจนจบ แล้วถามว่าเกิดอะไรขึ้นเมื่อข้อมูลไม่ครบ งานถูกปฏิเสธ หรือปลายทางไม่ตอบกลับ กรณีเหล่านี้มีผลต่อหน้าจอ โครงสร้างข้อมูล และเวลาพัฒนาเท่ากับเส้นทางปกติ

  • ข้อมูลที่มองเห็น

    ผู้ใช้เห็นเฉพาะรายการของตนเอง ของแผนก หรือทั้งหมด และข้อมูลใดต้องปิดบังตามบทบาท

  • การแก้ไขและอนุมัติ

    ใครเปลี่ยนสถานะได้ ต้องเก็บเหตุผลหรือประวัติ และแก้ไขหลังอนุมัติได้ถึงขั้นใด

  • สถานะผิดพลาด

    ระบุพฤติกรรมเมื่อส่งซ้ำ อัปโหลดไม่สำเร็จ สิทธิ์ถูกถอน หรือการเชื่อมต่อขาดระหว่างทำงาน

แยกสิ่งที่รวมในรุ่นแรกออกจากสิ่งที่ตามมา

รายการฟังก์ชันควรมีขอบเขต ไม่ใช่มีเพียงชื่อหัวข้อ ตัวอย่างเช่นรายงานอาจหมายถึงตารางบนหน้าจอ ไฟล์ส่งออก หรือการส่งอีเมลตามเวลา ซึ่งเป็นงานคนละส่วน ระบุจำนวนรูปแบบข้อมูล ผู้ใช้ ภาษา และจุดเชื่อมระบบที่ต้องรองรับ

เก็บรายการนอกขอบเขตไว้ในเอกสารเดียวกัน เมื่อมีคำขอใหม่ จะได้ดูได้ว่าต้องแทนที่งานเดิม เพิ่มงบประมาณ หรือเลื่อนเป็นรุ่นถัดไป การยอมรับว่าบางเรื่องยังไม่ทราบช่วยให้วางช่วงสำรวจได้ตรงจุด

ตัวอย่างการแบ่งขอบเขตของระบบรับคำขอ
เรื่องรุ่นแรกแยกพิจารณาภายหลัง
การส่งคำขอแบบฟอร์มหนึ่งประเภทและไฟล์แนบตามเงื่อนไขตัวสร้างแบบฟอร์มหลายประเภท
การอนุมัติหนึ่งลำดับงานที่ระบุผู้ตรวจชัดเจนเงื่อนไขหลายระดับที่ผู้ดูแลกำหนดเอง
รายงานตารางสถานะและไฟล์ส่งออกที่ตกลงรูปแบบแดชบอร์ดวิเคราะห์เฉพาะฝ่าย
การแจ้งเตือนช่องทางเดียวที่ตกลงไว้การเชื่อมหลายช่องทางและการส่งตามเวลา

เตรียมข้อมูลและเจ้าของงานที่เกี่ยวข้อง

รวบรวมตัวอย่างเอกสาร หน้าจอเดิม และข้อมูลตัวอย่างที่ลบข้อมูลส่วนบุคคลแล้ว หากต้องเชื่อมระบบอื่น ให้เตรียมเอกสาร API ข้อจำกัดการใช้งาน และผู้ติดต่อที่ช่วยเปิดสิทธิ์ทดสอบได้ ยังไม่จำเป็นต้องส่งรหัสผ่านหรือข้อมูลลับในบรีฟ

งานเนื้อหาและงานอนุมัติมักเป็นเงื่อนไขก่อนเริ่มพัฒนาบางส่วน ระบุว่าใครส่งข้อความ รูปภาพ ข้อมูลสินค้า คำแปล และใครมีอำนาจอนุมัติผลลัพธ์ รวมถึงช่วงเวลาที่ทีมสามารถตรวจงานทดสอบได้

  • ระบบและข้อมูลเดิม

    มีซอร์สโค้ด เอกสารฐานข้อมูล หรือไฟล์ส่งออกหรือไม่ ใครอนุมัติให้ใช้ข้อมูลทดสอบและย้ายข้อมูลได้

  • บัญชีและบริการภายนอก

    ใครดูแลโดเมน โฮสต์ ช่องทางชำระเงิน และบัญชีที่ต้องผ่านการยืนยันตัวตน

  • ข้อจำกัด

    กำหนดวันเริ่มใช้งาน อุปกรณ์ที่ต้องรองรับ งบประมาณโดยประมาณ และข้อกำหนดของฝ่ายไอทีที่ทราบแล้ว

เขียนกรณีตรวจรับให้เห็นภาพเดียวกัน

กรณีตรวจรับควรอธิบายสถานะเริ่มต้น การกระทำ และผลที่คาดหวัง ระบุข้อมูลทดสอบและผู้ตรวจด้วย เพื่อให้คำว่าทำงานได้มีหลักฐานที่ทุกฝ่ายตรวจซ้ำได้ ไม่ผูกการอนุมัติงานไว้กับความรู้สึกจากการดูหน้าจออย่างเดียว

กำหนดเรื่องการเข้าถึงและประสิทธิภาพตั้งแต่ต้น เช่น เส้นทางที่ต้องใช้คีย์บอร์ดได้ เบราว์เซอร์ที่ตรวจ และสภาพการทดสอบความเร็ว ตัวเลขเป้าหมายควรมีวิธีวัดกำกับ พร้อมแยกข้อจำกัดจากบริการภายนอก

ปิดบรีฟด้วยคำถามที่ยังต้องตัดสินใจ

ไม่ต้องเดาคำตอบให้ครบทุกช่อง แยกสิ่งที่ยืนยันแล้ว สมมติฐานที่ใช้ประมาณการ และคำถามที่ต้องทดลองหรือคุยกับผู้ใช้ กำหนดว่าใครจะหาคำตอบและเมื่อใด เพื่อไม่ให้สมมติฐานกลายเป็นข้อตกลงโดยไม่ตั้งใจ

ก่อนเริ่มงาน ให้ทบทวนขอบเขต สิ่งส่งมอบ เกณฑ์ตรวจรับ วิธีอนุมัติการเปลี่ยนแปลง และผู้ดูแลหลังส่งมอบร่วมกัน รายละเอียดการชำระเงินและสิทธิ์ในงานให้ยึดข้อตกลงของโครงการ บรีฟนี้เป็นฐานสำหรับคุยงาน ไม่ใช่ข้อเสนอราคาหรือสัญญา

รายการตรวจก่อนคุยกับทีม

  • อธิบายงานหลักและปัญหาของระบบเดิมได้
  • มีรายชื่อบทบาทและขอบเขตสิทธิ์
  • แยกงานรุ่นแรก งานนอกขอบเขต และเรื่องที่ยังไม่ทราบ
  • มีข้อมูลตัวอย่างและผู้ดูแลจุดเชื่อมต่อ
  • ระบุผู้อนุมัติ วันสำคัญ และข้อจำกัด
  • เขียนกรณีตรวจรับหลักพร้อมกรณีผิดพลาด
  • ทราบว่าใครจะรับช่วงดูแลระบบ

เริ่มจากเอกสารที่ทีมอ่านแล้วถามต่อได้ บรีฟไม่จำเป็นต้องยาว แต่ต้องทำให้เห็นว่างานใดจะเสร็จ ใครใช้ และใครเป็นคนตรวจรับ

นำโจทย์มาคุยกับเรา