mirror/Part-DB.Part-DB-server
1
0
Fork 1
mirror of https://github.com/Part-DB/Part-DB-server.git synced 2025-06-20 17:15:51 +02:00
Code Issues Projects Releases Packages Wiki Activity Actions
Part-DB is an Open source inventory management system for your electronic components
434 commits 6 branches 60 tags 68 MiB
Find a file
Jan Böhmer 42b2c4f86e Ignore files in public/media/ folder
2019-10-13 13:41:44 +02:00
.github Delete main.workflow 2019-08-27 17:48:55 +02:00
assets Use bootstrap styles for markdown tables. 2019-10-12 19:03:50 +02:00
bin Use PHPUnit 7.5 for tests 2019-09-23 13:17:53 +02:00
config Added more features to CKeditor toolbar. 2019-10-12 18:53:15 +02:00
public Ignore files in public/media/ folder 2019-10-13 13:41:44 +02:00
src Filter attachment name for uploaded filename. 2019-10-13 13:41:20 +02:00
templates Show a hint if an attachment is secure. 2019-10-13 13:34:26 +02:00
tests Added an console command to convert the old BBCode comments to markdown 2019-10-13 00:32:09 +02:00
translations Added translations for permissions. 2019-09-10 23:28:08 +02:00
.env Fixed some 404 errors when using Part-DB without URL rewriting. 2019-10-03 00:45:02 +02:00
.env.test Initial commit 2019-02-23 16:49:38 +01:00
.gitignore Uploaded (non secure) attachments live now in public/ 2019-10-05 20:30:27 +02:00
.travis.yml Test against PHP 7.4 and PHP 8 snapshot. 2019-09-23 13:01:37 +02:00
.yarnclean Updated yarn dependencies... 2019-03-19 15:24:44 +01:00
CODE_OF_CONDUCT.md Added code of conduct. 2019-03-27 16:36:16 +01:00
composer.json Added an console command to convert the old BBCode comments to markdown 2019-10-13 00:32:09 +02:00
composer.lock Added an console command to convert the old BBCode comments to markdown 2019-10-13 00:32:09 +02:00
LICENSE.md Added License file 2019-02-23 22:43:14 +01:00
package.json Render markdown on the client side and use DOMPurify to prevent XSS., 2019-10-12 17:41:13 +02:00
phpunit.xml.dist Initial commit 2019-02-23 16:49:38 +01:00
Procfile Added procfile for heroku deployment. 2019-03-25 16:47:26 +01:00
psalm.xml Added psalm to dev dependencies. 2019-09-23 13:29:51 +02:00
README.md Update README.md 2019-08-15 18:13:00 +02:00
symfony.lock Added an console command to convert the old BBCode comments to markdown 2019-10-13 00:32:09 +02:00
VERSION Show the version number of Part-DB on homepage. 2019-03-12 13:34:33 +01:00
webpack.config.js Added simple single page ajax handling for a links. 2019-03-24 19:55:39 +01:00
yarn.lock Render markdown on the client side and use DOMPurify to prevent XSS., 2019-10-12 17:41:13 +02:00

README.md

Scrutinizer Code Quality Build Status

Part-DB

Part-DB is an Open-Source inventory managment system for your electronic components. It is installed on a web server and so can be accessed with any browser without the need to install additional software.

The version in this Repository is a complete rewrite of the legacy Part-DB (Version < 1.0) based on a modern framework. In the moment it lacks many features from the old Part-DB and the testing and documentation is not finished, so this version is not recommendend for productive work!!

Demo

If you want to test Part-DB without installing it, you can use this Heroku instance. (Or this link for the German Version).

You can log in with username: user and password: user.

Every change to the master branch gets automatically deployed, so it represents the currenct development progress and is maybe not completly stable. Please mind, that the free Heroku instance is used, so it can take some time when loading the page for the first time.

Features

  • TODO

Requirements

  • A web server (like Apache2 or nginx) that is capable of running Symfony 4, this includes a minimum PHP version of PHP 7.1.3
  • A MySQL/MariaDB database server
  • Shell access to your server is highly suggested!
  • For building the client side assets yarn and nodejs is needed.

Installation

Caution: It is possible to upgrade the old Part-DB databases. Anyhow, the migrations that will be made, are not compatible with the old Part-DB versions, so you must not use the old Part-DB versions with the new database, or the DB could become corrupted. Also after the migration it is not possible to go back to the old database scheme, so make sure to make a backup of your database beforehand.

  1. Copy or clone this repository into a folder on your server.
  2. Configure your webserver to serve from the public/ folder. See here for additional informations.
  3. Copy the global config file cp .env .env.local and edit .env.local:
    • Change the line APP_ENV=dev to APP_ENV=prod
    • Change the value of DATABASE_URL= to your needs (see here) for the format.
  4. Install composer dependencies and generate autoload files: composer install --no-dev
  5. Install client side dependencies and build it: yarn install and yarn build
  6. Optional (speeds up first load): Warmup cache: php bin/console cache:warmup
  7. Upgrade database to new scheme (or create it, when it was empty): php bin/console doctrine:migrations:migrate and follow the instructions given. Caution: This steps tamper with your database and could potentially destroy it. So make sure to make a backup of your database.

When you want to upgrade to a newer version, then just copy the new files into the folder and repeat the steps 4. to 7.

Built with

Authors

  • Jan Böhmer - Inital work - Github

See also the list of contributors who participated in this project.

Based on the original Part-DB by Christoph Lechner and K. Jacobs

License

Part-DB is licensed under the General Public License 2 (or at your opinion any later). This mostly means that you can use Part-DB for whatever you want (even use it commercially) as long as you publish the source code for every change you make under the GPL, too.

See License.md for more informations.