Part DB server

Documentación | Demostración | Imagen acoplable

Parte-DB

Part-DB es un sistema de gestión de inventario de código abierto para sus componentes electrónicos. Se instala en un servidor web y, por lo tanto, se puede acceder a él con cualquier navegador sin necesidad de instalar software adicional.

La versión en este repositorio es una reescritura completa de la Part-DB heredada (versión <1.0) basada en un marco moderno y es la versión recomendada para usar.

Si encuentra un error, abra un problema en GitHub para que pueda solucionarlo para todos.

Manifestación

Si desea probar Part-DB sin instalarlo, puede utilizar esta instancia de Heroku. (O este enlace para la versión alemana).

Puede iniciar sesión con nombre de usuario: usuario y contraseña: usuario .

Cada cambio en la rama maestra se implementa automáticamente, por lo que representa el progreso del desarrollo actual y es posible que no sea completamente estable. Tenga en cuenta que se utiliza la instancia gratuita de Heroku, por lo que puede llevar algún tiempo cargar la página por primera vez.

Características

• Gestión de inventario de sus piezas electrónicas. Cada pieza se puede asignar a una categoría, tamaño, fabricante y múltiples ubicaciones de tiendas e información de precios. Las piezas se pueden agrupar mediante etiquetas. Puede asociar varios archivos como hojas de datos o imágenes con las piezas.
• Soporte en varios idiomas (actualmente alemán, inglés, ruso, japonés, francés, checo, danés y chino)
• Generador de códigos de barras/etiquetas para piezas y ubicaciones de almacenamiento, escanee códigos de barras a través de la cámara web utilizando el escáner de códigos de barras incorporado
• Sistema de usuario con grupos y permisos detallados (granulares finos). Se admite la autenticación de dos factores (Google Authenticator y claves Webauthn/U2F) y se puede aplicar a grupos. Se puede configurar el restablecimiento de contraseña por correo electrónico.
• Soporte opcional para inicio de sesión único (SSO) a través de SAML (utilizando un servicio intermedio como Keycloak puede conectar Part-DB a un servidor LDAP o Active Directory existente)
• Sistema de importación/exportación de piezas y estructura de datos. Se admite la importación de BOM para proyectos desde KiCAD.
• Gestión de proyectos: cree proyectos y asigne piezas a la lista de materiales (BOM), para mostrar con qué frecuencia puede construir este proyecto y retirar directamente todos los componentes necesarios de la base de datos.
• Registro de eventos: realice un seguimiento de los cambios que ocurren en su inventario, realice un seguimiento de qué usuario hace qué. Revierta sus piezas a versiones anteriores.
• Diseño responsivo: Puede usar Part-DB en su PC, tableta y teléfono inteligente usando la misma interfaz.
• MySQL, SQLite y PostgreSQL son compatibles como backends de bases de datos
• Soporte para descripciones de texto enriquecido y comentarios en partes
• Soporte para múltiples monedas y actualización automática de tipos de cambio admitidos
• Potente función de búsqueda y filtrado, incluida la búsqueda paramétrica (búsqueda de piezas según algunas especificaciones)
• Generación automática de miniaturas para imágenes.
• Utilice proveedores de la nube (como Octopart, Digikey, Farnell, LCSC o TME) para obtener automáticamente información, hojas de datos y precios de las piezas.
• API para acceder a Part-DB desde otras aplicaciones/scripts
• Integración con KiCad: utilice Part-DB como fuente de datos central para su KiCad y vea las piezas disponibles de Part-DB directamente dentro de KiCad.

Con estas características, Part-DB es útil para los aficionados que desean realizar un seguimiento de su inventario privado de piezas electrónicas o espacios de fabricación, donde muchos usuarios deberían tener acceso (controlado) al inventario compartido.

Part-DB también lo utilizan pequeñas empresas y universidades para gestionar su inventario.

Requisitos

• Un servidor web (como Apache2 o nginx) que sea capaz de ejecutar Symfony 6, esto incluye una versión PHP mínima de PHP 8.1
• Un servidor de base de datos MySQL (al menos 5.7) / MariaDB (al menos 10.4), o PostgreSQL 10+ si no desea utilizar SQLite.
• ¡Se recomienda encarecidamente el acceso Shell a su servidor!
• Para construir los activos del lado del cliente, se necesita hilo y nodejs (>= 18.0).

Instalación

Si desea actualizar su versión heredada (< 1.0.0) de Part-DB a esta versión, lea esto primero.

