สถาปัตยกรรมอ้างอิงการรายงานการผลิตและการตรวจสอบย้อนกลับ

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

สถานการณ์และข้อจำกัด

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

สถาปัตยกรรม

เลเยอร์และความรับผิดชอบ

เลเยอร์	เทคโนโลยี	ความรับผิดชอบ
เว็บสำนักงาน	Vue 3 + Element Plus	การปล่อยคำสั่งผลิต การดูแล BOM การจัดตาราง การทบทวนคุณภาพ และการรายงาน
ไคลเอนต์หน้างานผลิต	อุปกรณ์พกพา / แท็บเล็ต Android (Kotlin) รองรับการทำงานออฟไลน์	การรายงานที่ขับเคลื่อนด้วยการสแกนในแต่ละสถานี ออกแบบสำหรับมือที่สวมถุงมือและ Wi-Fi ที่ไม่เสถียร: เป้าหมายขนาดใหญ่ การแตะไม่กี่ครั้ง และคิวภายในเครื่อง
API	Go + Gin	การตรวจสอบการรายงานกับเส้นทางการผลิต กฎการใช้วัสดุ และการสืบค้นการตรวจสอบย้อนกลับ
พื้นที่จัดเก็บข้อมูล	MySQL	คำสั่งผลิต เส้นทางการผลิต ระเบียนการรายงาน และลำดับสายสัมพันธ์ของล็อต
เกตเวย์อุปกรณ์	บริดจ์ MQTT หรือ OPC UA (ไม่บังคับ)	ดึงจำนวนหรือค่าการวัดจากอุปกรณ์เมื่อผู้จำหน่ายเปิดให้ใช้อินเทอร์เฟซ และปรับให้อยู่ในรูปแบบเดียวกับตารางการรายงาน
การรายงาน	งานรวมข้อมูลตามกำหนดเวลา	คำนวณผลได้ เวลาไซเคิล และภาระงานของสถานีไว้ล่วงหน้า เนื่องจากการสืบค้นเหล่านี้ต้องสแกนประวัติจำนวนมากเกินกว่าจะทำงานแบบเรียลไทม์ทุกครั้งที่โหลดแดชบอร์ด

โมเดลข้อมูล

ตารางด้านล่างรองรับกฎที่ทุกส่วนอื่นต้องพึ่งพา หากกำหนดสิ่งเหล่านี้ผิด เดโมที่ทำงานได้จะกลายเป็นระบบที่ขยายต่อไม่ได้

เอนทิตีหลัก

เอนทิตี	ฟิลด์หลัก ความสัมพันธ์ และกฎ
item / bom	รายการวัสดุหลายระดับพร้อมวันที่มีผลบังคับใช้และกฎการทดแทน เก็บเวอร์ชันของ BOM ไว้โดยไม่เขียนทับ เพื่อให้คำสั่งผลิตที่สร้างเมื่อเดือนที่แล้วยังคงอ้างอิง BOM ที่ใช้จริง
work_order / routing_step	คำสั่งผลิตและรายการปฏิบัติงานตามลำดับ โดยแต่ละรายการผูกกับศูนย์งาน พร้อมเวลามาตรฐานและกฎการรายงานสำหรับขั้นตอนนั้น
production_report	ผลผลิตรายสถานี: ผู้ปฏิบัติงาน เวลาเริ่มต้นและสิ้นสุด จำนวนดี งานแก้ไข และของเสียพร้อมรหัสเหตุผล นี่คือข้อมูลนำเข้าที่ทุกตัวชี้วัดนำไปใช้ ดังนั้นกฎการตรวจสอบจึงสำคัญกว่าแดชบอร์ด
material_lot / lot_consumption	ล็อตที่รับเข้าและการเบิกใช้กับคำสั่งผลิต lot_consumption คือจุดเชื่อมที่ทำให้สร้างลำดับสายสัมพันธ์ได้ หากไม่มีสิ่งนี้ การตรวจสอบย้อนกลับจะเสื่อมเหลือเพียงการคาดเดา
serial / genealogy	หน่วยสินค้าสำเร็จรูปที่มีซีเรียล ซึ่งเชื่อมโยงกับล็อตที่ใช้ไปและก่อเป็นกราฟที่ตอบโจทย์การตรวจสอบย้อนกลับทั้งสองทิศทาง
inspection / defect	จุดตรวจสอบ กฎการสุ่มตัวอย่าง รหัสข้อบกพร่อง และการจัดการผลลัพธ์ (ยอมรับ แก้ไข ของเสีย) โดยแต่ละรายการเชื่อมกลับไปยังรายงานที่สร้างหน่วยนั้น

อินเทอร์เฟซหลัก

