ความแตกต่างระหว่างข้อกำหนดทางเทคนิคและเอกสารการออกแบบคืออะไร?


38

ข้อกำหนดทางเทคนิคคืออะไร? พวกเขาเหมือนกับเอกสารการออกแบบหรือไม่ ถ้าไม่แตกต่างกันและมีตัวอย่างอะไรบ้าง?


1
อดีตพลาดการออกแบบและหลังพลาดทางเทคนิค

คำตอบ:


33

เอกสารการออกแบบซอฟแวร์สามารถในระดับของระบบหรือส่วนประกอบและโดยทั่วไปรวมถึง:

  • เป้าหมายหรือข้อกำหนดที่เกี่ยวข้อง (หน้าที่และไม่ใช่หน้าที่);
  • โครงสร้างแบบสแตติก (เช่นส่วนประกอบอินเตอร์เฟสการพึ่งพา)
  • พฤติกรรมแบบไดนามิก (องค์ประกอบมีปฏิสัมพันธ์อย่างไร);
  • โมเดลข้อมูลหรืออินเตอร์เฟสภายนอก (ภายนอกกับระบบ / ส่วนประกอบที่อธิบายไว้ในเอกสาร); และ
  • ข้อควรพิจารณาในการปรับใช้ (เช่นข้อกำหนดรันไทม์คอมโพเนนต์ของบุคคลที่สาม)

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

ข้อกำหนดทางเทคนิคอธิบายถึงรายละเอียดนาทีของทั้งหมดหรือเฉพาะบางส่วนของการออกแบบเช่น:

  • ลายเซ็นของอินเทอร์เฟซรวมถึงชนิดข้อมูล / โครงสร้างทั้งหมดที่ต้องการ (ชนิดข้อมูลอินพุต, ชนิดข้อมูลเอาต์พุต, ข้อยกเว้น);
  • แบบจำลองชั้นเรียนโดยละเอียดรวมถึงวิธีการคุณลักษณะการพึ่งพาและการเชื่อมโยงทั้งหมด
  • อัลกอริทึมเฉพาะที่ส่วนประกอบใช้งานและวิธีการทำงาน และ
  • แบบจำลองข้อมูลทางกายภาพรวมถึงคุณลักษณะและประเภทของแต่ละเอนทิตี / ชนิดข้อมูล

1
ดังนั้นเมื่อไหร่ที่เราควรจะเขียนข้อกำหนดทางเทคนิค ก่อนการพัฒนา? พร้อมกับการพัฒนา? หรือหลังจาก ..
shashwat

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

ฉันได้เจอกับสถานการณ์ที่แน่นอนนี้ที่ทำงานให้กับองค์กรขนาดใหญ่ในโครงการหลายปี เราทำงานย้อนหลังในการสร้างเอกสารข้อกำหนดทางธุรกิจหลังจากที่ย้ายโครงการไปยังการทดสอบแล้วไปที่ Prod! ใช่การจัดการโครงการที่ยอดเยี่ยมฉันรู้!
ThinkCode

ข้อกำหนดทางเทคนิคไม่ได้ถูกสร้างขึ้นหลังจากรายละเอียดข้อกำหนดข้อกำหนดซอฟต์แวร์ที่ใช้งานได้หรือไม่ สถาปนิกจะสร้าง TS ที่ไม่มี SRS ได้อย่างไร ดูเหมือนว่าเขา / เธอจะต้องสมมติเป็นตัน
Oracular Man

เห็นด้วย TS ควรทำตาม SRS (ข้อกำหนดของระบบข้อกำหนด) หมายเหตุอย่างไรก็ตามคำศัพท์ hese นั้นไม่ได้มาตรฐานและ TS สามารถสร้างเป็นรูปแบบรายละเอียดของ SRS (โดยทั่วไปในระบบฝังตัว) หรือสามารถใช้เพื่อเสริม SRS ระดับสูงเช่นเอกสารการออกแบบ (โดยทั่วไปในแอปพลิเคชันเชิงพาณิชย์ ) จุดสำคัญคือเอกสารข้อกำหนดการออกแบบและข้อมูลจำเพาะแต่ละอันอธิบายมุมมองเฉพาะหนึ่งมุมมองบนระบบและส่วนประกอบ เป็นเรื่องสำคัญที่ทีมจะต้องยอมรับมุมมองและระดับของรายละเอียดที่จำเป็นมากกว่าการพบกับคำจำกัดความที่เป็นทางการ
miraculixx

7

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

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


ขอขอบคุณ. โดยพื้นฐานแล้วฉันต้องการสเปคการใช้งานเพื่อที่จะรู้ว่าต้องทำอะไรและจากนั้นออกแบบเอกสารเพื่อให้รู้ว่าต้องทำอย่างไรถูกต้องหรือไม่? เพียงคำถามเล็ก ๆ น้อย ๆ การออกแบบฟังก์ชั่นที่คุณอ้างถึงคืออะไร (หวังว่ามันจะไม่เพิ่มความสับสนให้กับความเข้าใจของฉันเกี่ยวกับข้อมูลจำเพาะของฟังก์ชั่น)
John V

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

1
ดังนั้นเมื่อไหร่ที่เราควรจะเขียนข้อกำหนดทางเทคนิค ก่อนการพัฒนา? พร้อมกับการพัฒนา? หรือหลังจาก ..
shashwat
โดยการใช้ไซต์ของเรา หมายความว่าคุณได้อ่านและทำความเข้าใจนโยบายคุกกี้และนโยบายความเป็นส่วนตัวของเราแล้ว
Licensed under cc by-sa 3.0 with attribution required.