Sugerencia: Hay una imagen de la ventana acoplable disponible en jbtronics/part-db1. Aquí se describe cómo configurar Part-DB a través de la ventana acoplable.

A continuación encontrará un resumen muy aproximado del proceso de instalación; consulte aquí para obtener una guía detallada sobre cómo instalar Part-DB.

1. Copie o clone este repositorio en una carpeta de su servidor.
2. Configure su servidor web para que funcione desde la carpeta public/ . Consulte aquí para obtener información adicional.
3. Copie el archivo de configuración global cp .env .env.local y edite .env.local :
   • Cambie la línea APP_ENV=dev a APP_ENV=prod
   • Si no desea utilizar SQLite, cambie el valor de DATABASE_URL= según sus necesidades (consulte aquí) para el formato. En instancias más grandes con accesos simultáneos, MySQL tiene más rendimiento. Esto no se puede cambiar fácilmente más adelante, así que elija sabiamente.
4. Instale las dependencias del compositor y genere archivos de carga automática: composer install -o --no-dev
5. Instale las dependencias del lado del cliente y constrúyalas: yarn install y yarn build
6. Opcional (acelera la primera carga): Caché de calentamiento: php bin/console cache:warmup
7. Actualice la base de datos al nuevo esquema (o créela, cuando esté vacía): php bin/console doctrine:migrations:migrate y siga las instrucciones dadas. Durante el proceso se muestra la contraseña del administrador es usuario. Cópialo. Precaución : Estos pasos alteran su base de datos y podrían destruirla. Así que asegúrese de hacer una copia de seguridad de su base de datos.
8. Puede configurar Part-DB a través de config/parameters.yaml . Debe verificar si la configuración coincide con sus expectativas después de instalar/actualizar Part-DB. Compruebe si partdb.default_currency coincide con su moneda utilizada principalmente (esto no se puede cambiar después de crear la información de precios). Ejecute php bin/console cache:clear cuando cambie algo.
9. Accede a Part-DB en tu navegador (bajo la URL que pongas) e inicia sesión con el usuario admin . La contraseña es la que se genera durante la configuración de la base de datos. Si no recuerda la contraseña, establezca una nueva con php bin/console app:set-password admin . Puede crear nuevos usuarios con el usuario administrador y comenzar a usar Part-DB.

Cuando desee actualizar a una versión más nueva, simplemente copie los archivos nuevos en la carpeta y repita los pasos 4 a 7.

Normalmente se genera una contraseña aleatoria cuando se crea el usuario administrador durante la creación inicial de la base de datos; sin embargo, puede establecer la contraseña de administrador inicial configurando la var de entorno INITIAL_ADMIN_PW .

Puede configurar Part-DB según sus necesidades cambiando las variables de entorno en el archivo .env.local . Consulte aquí para obtener más información.

proxy inverso

Si está utilizando un proxy inverso, debe asegurarse de que los servidores proxy configuren los encabezados X-Forwarded-* correctamente, o obtendrá una confusión HTTP/HTTPS y nombres de host incorrectos. Si el proxy inverso está en un servidor diferente (o no puede acceder a Part-DB a través del host local), debe configurar la variable de entorno TRUSTED_PROXIES para que coincida con la dirección IP (o bloque de IP) de su proxy inverso. Puede hacer esto en su .env.local o (cuando usa Docker) en su archivo docker-compose.yml .

Donar para el desarrollo

Si desea hacer una donación al desarrollador de Part-DB, consulte el botón de patrocinador en la barra superior (al lado del nombre del repositorio). Allí encontrará varios métodos para respaldar el desarrollo de forma mensual o única.

Construido con

• Symfony 5: el marco principal utilizado para PHP del lado del servidor
• Bootstrap 5 y Bootswatch: utilizados como tema del sitio web
• Fontawesome: utilizado como conjunto de iconos
• Hotwire Stimulus y Hotwire Turbo: Frontend Javascript

Autores

• Jan Böhmer - Trabajo inicial - GitHub

Vea también la lista de contribuyentes que participaron en este proyecto.

Basado en la Parte DB original de Christoph Lechner y K. Jacobs

Licencia

Part-DB tiene la licencia GNU Affero General Public License v3.0 (o, según su opinión, más adelante). Esto significa principalmente que puede usar Part-DB para lo que quiera (incluso usarlo comercialmente) siempre que publique también el código fuente de cada cambio que realice bajo la AGPL.

Consulte LICENCIA para obtener más información.