Part DB server

เอกสารประกอบ | สาธิต | รูปภาพนักเทียบท่า

ส่วน-DB

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

เวอร์ชันในพื้นที่เก็บข้อมูลนี้เป็นการเขียนใหม่ของ Part-DB เดิม (เวอร์ชัน < 1.0) โดยอิงตามเฟรมเวิร์กสมัยใหม่ และเป็นเวอร์ชันที่แนะนำให้ใช้

หากคุณพบข้อบกพร่อง โปรดเปิดปัญหาบน GitHub เพื่อให้ทุกคนสามารถแก้ไขได้

สาธิต

หากคุณต้องการทดสอบ Part-DB โดยไม่ต้องติดตั้ง คุณสามารถใช้อินสแตนซ์ Heroku นี้ (หรือลิงค์นี้สำหรับเวอร์ชั่นภาษาเยอรมัน)

คุณสามารถเข้าสู่ระบบด้วยชื่อผู้ใช้: ผู้ใช้ และรหัสผ่าน: ผู้ใช้

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

คุณสมบัติ

• การจัดการสินค้าคงคลังของชิ้นส่วนอิเล็กทรอนิกส์ของคุณ แต่ละชิ้นส่วนสามารถกำหนดให้กับหมวดหมู่ รอยเท้า ผู้ผลิต และที่ตั้งร้านค้าหลายแห่งและข้อมูลราคาได้ สามารถจัดกลุ่มชิ้นส่วนได้โดยใช้แท็ก คุณสามารถเชื่อมโยงไฟล์ต่างๆ เช่น เอกสารข้อมูลหรือรูปภาพกับส่วนต่างๆ ได้
• รองรับหลายภาษา (ปัจจุบันคือ เยอรมัน อังกฤษ รัสเซีย ญี่ปุ่น ฝรั่งเศส เช็ก เดนมาร์ก และจีน)
• เครื่องสร้างบาร์โค้ด/ฉลากสำหรับชิ้นส่วนและสถานที่จัดเก็บ สแกนบาร์โค้ดผ่านเว็บแคมโดยใช้เครื่องสแกนบาร์โค้ดในตัว
• ระบบผู้ใช้พร้อมกลุ่มและการอนุญาตแบบละเอียด (แบบละเอียด) รองรับการตรวจสอบสิทธิ์แบบสองปัจจัย (คีย์ Google Authenticator และ Webauthn/U2F) และสามารถบังคับใช้กับกลุ่มได้ สามารถตั้งค่ารีเซ็ตรหัสผ่านทางอีเมลได้
• การสนับสนุนเพิ่มเติมสำหรับการลงชื่อเพียงครั้งเดียว (SSO) ผ่าน SAML (เมื่อใช้บริการระดับกลางเช่น Keycloak คุณสามารถเชื่อมต่อ Part-DB กับเซิร์ฟเวอร์ LDAP หรือ Active Directory ที่มีอยู่ได้)
• ระบบนำเข้า/ส่งออกชิ้นส่วนและโครงสร้างข้อมูล รองรับการนำเข้า BOM สำหรับโครงการจาก KiCAD
• การจัดการโครงการ: สร้างโครงการและกำหนดส่วนต่างๆ ให้กับรายการวัสดุ (BOM) เพื่อแสดงความถี่ที่คุณสามารถสร้างโครงการนี้ และถอนส่วนประกอบทั้งหมดที่จำเป็นออกจาก DB ได้โดยตรง
• บันทึกเหตุการณ์: ติดตามการเปลี่ยนแปลงที่เกิดขึ้นกับสินค้าคงคลังของคุณ ติดตามว่าผู้ใช้รายใดทำอะไร เปลี่ยนชิ้นส่วนของคุณกลับเป็นเวอร์ชันเก่า
• การออกแบบที่ตอบสนอง: คุณสามารถใช้ Part-DB บนพีซี แท็บเล็ต และสมาร์ทโฟนของคุณโดยใช้อินเทอร์เฟซเดียวกัน
• รองรับ MySQL, SQLite และ PostgreSQL เป็นแบ็กเอนด์ฐานข้อมูล
• รองรับคำอธิบายข้อความและความคิดเห็นในส่วนต่างๆ
• รองรับหลายสกุลเงินและรองรับการอัพเดทอัตราแลกเปลี่ยนอัตโนมัติ
• ฟังก์ชั่นการค้นหาและกรองที่มีประสิทธิภาพ รวมถึงการค้นหาแบบพารามิเตอร์ (ค้นหาชิ้นส่วนตามข้อกำหนดบางอย่าง)
• การสร้างภาพขนาดย่ออัตโนมัติสำหรับรูปภาพ
• ใช้ผู้ให้บริการคลาวด์ (เช่น Octopart, Digikey, Farnell, LCSC หรือ TME) เพื่อรับข้อมูลชิ้นส่วน เอกสารข้อมูล และราคาของชิ้นส่วนโดยอัตโนมัติ
• API เพื่อเข้าถึง Part-DB จากแอปพลิเคชัน/สคริปต์อื่น
• การบูรณาการกับ KiCad: ใช้ Part-DB เป็นแหล่งข้อมูลกลางสำหรับ KiCad ของคุณ และดูชิ้นส่วนที่มีจาก Part-DB ภายใน KiCad โดยตรง

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

