Part DB server

Documents | Démo | Image Docker

Partie-DB

Part-DB est un système de gestion d'inventaire Open Source pour vos composants électroniques. Il est installé sur un serveur Web et est donc accessible avec n'importe quel navigateur sans avoir besoin d'installer de logiciel supplémentaire.

La version de ce référentiel est une réécriture complète de l'ancien Part-DB (version <1.0) basée sur un framework moderne et constitue la version recommandée à utiliser.

Si vous trouvez un bug, veuillez ouvrir un problème sur GitHub afin qu'il puisse être corrigé pour tout le monde.

Démo

Si vous souhaitez tester Part-DB sans l'installer, vous pouvez utiliser cette instance Heroku. (Ou ce lien pour la version allemande).

Vous pouvez vous connecter avec le nom d'utilisateur : user et le mot de passe : user .

Chaque modification apportée à la branche principale est automatiquement déployée, elle représente donc la progression actuelle du développement et n'est peut-être pas complètement stable. Veuillez noter que l'instance gratuite Heroku est utilisée, cela peut donc prendre un certain temps lors du premier chargement de la page.

Caractéristiques

• Gestion des stocks de vos pièces électroniques. Chaque pièce peut être attribuée à une catégorie, une empreinte, un fabricant et plusieurs emplacements de magasin et informations sur les prix. Les pièces peuvent être regroupées à l'aide de balises. Vous pouvez associer divers fichiers comme des fiches techniques ou des images aux pièces.
• Prise en charge multilingue (actuellement allemand, anglais, russe, japonais, français, tchèque, danois et chinois)
• Générateur de codes-barres/étiquettes pour les pièces et les emplacements de stockage, scannez les codes-barres via webcam à l'aide du scanner de codes-barres intégré
• Système utilisateur avec groupes et autorisations détaillées (granulaires fines). L'authentification à deux facteurs est prise en charge (Google Authenticator et clés Webauthn/U2F) et peut être appliquée pour les groupes. La réinitialisation du mot de passe par e-mail peut être configurée.
• Prise en charge facultative de l'authentification unique (SSO) via SAML (en utilisant un service intermédiaire comme Keycloak, vous pouvez connecter Part-DB à un serveur LDAP ou Active Directory existant)
• Système d’import/export pour les pièces et la structure des données. L'importation de nomenclature pour les projets depuis KiCAD est prise en charge.
• Gestion de projet : créez des projets et attribuez des pièces à la nomenclature (BOM), pour montrer à quelle fréquence vous pouvez construire ce projet et retirer directement tous les composants nécessaires de la base de données.
• Journal des événements : suivez les modifications apportées à votre inventaire, suivez quel utilisateur fait quoi. Restaurez vos pièces vers des versions antérieures.
• Conception réactive : vous pouvez utiliser Part-DB sur votre PC, votre tablette et votre smartphone en utilisant la même interface.
• MySQL, SQLite et PostgreSQL sont pris en charge comme backends de bases de données
• Prise en charge des descriptions en texte enrichi et des commentaires en partie
• Prise en charge de plusieurs devises et mise à jour automatique des taux de change pris en charge
• Fonction de recherche et de filtrage puissante, y compris la recherche paramétrique (recherche de pièces selon certaines spécifications)
• Génération automatique de vignettes pour les images
• Utilisez des fournisseurs de cloud (comme Octopart, Digikey, Farnell, LCSC ou TME) pour obtenir automatiquement des informations sur les pièces, des fiches techniques et des prix pour les pièces.
• API pour accéder à Part-DB à partir d'autres applications/scripts
• Intégration avec KiCad : utilisez Part-DB comme source de données centrale pour votre KiCad et consultez les pièces disponibles depuis Part-DB directement dans KiCad.

Grâce à ces fonctionnalités, Part-DB est utile aux amateurs qui souhaitent garder une trace de leur inventaire privé de pièces électroniques, ou des espaces de fabrication, où de nombreux utilisateurs devraient avoir un accès (contrôlé) à l'inventaire partagé.

Part-DB est également utilisé par les petites entreprises et les universités pour gérer leur inventaire.

Exigences

• Un serveur Web (comme Apache2 ou nginx) capable d'exécuter Symfony 6, cela inclut une version PHP minimale de PHP 8.1
• Un serveur de base de données MySQL (au moins 5.7) / MariaDB (au moins 10.4), ou PostgreSQL 10+ si vous ne souhaitez pas utiliser SQLite.
• L'accès Shell à votre serveur est fortement recommandé !
• Pour créer les actifs côté client, Yarn et Nodejs (>= 18.0) sont nécessaires.

Installation

Si vous souhaitez mettre à niveau votre ancienne version (< 1.0.0) de Part-DB vers cette version, veuillez d'abord lire ceci.

Astuce : une image Docker est disponible sous jbtronics/part-db1. Comment configurer Part-DB via Docker est décrit ici.

