การออกแบบ API และสถาปัตยกรรมซอฟต์แวร์
สถาปัตยกรรมเป็นตัวกำหนดว่าซอฟต์แวร์จะแก้ไขได้ง่ายไปอีกนานแค่ไหน เราออกแบบระบบตามโดเมนของธุรกิจ กำหนดสัญญาที่ชัดเจนให้ทุกบริการ และเลือกโครงสร้างที่เรียบง่ายที่สุดที่รองรับภาระงานได้ ตั้งแต่แอปพลิเคชันเดียวที่เป็นระเบียบไปจนถึงชุดของบริการ
เครื่องมือ
REST และ CRUD API สัญญา OpenAPI, WebSocket ไมโครเซอร์วิส ระบบส่งข้อความ และ Domain-Driven Design
REST
HTTP API แบบอิงทรัพยากร ที่มีการตั้งชื่อ รหัสสถานะ การแบ่งหน้า และการกำหนดเวอร์ชันอย่างสม่ำเสมอ REST คือตัวเลือกหลักของเราสำหรับเว็บ มือถือ และการเชื่อมต่อกับพันธมิตร
CRUD
การสร้าง อ่าน แก้ไข และลบข้อมูลที่ทำอย่างถูกต้อง: การตรวจสอบข้อมูล สิทธิ์การใช้งาน ประวัติการแก้ไข และการจัดการอย่างปลอดภัยเมื่อสองคนแก้ไขรายการเดียวกัน ซอฟต์แวร์ธุรกิจส่วนใหญ่มีแกนหลักเป็น CRUD
OpenAPI
API ถูกอธิบายด้วยข้อกำหนด OpenAPI (Swagger) ก่อน ทีมฟรอนต์เอนด์ มือถือ และพันธมิตรได้เอกสารแบบโต้ตอบและไคลเอนต์ที่สร้างอัตโนมัติ และพัฒนาคู่ขนานกันได้
WebSocket
ช่องทางเรียลไทม์แบบสองทางสำหรับแดชบอร์ด การแจ้งเตือน และเกมผู้เล่นหลายคน ควบคู่กับ REST API
ไมโครเซอร์วิส
บริการที่เป็นอิสระต่อกัน แต่ละตัวมีข้อมูลและการนำขึ้นระบบของตัวเอง บรรจุในคอนเทนเนอร์ เราแยกระบบเมื่อทีมหรือภาระงานต้องการ และคงไว้เป็นแอปพลิเคชันเดียวที่มีโครงสร้างดีเมื่อไม่จำเป็น
การส่งข้อความแบบ Event-driven
บริการที่สื่อสารกันผ่านคิวข้อความ เช่น JMS แทนการรอกันและกัน ขั้นตอนที่ช้าหรือล้มเหลวจึงไม่ทำให้ส่วนที่เหลือหยุด
Domain-Driven Design
โค้ดใช้ภาษาเดียวกับธุรกิจ Bounded context เก็บกฎของแต่ละส่วนงานไว้ที่เดียว ทำให้ระบบขนาดใหญ่ยังเข้าใจได้
Clean architecture
กฎทางธุรกิจแยกจากเฟรมเวิร์ก ฐานข้อมูล และส่วนติดต่อผู้ใช้ แต่ละส่วนจึงทดสอบแยกกันได้และเปลี่ยนได้โดยไม่ต้องเขียนใหม่ทั้งหมด
Reverse proxy
ประตูหน้าบานเดียวสำหรับทุกแอปพลิเคชัน: nginx หรือ Apache จัดการ TLS ส่งแต่ละเส้นทางไปยังบริการที่ถูกต้อง แคชไฟล์สแตติก และบล็อกทราฟฟิกที่ไม่ต้องการ ทุกเว็บไซต์และผลิตภัณฑ์ที่เราดูแลอยู่หลัง reverse proxy
Load balancing
กระจายทราฟฟิกไปยังแอปพลิเคชันเซิร์ฟเวอร์หลายเครื่องพร้อมการตรวจสุขภาพ ภาระงานจึงถูกแบ่งกัน และนำเซิร์ฟเวอร์ออกเพื่ออัปเดตได้โดยไม่มีใครสังเกต
คลัสเตอร์พร้อม failover
คลัสเตอร์ที่โหนดซึ่งยังทำงานปกติรับช่วงต่อเมื่ออีกโหนดล้มเหลว โดยเซสชันยังคงอยู่ เราเคยสร้างแอปพลิเคชันเซิร์ฟเวอร์แบบคลัสเตอร์สำหรับระบบที่ต้องออนไลน์ตลอดเวลา เช่น ระบบด้านสุขภาพ
วิธีที่เราใช้งาน
สัญญามาก่อน
สัญญาของ API ถูกตกลงและรีวิวก่อนเขียนโค้ด และการเปลี่ยนแปลงมีการกำหนดเวอร์ชัน
ปลอดภัยตั้งแต่ต้น
OAuth2 และ JWT ในทุก endpoint การตรวจสอบข้อมูลขาเข้า และการจำกัดอัตราการเรียกใช้
การปรับปรุงระบบเดิมให้ทันสมัย
ระบบเก่าถูกแทนที่ทีละส่วนหลัง API ที่เสถียร ผู้ใช้จึงทำงานต่อได้ระหว่างการย้ายระบบ
บันทึกการตัดสินใจ
บันทึกการตัดสินใจด้านสถาปัตยกรรมฉบับสั้นอธิบายเหตุผลของแต่ละทางเลือก สำหรับนักพัฒนาที่มารับช่วงต่อ
ประสบการณ์เบื้องหลัง
เทคโนโลยีนี้ถูกใช้ในโครงการจริงที่ใดบ้าง
สำรวจส่วนอื่นของสแต็ก
กำลังวางแผนโปรเจกต์บนสแต็กนี้อยู่ใช่ไหม?
บอกเราว่าคุณกำลังสร้างอะไร แล้วเราจะบอกว่าเราจะเริ่มต้นอย่างไร