บริษัทขนาดเล็กและมหาวิทยาลัยยังใช้ Part-DB ในการจัดการสินค้าคงคลังอีกด้วย

ความต้องการ

• เว็บเซิร์ฟเวอร์ (เช่น Apache2 หรือ nginx) ที่สามารถรัน Symfony 6 ได้ ซึ่งรวมถึง PHP เวอร์ชันขั้นต่ำ 8.1
• เซิร์ฟเวอร์ฐานข้อมูล MySQL (อย่างน้อย 5.7) / MariaDB (อย่างน้อย 10.4) หรือ PostgreSQL 10+ หากคุณไม่ต้องการใช้ SQLite
• ขอแนะนำอย่างยิ่งให้เข้าถึงเซิร์ฟเวอร์ของคุณโดยเชลล์!
• สำหรับการสร้าง เส้นด้าย และ โหนด สินทรัพย์ฝั่งไคลเอ็นต์ (>= 18.0) เป็นสิ่งจำเป็น

การติดตั้ง

หากคุณต้องการอัปเกรด Part-DB เวอร์ชันเดิม (< 1.0.0) เป็นเวอร์ชันนี้ โปรดอ่านข้อมูลนี้ก่อน

คำแนะนำ: อิมเมจนักเทียบท่ามีให้ใช้งานภายใต้ jbtronics/part-db1 วิธีการตั้งค่า Part-DB ผ่าน docker มีอธิบายไว้ที่นี่

ด้านล่างนี้คุณจะพบโครงร่างกระบวนการติดตั้งคร่าวๆ ดูที่นี่สำหรับคำแนะนำโดยละเอียดเกี่ยวกับวิธีการติดตั้ง Part-DB

1. คัดลอกหรือโคลนที่เก็บนี้ลงในโฟลเดอร์บนเซิร์ฟเวอร์ของคุณ
2. กำหนดค่าเว็บเซิร์ฟเวอร์ของคุณให้ให้บริการจากโฟลเดอร์ public/ ดูที่นี่สำหรับข้อมูลเพิ่มเติม
3. คัดลอกไฟล์กำหนดค่าส่วนกลาง cp .env .env.local และแก้ไข .env.local :
   • เปลี่ยนบรรทัด APP_ENV=dev เป็น APP_ENV=prod
   • หากคุณไม่ต้องการใช้ SQLite ให้เปลี่ยนค่าของ DATABASE_URL= ตามความต้องการของคุณ ( ดูที่นี่ ) สำหรับรูปแบบ ในอินสแตนซ์ขนาดใหญ่ที่มีการเข้าถึงพร้อมกัน MySQL จะมีประสิทธิภาพมากกว่า สิ่งนี้ไม่สามารถเปลี่ยนแปลงได้ง่ายๆ ในภายหลัง ดังนั้นควรเลือกอย่างชาญฉลาด
