berkutta/parts_manager

Parts Manager

镜像概述和主要用途

Parts Manager 是一款用于管理（电子）零件的小型工具，提供简单直观的零件管理方式。它支持存储位置管理以及与这些位置关联的组件，组件条目包含多种规格信息（如类别、数据手册链接、供应商等），并可设置为可计数（带库存值）或不可计数模式。

核心功能和特性

• 存储位置管理：支持创建和管理多个零件存储位置
• 组件管理：为每个组件记录详细规格，包括类别、数据手册超链接、供应商等信息
• 库存计数：组件可设置为可计数（跟踪库存数量）或不可计数模式
• 基础插件系统：支持添加自定义UI按钮，实现如零件盒照明控制等扩展功能

使用场景和适用范围

适用于电子爱好者、工程师或需要管理小型零件库存的个人/团队，尤其适合需要简单追踪零件存储位置和库存状态的场景。

使用方法和配置说明

Docker部署

基本运行命令

使用Docker快速部署，只需执行以下命令：

bash
docker run -v /my/path/.env:/var/www/html/.env -p 80:80 berkutta/parts_manager

配置文件(.env)设置

推荐的.env配置文件内容如下，需根据实际MySQL设置修改数据库凭证：

APP_KEY=base64:MGrJqE4HL/BZwwDPrxHarRJvJvj6SU1vz1D0oide7i8=

DB_CONNECTION=mysql
DB_HOST=host
DB_PORT=3306
DB_DATABASE=db
DB_USERNAME=user
DB_PASSWORD=pass

初始化设置

1. 生成新App Key
   首次运行后，建议生成新的App Key。进入容器bash控制台并执行：

   bash
   php artisan key:generate
   

2. 创建管理员用户
   进入容器bash控制台，启动Laravel Tinker：

   bash
   php artisan tinker
   

   在Tinker控制台中执行以下命令创建用户（根据需求修改参数）：

   php
   $user = new App\User();
   $user->username = 'username';
   $user->password = Hash::make('the-password-of-choice');
   $user->name = 'name';
   $user->email = 'the-email@example.com';
   $user->save();
   

自动更新建议

推荐使用watchtower工具实现容器自动更新，它会每5分钟检查Docker Hub上的镜像更新并自动重启容器：
https://github.com/v2tec/watchtower

插件系统

提供基础插件系统，支持在UI中添加自定义按钮，可实现如控制零件盒照明等功能。

开发历史

• 2015年：项目启动，初始版本代码质量较低（开发者当时对PHP和Web技术了解有限）
• 2018年初：实现基础API，基于原有数据库访问代码添加简单的模式切换
• 2018年底：为适配Docker部署进行优化，提升软件可用性
• 2019年初：重构为Laravel PHP框架，使软件达到可用状态