Vous trouverez ci-dessous un aperçu très approximatif du processus d'installation, voir ici pour un guide détaillé sur la façon d'installer Part-DB.

1. Copiez ou clonez ce référentiel dans un dossier sur votre serveur.
2. Configurez votre serveur Web pour qu'il serve à partir du dossier public/ . Voir ici pour plus d'informations.
3. Copiez le fichier de configuration global cp .env .env.local et éditez .env.local :
   • Remplacez la ligne APP_ENV=dev par APP_ENV=prod
   • Si vous ne souhaitez pas utiliser SQLite, modifiez la valeur de DATABASE_URL= selon vos besoins (voir ici) pour le format. Dans les instances plus grandes avec accès simultanés, MySQL est plus performant. Cela ne peut pas être modifié facilement par la suite, alors choisissez judicieusement.
4. Installez les dépendances du compositeur et générez des fichiers de chargement automatique : composer install -o --no-dev
5. Installez les dépendances côté client et construisez-les : yarn install et yarn build
6. Facultatif (accélère le premier chargement) : Cache de préchauffage : php bin/console cache:warmup
7. Mettez à niveau la base de données vers un nouveau schéma (ou créez-la lorsqu'elle était vide) : php bin/console doctrine:migrations:migrate et suivez les instructions données. Pendant le processus, le mot de passe de l'administrateur et de l'utilisateur est affiché. Copiez-le. Attention : Ces étapes altèrent votre base de données et pourraient potentiellement la détruire. Assurez-vous donc de faire une sauvegarde de votre base de données.
8. Vous pouvez configurer Part-DB via config/parameters.yaml . Vous devez vérifier si les paramètres correspondent à vos attentes après avoir installé/mis à niveau Part-DB. Vérifiez si partdb.default_currency correspond à votre devise principalement utilisée (cela ne peut pas être modifié après la création des informations de prix). Exécutez php bin/console cache:clear lorsque vous modifiez quelque chose.
9. Accédez à Part-DB dans votre navigateur (sous l'URL que vous avez indiquée) et connectez-vous avec l'utilisateur admin . Le mot de passe est celui généré lors de la configuration de la base de données. Si vous ne vous souvenez plus du mot de passe, définissez-en un nouveau avec php bin/console app:set-password admin . Vous pouvez créer de nouveaux utilisateurs avec l'utilisateur administrateur et commencer à utiliser Part-DB.

Lorsque vous souhaitez mettre à niveau vers une version plus récente, copiez simplement les nouveaux fichiers dans le dossier et répétez les étapes 4. à 7.

Normalement, un mot de passe aléatoire est généré lorsque l'utilisateur administrateur est créé lors de la création initiale de la base de données. Cependant, vous pouvez définir le mot de passe administrateur initial en définissant la variable d'environnement INITIAL_ADMIN_PW .

Vous pouvez configurer Part-DB selon vos besoins en modifiant les variables d'environnement dans le fichier .env.local . Voir ici pour plus d'informations.

Proxy inverse

Si vous utilisez un proxy inverse, vous devez vous assurer que les proxys définissent correctement les en-têtes X-Forwarded-* , sinon vous obtiendrez une confusion HTTP/HTTPS et des noms d'hôte erronés. Si le proxy inverse se trouve sur un autre serveur (ou s'il ne peut pas accéder à Part-DB via localhost), vous devez définir la variable d'environnement TRUSTED_PROXIES pour qu'elle corresponde à l'adresse IP (ou au bloc IP) de votre proxy inverse. Vous pouvez le faire dans votre .env.local ou (lorsque vous utilisez docker) dans votre fichier docker-compose.yml .

Faire un don pour le développement

Si vous souhaitez faire un don au développeur Part-DB, consultez le bouton sponsor dans la barre supérieure (à côté du nom du dépôt). Vous y trouverez diverses méthodes pour accompagner le développement sur une base mensuelle ou ponctuelle.

Construit avec

• Symfony 5 : Le framework principal utilisé pour le PHP côté serveur
• Bootstrap 5 et Bootswatch : utilisés comme thème de site Web
• Fontawesome : utilisé comme jeu d'icônes
• Hotwire Stimulus et Hotwire Turbo : Javascript frontal

Auteurs

• Jan Böhmer - Travaux initiaux - GitHub

Voir aussi la liste des contributeurs ayant participé à ce projet.

Basé sur la Part-DB originale de Christoph Lechner et K. Jacobs

Licence

Part-DB est sous licence GNU Affero General Public License v3.0 (ou à votre avis plus tard). Cela signifie principalement que vous pouvez utiliser Part-DB pour tout ce que vous voulez (même l'utiliser commercialement) à condition de publier également le code source pour chaque modification que vous apportez sous l'AGPL.

Voir LICENCE pour plus d’informations.