4. ติดตั้งการพึ่งพาผู้แต่งและสร้างไฟล์โหลดอัตโนมัติ: composer install -o --no-dev
5. ติดตั้งการพึ่งพาฝั่งไคลเอ็นต์และสร้างมันขึ้นมา: yarn install และ yarn build
6. ทางเลือก (เพิ่มความเร็วในการโหลดครั้งแรก): แคชอุ่นเครื่อง: php bin/console cache:warmup
7. อัปเกรดฐานข้อมูลเป็นรูปแบบใหม่ (หรือสร้างขึ้นเมื่อว่างเปล่า): php bin/console doctrine:migrations:migrate และปฏิบัติตามคำแนะนำที่ให้ไว้ ในระหว่างกระบวนการ รหัสผ่านสำหรับผู้ดูแลระบบจะแสดงเป็นผู้ใช้ คัดลอกมัน ข้อควรระวัง : ขั้นตอนเหล่านี้จะทำให้ฐานข้อมูลของคุณยุ่งและอาจทำลายฐานข้อมูลได้ ดังนั้นควรสำรองฐานข้อมูลของคุณไว้ด้วย
8. คุณสามารถกำหนดค่า Part-DB ได้ผ่าน config/parameters.yaml คุณควรตรวจสอบว่าการตั้งค่าตรงกับความคาดหวังของคุณหลังจากที่คุณติดตั้ง/อัปเกรด Part-DB หรือไม่ ตรวจสอบว่า partdb.default_currency ตรงกับสกุลเงินที่ใช้หลักของคุณหรือไม่ (ซึ่งไม่สามารถเปลี่ยนแปลงได้หลังจากสร้างข้อมูลราคา) เรียกใช้ php bin/console cache:clear เมื่อคุณเปลี่ยนแปลงบางสิ่ง
9. เข้าถึง Part-DB ในเบราว์เซอร์ของคุณ (ใต้ URL ที่คุณใส่) และเข้าสู่ระบบด้วยผู้ใช้ admin รหัสผ่านคือรหัสผ่านที่ส่งออกระหว่างการตั้งค่าฐานข้อมูล หากคุณจำรหัสผ่านไม่ได้ ให้ตั้งค่าใหม่ด้วย php bin/console app:set-password admin คุณสามารถสร้างผู้ใช้ใหม่ด้วยผู้ใช้ผู้ดูแลระบบและเริ่มใช้ Part-DB

เมื่อคุณต้องการอัปเกรดเป็นเวอร์ชันใหม่ ให้คัดลอกไฟล์ใหม่ลงในโฟลเดอร์แล้วทำซ้ำขั้นตอนที่ 4 ถึง 7

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

คุณสามารถกำหนดค่า Part-DB ตามความต้องการของคุณได้โดยการเปลี่ยนตัวแปรสภาพแวดล้อมในไฟล์ . .env.local ดูที่นี่สำหรับข้อมูลเพิ่มเติม

พร็อกซีย้อนกลับ

หากคุณใช้พร็อกซีย้อนกลับ คุณต้องแน่ใจว่าพร็อกซีตั้งค่าส่วนหัว X-Forwarded-* อย่างถูกต้อง ไม่เช่นนั้นคุณจะได้รับ HTTP/HTTPS ผสมกันและชื่อโฮสต์ไม่ถูกต้อง หากพร็อกซีย้อนกลับอยู่บนเซิร์ฟเวอร์อื่น (หรือไม่สามารถเข้าถึง Part-DB ผ่าน localhost) คุณต้องตั้งค่าตัวแปร env TRUSTED_PROXIES ให้ตรงกับที่อยู่ IP ของพร็อกซีย้อนกลับของคุณ (หรือบล็อก IP) คุณสามารถทำได้ใน .env.local หรือ (เมื่อใช้ docker) ในไฟล์ docker-compose.yml

บริจาคเพื่อการพัฒนา

หากคุณต้องการบริจาคให้กับนักพัฒนา Part-DB ให้ดูปุ่มผู้สนับสนุนในแถบด้านบน (ถัดจากชื่อ repo) คุณจะพบวิธีการต่างๆ เพื่อสนับสนุนการพัฒนาแบบรายเดือนหรือแบบครั้งเดียว

สร้างด้วย

• Symfony 5: เฟรมเวิร์กหลักที่ใช้สำหรับ PHP ฝั่งเซิร์ฟเวอร์
• Bootstrap 5 และ Bootswatch: ใช้เป็นธีมของเว็บไซต์
• Fontawesome: ใช้เป็นชุดไอคอน
• Hotwire Stimulus และ Hotwire Turbo: Javascript ส่วนหน้า

ผู้เขียน

• Jan Böhmer - งานเบื้องต้น - GitHub

ดูรายชื่อผู้ร่วมให้ข้อมูลที่เข้าร่วมโครงการนี้ด้วย

อิงจาก Part-DB ดั้งเดิมโดย Christoph Lechner และ K. Jacobs

ใบอนุญาต

Part-DB ได้รับอนุญาตภายใต้ GNU Affero General Public License v3.0 (หรือตามความเห็นของคุณในภายหลัง) ส่วนใหญ่หมายความว่าคุณสามารถใช้ Part-DB สำหรับสิ่งที่คุณต้องการ (แม้จะใช้ในเชิงพาณิชย์) ตราบใดที่คุณเผยแพร่ซอร์สโค้ดสำหรับการเปลี่ยนแปลงทุกครั้งที่คุณทำภายใต้ AGPL เช่นกัน

ดูใบอนุญาตสำหรับข้อมูลเพิ่มเติม