เอนด์พอยต์ที่รองรับกฎทางธุรกิจ

เอนด์พอยต์	วัตถุประสงค์และหมายเหตุด้านการทำงานพร้อมกัน
POST /api/v1/reports	การรายงานของสถานี ตรวจสอบว่าขั้นตอนก่อนหน้าของเส้นทางการผลิตเสร็จสมบูรณ์ จำนวนที่รายงานไม่เกินจำนวนที่ปล่อย และการใช้วัสดุอยู่ภายในค่าคลาดเคลื่อนของ BOM การปฏิเสธข้อมูลที่ไม่ถูกต้อง ณ จุดนี้คือสิ่งที่ทำให้ข้อมูลการรายงานน่าเชื่อถือ
POST /api/v1/reports/batch	การอัปโหลดคิวออฟไลน์จากอุปกรณ์พกพา กำจัดข้อมูลซ้ำด้วย UUID ของไคลเอนต์ โดยรักษาเวลาที่บันทึกข้อมูล
GET /api/v1/trace/forward/{lot}	เมื่อระบุล็อตวัสดุ จะแสดงซีเรียลของสินค้าสำเร็จรูปที่ได้รับผลกระทบทั้งหมด ซึ่งเป็นคำสืบค้นที่การเรียกคืนสินค้าต้องพึ่งพา
GET /api/v1/trace/backward/{serial}	เมื่อระบุซีเรียลของสินค้าสำเร็จรูป จะแสดงลำดับสายสัมพันธ์ของล็อตวัสดุทั้งหมด
POST /api/v1/work-orders/{id}/release	ปล่อยคำสั่งผลิตโดยบันทึกภาพรวมของ BOM และเวอร์ชันเส้นทางการผลิต เพื่อให้การแก้ไขข้อมูลหลักในภายหลังไม่สามารถเขียนทับประวัติได้

การตัดสินใจทางเทคนิค

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

เป้าหมายการออกแบบเชิงสมมติฐาน

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

เป้าหมายด้านความจุและประสิทธิภาพ

เป้าหมาย	ค่าและสมมติฐาน
สแกนจนยืนยัน	เป้าหมายเชิงสมมติฐาน: การตอบกลับภายในเครื่องภายใน 1 วินาทีสำหรับรายงานและอุปกรณ์ที่กำหนด บันทึกระเบียนที่เข้าคิวไว้ และแยกการยืนยันภายในเครื่องออกจากการยอมรับของเซิร์ฟเวอร์ ทดสอบความล่าช้าและความล้มเหลวของเครือข่าย
คำสืบค้นการตรวจสอบย้อนกลับ	ทั้งสองทิศทางตอบกลับภายในไม่กี่วินาทีสำหรับความลึกของลำดับสายสัมพันธ์โดยทั่วไป โดยใช้การเชื่อมล็อตและซีเรียลที่มีดัชนี ชุดประกอบหลายระดับเชิงลึกต้องได้รับการตรวจสอบกับข้อมูลจริงของคุณระหว่างการยอมรับงาน
แดชบอร์ดการรายงาน	ให้บริการจากข้อมูลรวมที่คำนวณไว้ล่วงหน้าและรีเฟรชตามกำหนดเวลาที่ตกลงกับฝ่ายปฏิบัติการ แทนการสแกนรายงานดิบทุกครั้งที่โหลดหน้า
ความทนทานต่อออฟไลน์	รายงานเต็มกะถูกเข้าคิวไว้ภายในเครื่องและอัปโหลดเมื่อเชื่อมต่ออีกครั้ง โดยกำจัดข้อมูลซ้ำด้วย UUID ของไคลเอนต์

สิ่งที่รวมอยู่ในการส่งมอบ

ซอร์สเว็บสำนักงาน ซอร์สแบ็กเอนด์ Go และซอร์สไคลเอนต์หน้างานผลิต Android ในรีโพซิทอรีของคุณ
สคีมาฐานข้อมูลพร้อมเอกสารเกี่ยวกับการกำหนดเวอร์ชัน BOM และตารางลำดับสายสัมพันธ์ รวมถึงประวัติการย้ายข้อมูล
เอกสาร API รวมถึงสัญญาการอัปโหลดแบบออฟไลน์และกฎการตรวจสอบการรายงาน
ข้อกำหนดอินเทอร์เฟซ ERP และรูปแบบการแลกเปลี่ยนที่ตกลงกัน
หมายเหตุการติดตั้ง ขั้นตอนการสำรองและกู้คืน และหมายเหตุการกำหนดค่าฮาร์ดแวร์ฉลากหรือเครื่องสแกน

การวางแผนสำหรับธุรกิจของคุณ

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