Part-DB RW - Lagerverwaltung: Unterschied zwischen den Versionen

Aus der Mikrocontroller.net Artikelsammlung, mit Beiträgen verschiedener Autoren (siehe Versionsgeschichte)
Wechseln zu: Navigation, Suche
 
(27 dazwischenliegende Versionen von 13 Benutzern werden nicht angezeigt)
Zeile 1: Zeile 1:
Die "Part-DB RW" Lagerverwaltung für Elektronikteile ist ein Web basierendes System zur Verwaltung elektronischer Bauteile. Das Original stammt von [http://www.cl-projects.de/projects/part-db/ CL-Projekts.de] und wird seit Anfang 2009 von [http://www.grautier.com/ K.J.(Theborg0815)] weitergeführt.
Die "Part-DB" (vormals "Part-DB RW - Lagerverwaltung für Elektronikteile") ist ein Web basierendes System zur Verwaltung elektronischer Bauteile. Das Original stammt von [http://www.cl-projects.de/projects/part-db/ CL-Projekts.de] und wird seit Anfang 2009 von [http://www.grautier.com/ K.J.(Theborg0815)] weitergeführt.


== Überblick ==
== Überblick ==
Zeile 5: Zeile 5:
=== Lizenzmodell ===
=== Lizenzmodell ===


Mit Ausnahme des Java-Menü stehen alle Module unter der GPL. Das Java-Menü ist Bierware.  Somit ist eine kommerzielle Nutzung nur möglich, wenn es vom Ersteller des Menüs genehmigt wird.
Part-DB steht unter der General Public License Version 2. Zusätzlich dazu werden externe Bibliotheken verwendet die unter anderen Lizenzen stehen . Diese sind aber alle kompatibel mit der GPL, weswegen auch eine kommerzielle Nutzung problemlos möglich sein sollte. Weitere Informationen zu den externen Bibliotheken hier: https://github.com/jbtronics/Part-DB/blob/nextgen/readme/EXTERNAL_LIBS.md.


=== Funktionen ===
=== Funktionen ===
Zeile 13: Zeile 13:
* Upload von Bauteil Bildern
* Upload von Bauteil Bildern
* Automatische Anzeige von Footprintbildern
* Automatische Anzeige von Footprintbildern
* Statistik
* Statistik über das gesamte Lager
* Auflistung von: "Zu bestellende Teile", "Teile ohne Preis" und "nicht mehr erhältliche Teile"
* Auflistung von: "Zu bestellende Teile", "Teile ohne Preis" und "nicht mehr erhältliche Teile"
* Liste von Hersteller-Logos
* Liste von Hersteller-Logos
* Informationen zu SMD-Beschriftungen von Widerstände, Kondensatoren und Spulen
* Informationen zu SMD-Beschriftungen von Widerstände, Kondensatoren und Spulen
* Widerstandsrechner
* Widerstandsrechner
* Templatefähig mittels CSS
* Barcodegenerator und Scanfunktion für Barcodes
* Verschiedene mitgelieferte Themes
* 3D Footprints
* Unterstützung von BBCode, in den Bauteilen
* Suche mittels regulärer Ausdrücke
* Auflistung von Teilen an einem Lagerort, mit einem bestimmten Footprint oder eines bestimmten Herstellers
* automatische Erzeugung einer Tabelle mit Bauteileigenschaften aus dem Beschreibungsfeld
* nutzt HTML5, mobile Ansicht
* Benutzersystem mit Unterstützung für Gruppen und Berechtigungen.
* Eventlogsystem


=== Anforderungen ===
=== Anforderungen ===


* Webserver mit ca. 10MB Platz  
* Webserver mit ca. 10MB Platz (ohne Footprints)
* PHP >4.1.2 (PHP5 angetestet, derzeit keine Fehler gefunden) (bei uns im produktiven Einsatz mit PHP5, keine Fehler bekannt. damaltor) (PHP 5.4.14 läuft hier auch einwandfrei, Tectu)
* PHP >= 5.4.0, mit PDO, mbstring und gettext
* Mysql Datenbank
* MySQL/MariaDB Datenbank


== Installation ==
== Installation ==


'''Voraussetzungen:'''<br>
Die aktuelle Dokumentation (inkl. Installationsanleitung) ist hier verfügbar: https://github.com/jbtronics/Part-DB/wiki<br>
* Ein Webserver ist auf dem System installiert, z.B. Apache2<br>
* MySQL ist auf dem System installiert
* zur Administration der Datenbank empfiehlt sich phpMyAdmin


Die aktuelle Version von PartDB kann hier heruntergeladen werden: [http://code.google.com/p/part-db/downloads/detail?name=Part-DB-0.2.2.tar.gz&can=2&q=]<br>
Für Part-DB Version 3.0 findet sich hier eine Dokumentation: http://fthiessen.de/part-db/doku.php?id=start
Hier finden sich die neueren Release-Kandidanten:
[https://code.google.com/p/part-db/downloads/list]
 
==== Anlegen der Datenbank ====
 
* PhpMyAdmin starten und eine Datenbank part-db anlegen: [[Datei:Screenshot-4.png|right]]
* Tabellen anlegen:
** Den Reiter ''Import'' anklicken
** und unter ''Location of the text file'' die Datei createtables.sql angeben. (Die ist im PartDB-Installationsarchiv enthalten.)
** Go klicken
* Falls vorhanden, existierende Daten importieren
** Nochmal den Reiter ''Import'' anklicken
** Datendatei unter ''Location of the text file'' eingeben
** Go klicken
* MySql-User anlegen [[Datei:Screenshot-5.png|right]]
** Im Navigationsbereich ''Home'' klicken
** Dann den Link ''Privileges'' klicken
** Den Link ''Add a new User'' klicken
** Dort mindestens die Angaben machen, die hier(Bild) zu sehen sind
** Unter '''Global privileges''' alle Kästchen unter '''Data''' ankreuzen
** Go klicken
 
Hinweis für Fortgeschrittene: Datenbanken kann man auch mit MySQLDumper[http://www.mysqldumper.de/] oder auf der Kommandozeile (mysql part-db < readme/createtabels.sql) importieren.
 
==== PartDB-Applikation installieren ====
 
* Den Inhalt des Archivs Part-DB-x.y.z.tar.gz in das Serververzeichnis (unter Linux: /var/www ; unter Windows ???) entpacken
* Das Verzeichnis, das nun in www steht, nach ''part-db'' umbenennen
* .../www/part-db/config.php in einen Editor laden (.../www/part-db/lib.php in Version "part-db v0.1") und in der Gegend von Zeile 50 folgende Änderungen machen:
** $link = mysql_connect ("localhost", "part-db", "");
** mysql_select_db ("part-db");
 
Damit ist PartDB installiert und kann im Browser aufgerufen werden.
 
----
 
==== Öffentliche Liste einrichten ====
 
Am einfachsten geht es, wenn Ihr auf dem Server einen extra Ordner erstellt. In diesen kopiert Ihr die openlist.php und partdb.css.
In der openlist.php müsst Ihr dann noch den Pfad zur partdb.css und zur lib.php vollständig angeben.
 
Alternativ könnt Ihr auch den Ordner ../partdb/openlist/ mit .htacsses wieder freigeben dieses klappt aber nur wenn der Webserver dieses erlaubt.


----
----
Zeile 106: Zeile 70:
Die virtuelle Maschine kann je nach Host-Betriebsystem mit folgenden Programmen administriert werden:
Die virtuelle Maschine kann je nach Host-Betriebsystem mit folgenden Programmen administriert werden:


* Windos
* Windows
** puTTY zum Einloggen in die VM
** puTTY zum Einloggen in die VM
** WinSCP für den (höchst komfortablen) Dateitransfer
** WinSCP für den (höchst komfortablen) Dateitransfer
Zeile 119: Zeile 83:
** Nachladen der benötigten Zusatzmodule übers Web mit folgenden Befehlen
** Nachladen der benötigten Zusatzmodule übers Web mit folgenden Befehlen
*** apt-get update
*** apt-get update
*** apt-get install mysql-server php5 phpmyadmin
*** sudo apt-get install apache2 php7.0 mysql-server php7.0-mysql php7.0-curl libapache2-mod-php7.0 phpmyadmin php7.0-opcache php7.0-gettext


Damit ist apache2, mysql, php5 und phpmyadmin installiert.
Damit ist apache2, mysql, php5 und phpmyadmin installiert.
Zeile 138: Zeile 102:
* http://<ip-adresse der vm>/phpmyadmin
* http://<ip-adresse der vm>/phpmyadmin


Weiter geht es dann wie oben unter [http://www.mikrocontroller.net/articles/Part-DB_RW_-_Lagerverwaltung#Anlegen_der_Datenbank Anlegen der Datenbank] beschrieben, um die Datenbank anzulegen.
Weiter geht es dann wie oben unter [https://github.com/jbtronics/Part-DB/wiki/Installation#anlegen-der-datenbank Anlegen der Datenbank] beschrieben, um die Datenbank anzulegen.


Nach dem Abschnitt '''Anlegen der Datenbank''' wird hier fortgesetzt:
Nach dem Abschnitt '''Anlegen der Datenbank''' wird hier fortgesetzt:


Eine fertig konfigurierte virtuelle Maschine kann hier heruntergeladen werden: [http://www.mikrocontroller.net/attachment/63911/part-db.tar.bz2] Der Download ist mit gut 216 MB allerdings ziemlich fett.
Eine fertig konfigurierte virtuelle Maschine kann hier heruntergeladen werden (veraltete Version): [http://www.mikrocontroller.net/attachment/63911/part-db.tar.bz2] Der Download ist mit gut 216 MB allerdings ziemlich fett.
 
== Online-Demo ==
(Derzeit nicht verfügbar)
Wer Part-DB einmal ausprobieren möchte ohne es installieren zu müssen, findet hier eine Demoinstallation: http://part-db.bplaced.net/startup.php
Diese ist auch auf Englisch verfügbar: http://part-db.bplaced.net/part-en/startup.php
 
Um ein Bauteil in der Demo bearbeiten zu können, müssen sie sich oben rechts mit Klick auf das Usericon einloggen: Benutzen sie hierfür den Nutzernamen: "user" und das Password: "user" (Ohne Anführungszeichen).


== Wünsche / Verbesserungsvorschläge / Bugreports ==
== Wünsche / Verbesserungsvorschläge / Bugreports ==


Du hast Wünsche, Verbesserungsvorschläge oder einen Bug gefunden? Dann schau bitte zuerst in unsere TODO-Liste, ob nicht schon ein solcher Eintrag vorhanden ist: http://code.google.com/p/part-db/issues/list
Du hast Wünsche, Verbesserungsvorschläge oder einen Bug gefunden? Dann schau bitte zuerst in unsere TODO-Liste, ob nicht schon ein solcher Eintrag vorhanden ist: https://github.com/jbtronics/Part-DB/issues


Ist kein entsprechender Eintrag in der TODO-Liste vorhanden, bitte kurz im Diskusionsthread schreiben worum es geht: http://www.mikrocontroller.net/topic/269289
Ist kein entsprechender Eintrag in der TODO-Liste vorhanden, bitte kurz im Diskusionsthread schreiben worum es geht: https://www.mikrocontroller.net/topic/305023


== Sonstiges ==
== Screenshots ==
Aktuelle Screenshots finden sich hier: https://github.com/jbtronics/Part-DB/wiki/Screenshots


Preissuchskript von Michael Buesch: [http://bu3sch.de/partdb-autoprice/]<br>
<gallery caption="Part-DB 0.5" widths="150px" perrow="4">
Die Beschreibung findet man hier: [http://www.mikrocontroller.net/topic/135284#1466454]
Datei:Homepage.png
Datei:Categories.png
Datei:0.5 Edit part.png
Datei:0.5 Event log.png
Datei:0.5 History graph.png
Datei:0.5 History table.png
Datei:0.5 Statistics.png
Datei:0.5 Statistics graph.png


== Screenshots ==
</gallery>
 
<gallery caption="Part-DB 0.4" widths="150px" perrow="4">
Datei:Startseite.png|Startseite
Datei:List parts.png|Bauteile mit einer bestimmten Kategorie
Datei:Parts info.png|Bauteilübersicht
Datei:Edit part.png|Bauteilbearbeitung
Datei:Search.png|Suchfunktion
Datei:System setting.png|Systemeinstellungen
Datei:Edit storelocations.png|Lagerorte bearbeiten
Datei:Baugruppenübersicht.png|Baugruppenübersicht
Datei:Theme1.png|Alternatives Theme 1
Datei:Theme2.png|Alternatives Theme 2
Datei:Theme3.png|Alternatives Theme 3
 
</gallery>


<gallery caption="Gallery" widths="150px" heights="150px" perrow="4">
=== Version 0.3 ===
<gallery caption="Version 0.3" widths="150px" heights="150px" perrow="4">
Datei:partdb.png|Index Seite
Datei:partdb.png|Index Seite
Datei:list.png|Liste
Datei:list.png|Liste
Zeile 171: Zeile 166:


== Links ==
== Links ==
* PART-DB RW Fork/Weiterentwicklung: http://www.grautier.com/grautier/index.php?/archives/77-Part-DB-V0.1.3-RW.html
* Diskussion: https://www.mikrocontroller.net/topic/305023
* Github repository (bis v0.3.1): https://github.com/sandboxgangster/Part-DB
* Github Fork v0.4.0: https://github.com/jbtronics/Part-DB/


Online-Demo von Part-DB RW (zum ausprobieren): http://partdb.grautier.com/
andere Softwareprodukte mit vergleichbarer Funktionalität:
<br>
* Teileverwaltung von Gutmensch (App. basiert): http://www.mikrocontroller.net/topic/89071#new
Die Homepage des Org. Projektes finden Sie unter http://www.cl-projects.de/projects/part-db/.
* [[Elektronik Lagerverwaltung]], EleLa ein anderes Lagerverwaltungsprogramm, EXE für Windows und Linux
<br>
* PartKeepr: https://github.com/partkeepr/PartKeepr, [http://demo.partkeepr.org/ Demo]
PART-DB RW Fork/Weiterentwicklung: http://www.grautier.com/grautier/index.php?/archives/77-Part-DB-V0.1.3-RW.html<br>
Diskussion: http://www.mikrocontroller.net/topic/269289
<br>
Subversion repository: http://code.google.com/p/part-db/
<br>
Teileverwaltung von Gutmensch (App. basiert): http://www.mikrocontroller.net/topic/89071#new
<br>
[[Elektronik Lagerverwaltung]] ein anderes Lagerverwaltungsprogramm, EXE für Windows  
<br>PartKeepr: https://github.com/partkeepr/PartKeepr, [http://demo.partkeepr.org/ Demo]


[[Category:Projekte]]
[[Category:Projekte]]

Aktuelle Version vom 4. November 2022, 23:39 Uhr

Die "Part-DB" (vormals "Part-DB RW - Lagerverwaltung für Elektronikteile") ist ein Web basierendes System zur Verwaltung elektronischer Bauteile. Das Original stammt von CL-Projekts.de und wird seit Anfang 2009 von K.J.(Theborg0815) weitergeführt.

Überblick

Lizenzmodell

Part-DB steht unter der General Public License Version 2. Zusätzlich dazu werden externe Bibliotheken verwendet die unter anderen Lizenzen stehen . Diese sind aber alle kompatibel mit der GPL, weswegen auch eine kommerzielle Nutzung problemlos möglich sein sollte. Weitere Informationen zu den externen Bibliotheken hier: https://github.com/jbtronics/Part-DB/blob/nextgen/readme/EXTERNAL_LIBS.md.

Funktionen

  • Angabe von Lagerorten, Footprints, Kategorien, Lieferanten, Datenblattern, Preise, Bestellnummern, ...
  • Baugruppenverwaltung
  • Upload von Bauteil Bildern
  • Automatische Anzeige von Footprintbildern
  • Statistik über das gesamte Lager
  • Auflistung von: "Zu bestellende Teile", "Teile ohne Preis" und "nicht mehr erhältliche Teile"
  • Liste von Hersteller-Logos
  • Informationen zu SMD-Beschriftungen von Widerstände, Kondensatoren und Spulen
  • Widerstandsrechner
  • Barcodegenerator und Scanfunktion für Barcodes
  • Verschiedene mitgelieferte Themes
  • 3D Footprints
  • Unterstützung von BBCode, in den Bauteilen
  • Suche mittels regulärer Ausdrücke
  • Auflistung von Teilen an einem Lagerort, mit einem bestimmten Footprint oder eines bestimmten Herstellers
  • automatische Erzeugung einer Tabelle mit Bauteileigenschaften aus dem Beschreibungsfeld
  • nutzt HTML5, mobile Ansicht
  • Benutzersystem mit Unterstützung für Gruppen und Berechtigungen.
  • Eventlogsystem

Anforderungen

  • Webserver mit ca. 10MB Platz (ohne Footprints)
  • PHP >= 5.4.0, mit PDO, mbstring und gettext
  • MySQL/MariaDB Datenbank

Installation

Die aktuelle Dokumentation (inkl. Installationsanleitung) ist hier verfügbar: https://github.com/jbtronics/Part-DB/wiki

Für Part-DB Version 3.0 findet sich hier eine Dokumentation: http://fthiessen.de/part-db/doku.php?id=start


Anleitung zum Bau eines PartDB-Servers in einer virtuellen Maschine

Dieser Abschnitt hat noch Baustellenstatus

Voraussetzungen

Aufbau des Servers unter VMware Server 2.0

  • Herunterladen der TurnKey Core Appliance von http://www.turnkeylinux.org/core
  • Entpacken des Archivs in das Verzeichnis für virtuelle Maschinen
  • Importieren der VM über das Browser-Applet für den VMware Server:
    • Virtual Machine | Add Virtual Machine to Inventory klicken
    • Unter Inventory Standard klicken
    • Unter Content das Verzeichnis der zu importierenden VM doppelklicken
    • Die .vmx-Datei anklicken und mit OK bestätigen
  • Im Inventory-Bereich des Hauptfensters die neue VM auswählen und warten, bis rechts Daten und Befehle angezeigt werden.
  • Rechts in der Mitte unter Commands den Link Power on anklicken.
  • Den Reiter Console anklicken. Es öffnet sich ein Fenster mit schwarzem Hintergrund.
  • In das schwarze Fenster klicken und warten, bis das Konsolfenster der VM aufgeht.

Im Konsolfenster wird nach vollständigem Boot ein Dialog angezeigt, der im Wesentlichen die IP-Adresse der VM enthält, die in der Grundeinstellung über DHCP bezogen wird.

Über den einzigen Menüpunkt dieses Dialogs kann später eine statische IP-Adresse eingestellt werden.

Die virtuelle Maschine kann je nach Host-Betriebsystem mit folgenden Programmen administriert werden:

  • Windows
    • puTTY zum Einloggen in die VM
    • WinSCP für den (höchst komfortablen) Dateitransfer

Beide Programme sind kostenlos auf dem Web zu finden

  • Linux
    • ssh zum Einloggen in die VM
    • sftp für den Dateitransfer

Vorbereiten der VM für PartDB

  • Einloggen in die VM über puTTY/ssh
    • Nachladen der benötigten Zusatzmodule übers Web mit folgenden Befehlen
      • apt-get update
      • sudo apt-get install apache2 php7.0 mysql-server php7.0-mysql php7.0-curl libapache2-mod-php7.0 phpmyadmin php7.0-opcache php7.0-gettext

Damit ist apache2, mysql, php5 und phpmyadmin installiert.

Als erstes wird über Webmin der User part-db in der VM angelegt:

  • https://<ip-adresse der vm>:12321/
    • 'System | Users and Groups klicken
    • Den Link Create a new user. klicken
      • Username: part-db
      • User ID: Automatic
      • Real name: part-db
      • Create home directory? No (Steht ganz unten!)
    • Create-Button klicken

Jetzt kann PhpMyAdmin im Browser des Hostsystems aufgerufen werden:

  • http://<ip-adresse der vm>/phpmyadmin

Weiter geht es dann wie oben unter Anlegen der Datenbank beschrieben, um die Datenbank anzulegen.

Nach dem Abschnitt Anlegen der Datenbank wird hier fortgesetzt:

Eine fertig konfigurierte virtuelle Maschine kann hier heruntergeladen werden (veraltete Version): [1] Der Download ist mit gut 216 MB allerdings ziemlich fett.

Online-Demo

(Derzeit nicht verfügbar) Wer Part-DB einmal ausprobieren möchte ohne es installieren zu müssen, findet hier eine Demoinstallation: http://part-db.bplaced.net/startup.php Diese ist auch auf Englisch verfügbar: http://part-db.bplaced.net/part-en/startup.php

Um ein Bauteil in der Demo bearbeiten zu können, müssen sie sich oben rechts mit Klick auf das Usericon einloggen: Benutzen sie hierfür den Nutzernamen: "user" und das Password: "user" (Ohne Anführungszeichen).

Wünsche / Verbesserungsvorschläge / Bugreports

Du hast Wünsche, Verbesserungsvorschläge oder einen Bug gefunden? Dann schau bitte zuerst in unsere TODO-Liste, ob nicht schon ein solcher Eintrag vorhanden ist: https://github.com/jbtronics/Part-DB/issues

Ist kein entsprechender Eintrag in der TODO-Liste vorhanden, bitte kurz im Diskusionsthread schreiben worum es geht: https://www.mikrocontroller.net/topic/305023

Screenshots

Aktuelle Screenshots finden sich hier: https://github.com/jbtronics/Part-DB/wiki/Screenshots

Version 0.3

Links

andere Softwareprodukte mit vergleichbarer Funktionalität: