Part DB server

文檔|演示| Docker 映像

部分資料庫

Part-DB 是一個針對電子元件的開源庫存管理系統。它安裝在網頁伺服器上，因此可以使用任何瀏覽器進行訪問，而無需安裝其他軟體。

此儲存庫中的版本是基於現代框架的舊版 Part-DB（版本 < 1.0）的完全重寫，是建議使用的版本。

如果您發現錯誤，請在 GitHub 上開啟問題，以便每個人都能修復它。

示範

如果您想在不安裝 Part-DB 的情況下測試它，可以使用此 Heroku 實例。 （或德語版本的連結）。

您可以使用使用者名稱： user和密碼： user登入。

主分支的每次變更都會自動部署，因此它代表當前的開發進度，並且可能不完全穩定。請注意，使用免費的 Heroku 實例，因此首次載入頁面可能需要一些時間。

特徵

• 電子零件的庫存管理。每個零件都可以分配給一個類別、佔地面積、製造商以及多個商店位置和價格資訊。可以使用標籤對部件進行分組。您可以將資料表或圖片等各種文件與零件相關聯。
• 多語言支援（目前支援德語、英語、俄語、日語、法語、捷克語、丹麥語和中文）
• 零件和儲存位置的條碼/標籤產生器，使用內建條碼掃描器透過網路攝影機掃描條碼
• 具有群組和詳細（細粒度）權限的使用者係統。支援雙重認證（Google Authenticator 和 Webauthn/U2F 金鑰），並且可以針對群組強制執行。可以設定透過電子郵件重設密碼。
• 透過 SAML 對單一登入 (SSO) 的選用支援（使用 Keycloak 等中間服務，您可以將 Part-DB 連接到現有的 LDAP 或 Active Directory 伺服器）
• 零件和資料結構的導入/匯出系統。支援從 KiCAD 導入專案的 BOM。
• 專案管理：建立專案並將零件分配到物料清單 (BOM)，以顯示您可以建立此專案並直接從資料庫中提取所需的所有組件的頻率
• 事件日誌：追蹤庫存發生的變化，追蹤哪個使用者做了什麼。將您的部件還原到舊版本。
• 響應式設計：您可以使用相同的介面在 PC、平板電腦和智慧型手機上使用 Part-DB。
• 支援 MySQL、SQLite 和 PostgreSQL 作為資料庫後端
• 支援豐富的文字描述和部分註釋
• 支援多種貨幣並支援自動更新匯率
• 強大的搜尋和過濾功能，包括參數搜尋（根據某些規格搜尋零件）
• 自動產生圖片縮圖
• 使用雲端提供者（例如 Octopart、Digikey、Farnell、LCSC 或 TME）自動取得零件資訊、資料表和零件價格
• 用於從其他應用程式/腳本存取 Part-DB 的 API
• 與 KiCad 整合：使用 Part-DB 作為 KiCad 的中央資料來源，並直接在 KiCad 內查看 Part-DB 中可用的零件。

憑藉這些功能，Part-DB 對於業餘愛好者來說非常有用，他們希望追蹤自己的私人電子零件庫存或創客空間，其中許多用戶應該能夠（受控）存取共享庫存。

小公司和大學也使用 Part-DB 來管理庫存。

要求

• 能夠運行 Symfony 6 的Web 伺服器（例如 Apache2 或 nginx），其中至少包含PHP 8.1的 PHP 版本
• MySQL （至少 5.7）/ MariaDB （至少 10.4）資料庫伺服器，或PostgreSQL 10+（如果您不想使用 SQLite）。
• 強烈建議透過 shell 存取您的伺服器！
• 為了建構客戶端資產，需要yarn和nodejs (>= 18.0)。

安裝

如果您想將舊版（< 1.0.0）的 Part-DB 升級到此版本，請先閱讀本文。

提示： docker 映像位於 jbtronics/part-db1 下。這裡描述如何透過 docker 設定 Part-DB。

下面您可以找到安裝過程的非常粗略的概述，請參閱此處以獲取有關如何安裝 Part-DB 的詳細指南。

1. 將此儲存庫複製或複製到伺服器上的資料夾中。
2. 將您的網頁伺服器配置為從public/資料夾提供服務。請參閱此處以了解更多資訊。
3. 複製全域設定檔cp .env .env.local並編輯.env.local ：
   • 將行APP_ENV=dev更改為APP_ENV=prod
   • 如果您不想使用 SQLite，請將DATABASE_URL=的值變更為您需要的格式（請參閱此處）。在具有並發存取的較大實例中，MySQL 的效能更高。這以後不能輕易改變，所以要明智地選擇。
4. 安裝 Composer 依賴項並產生自動載入檔案： composer install -o --no-dev
5. 安裝客戶端依賴項並建置它： yarn install和yarn build
6. 可選（加快首次載入速度）：預熱快取： php bin/console cache:warmup
7. 將資料庫升級到新方案（或在它為空時建立它）： php bin/console doctrine:migrations:migrate並按照給予的說明進行操作。在此過程中，會顯示管理員的密碼 user。複製它。注意：這些步驟會篡改您的資料庫並可能破壞它。因此，請務必對資料庫進行備份。
8. 您可以透過config/parameters.yaml設定 Part-DB。安裝/升級 Part-DB 後，您應該檢查設定是否符合您的期望。檢查partdb.default_currency是否與您主要使用的貨幣相符（建立價格資訊後無法變更）。當您變更某些內容時，請執行php bin/console cache:clear 。
9. 在瀏覽器中存取 Part-DB（在您輸入的 URL 下）並使用使用者admin登入。密碼是DB設定時輸出的密碼。如果您忘記了密碼，請使用php bin/console app:set-password admin設定新密碼。您可以使用 admin 使用者建立新使用者並開始使用 Part-DB。

當您想要升級到較新版本時，只需將新檔案複製到該資料夾中並重複步驟 4. 至 7.

通常，在初始資料庫建立期間建立管理員使用者時會產生隨機密碼，但是，您可以透過設定INITIAL_ADMIN_PW環境變數來設定初始管理員密碼。

您可以透過變更.env.local檔案中的環境變數來根據需要設定 Part-DB。請參閱此處以了解更多資訊。

反向代理

如果您使用反向代理，則必須確保代理程式正確設定X-Forwarded-*標頭，否則您將得到 HTTP/HTTPS 混合和錯誤的主機名稱。如果反向代理位於不同的伺服器上（或它無法透過本機存取 Part-DB），則必須設定TRUSTED_PROXIES環境變數以符合反向代理的 IP 位址（或 IP 區塊）。您可以在.env.local或（使用 docker 時）在docker-compose.yml檔案中執行此操作。

捐助發展

如果您想向 Part-DB 開發人員捐款，請參閱頂部欄中的贊助商按鈕（儲存庫名稱旁）。在那裡，您將找到各種方法來支援每月或一次性的開發。

內建

• Symfony 5：用於伺服器端 PHP 的主要框架
• Bootstrap 5 與 Bootswatch：作為網站主題
• Fontawesome：用作圖示集
• Hotwire Stimulus 和 Hotwire Turbo：前端 Javascript

作者

• Jan Böhmer -初始工作- GitHub

另請參閱參與專案的貢獻者清單。

基於 Christoph Lechner 和 K. Jacobs 的原始 Part-DB

執照

Part-DB 根據 GNU Affero 通用公共授權 v3.0（或根據您的意見）授權。這主要意味著您可以將 Part-DB 用於您想要的任何用途（甚至將其用於商業用途），只要您也發佈在 AGPL 下所做的每個變更的原始程式碼。

請參閱許可證以了解更多資訊。