Dokumentation | Demo | Docker-Image
Part-DB ist ein Open-Source-Bestandsverwaltungssystem für Ihre elektronischen Komponenten. Es wird auf einem Webserver installiert und kann daher mit jedem Browser aufgerufen werden, ohne dass zusätzliche Software installiert werden muss.
Die Version in diesem Repository ist eine vollständige Neufassung der alten Part-DB (Version < 1.0) basierend auf einem modernen Framework und ist die empfohlene Version.
Wenn Sie einen Fehler finden, öffnen Sie bitte ein Problem auf GitHub, damit es für alle behoben werden kann.
Wenn Sie Part-DB testen möchten, ohne es zu installieren, können Sie diese Heroku-Instanz verwenden. (Oder dieser Link für die deutsche Version).
Sie können sich mit dem Benutzernamen: user und dem Passwort: user anmelden.
Jede Änderung am Master-Zweig wird automatisch bereitgestellt, sodass sie den aktuellen Entwicklungsfortschritt darstellt und möglicherweise nicht vollständig stabil ist. Bitte beachten Sie, dass die kostenlose Heroku-Instanz verwendet wird, sodass es beim ersten Laden der Seite einige Zeit dauern kann.
Mit diesen Funktionen ist Part-DB nützlich für Bastler, die den Überblick über ihren privaten Bestand an elektronischen Teilen behalten möchten, oder für Makerspaces, in denen viele Benutzer (kontrollierten) Zugriff auf den gemeinsamen Bestand haben sollten.
Part-DB wird auch von kleinen Unternehmen und Universitäten zur Verwaltung ihrer Bestände genutzt.
Wenn Sie Ihre ältere Version (< 1.0.0) von Part-DB auf diese Version aktualisieren möchten, lesen Sie dies bitte zuerst.
Hinweis: Ein Docker-Image ist unter jbtronics/part-db1 verfügbar. Wie Sie Part-DB über Docker einrichten, wird hier beschrieben.
Nachfolgend finden Sie einen sehr groben Überblick über den Installationsprozess. Eine detaillierte Anleitung zur Installation von Part-DB finden Sie hier.
public/
“ bereitgestellt wird. Weitere Informationen finden Sie hier.cp .env .env.local
und bearbeiten Sie .env.local
:APP_ENV=dev
in APP_ENV=prod
DATABASE_URL=
entsprechend Ihren Anforderungen (siehe hier) für das Format. In größeren Instanzen mit gleichzeitigen Zugriffen ist MySQL leistungsfähiger. Dies kann später nicht einfach geändert werden, wählen Sie also mit Bedacht aus.composer install -o --no-dev
yarn install
und yarn build
php bin/console cache:warmup
php bin/console doctrine:migrations:migrate
und befolgen Sie die gegebenen Anweisungen. Während des Vorgangs wird das Passwort des Admin-Benutzers angezeigt. Kopieren Sie es. Achtung : Diese Schritte manipulieren Ihre Datenbank und könnten sie möglicherweise zerstören. Stellen Sie daher sicher, dass Sie ein Backup Ihrer Datenbank erstellen.config/parameters.yaml
konfigurieren. Sie sollten überprüfen, ob die Einstellungen Ihren Erwartungen entsprechen, nachdem Sie Part-DB installiert/aktualisiert haben. Überprüfen Sie, ob partdb.default_currency
mit Ihrer hauptsächlich verwendeten Währung übereinstimmt (dies kann nach dem Erstellen der Preisinformationen nicht mehr geändert werden). Führen Sie php bin/console cache:clear
wenn Sie etwas ändern.php bin/console app:set-password admin
ein neues fest. Mit dem Admin-Benutzer können Sie neue Benutzer erstellen und mit der Nutzung von Part-DB beginnen.Wenn Sie auf eine neuere Version aktualisieren möchten, kopieren Sie einfach die neuen Dateien in den Ordner und wiederholen Sie die Schritte 4. bis 7.
Normalerweise wird ein zufälliges Passwort generiert, wenn der Admin-Benutzer während der ersten Datenbankerstellung erstellt wird. Sie können jedoch das anfängliche Admin-Passwort festlegen, indem Sie die Umgebungsvariable INITIAL_ADMIN_PW
festlegen.
Sie können Part-DB entsprechend Ihren Anforderungen konfigurieren, indem Sie Umgebungsvariablen in der Datei .env.local
ändern. Weitere Informationen finden Sie hier.
Wenn Sie einen Reverse-Proxy verwenden, müssen Sie sicherstellen, dass die Proxys die X-Forwarded-*
Header richtig setzen, sonst kommt es zu einer HTTP/HTTPS-Verwechslung und falschen Hostnamen. Wenn sich der Reverse-Proxy auf einem anderen Server befindet (oder nicht über localhost auf Part-DB zugreifen kann), müssen Sie die Umgebungsvariable TRUSTED_PROXIES
so einstellen, dass sie mit der IP-Adresse (oder dem IP-Block) Ihres Reverse-Proxys übereinstimmt. Sie können dies in Ihrer .env.local
oder (bei Verwendung von Docker) in Ihrer docker-compose.yml
Datei tun.
Wenn Sie an den Part-DB-Entwickler spenden möchten, sehen Sie sich die Sponsorenschaltfläche in der oberen Leiste (neben dem Repo-Namen) an. Dort finden Sie verschiedene Möglichkeiten, die Entwicklung monatlich oder einmalig zu unterstützen.
Siehe auch die Liste der Mitwirkenden, die an diesem Projekt teilgenommen haben.
Basierend auf der Original-Part-DB von Christoph Lechner und K. Jacobs
Part-DB ist unter der GNU Affero General Public License v3.0 (oder Ihrer Meinung nach auch später) lizenziert. Dies bedeutet hauptsächlich, dass Sie Part-DB für alles verwenden können, was Sie möchten (sogar kommerziell nutzen), solange Sie den Quellcode für jede Änderung, die Sie unter der AGPL vornehmen, ebenfalls veröffentlichen.
Weitere Informationen finden Sie unter LIZENZ.