Part DB server

Dokumentasi | Demo | Gambar Docker

Bagian-DB

Part-DB adalah sistem manajemen inventaris Sumber Terbuka untuk komponen elektronik Anda. Itu diinstal pada server web sehingga dapat diakses dengan browser apa pun tanpa perlu menginstal perangkat lunak tambahan.

Versi dalam repositori ini adalah penulisan ulang lengkap Part-DB lama (Versi <1.0) berdasarkan kerangka kerja modern dan merupakan versi yang direkomendasikan untuk digunakan.

Jika Anda menemukan bug, silakan buka Masalah di GitHub, sehingga dapat diperbaiki untuk semua orang.

Demo

Jika Anda ingin menguji Part-DB tanpa menginstalnya, Anda dapat menggunakan instance Heroku ini. (Atau tautan ini untuk Versi Jerman).

Anda dapat masuk dengan nama pengguna: pengguna dan kata sandi: pengguna .

Setiap perubahan pada cabang master diterapkan secara otomatis, sehingga mewakili kemajuan pengembangan saat ini dan mungkin tidak sepenuhnya stabil. Harap diingat, bahwa contoh Heroku gratis digunakan, sehingga mungkin memerlukan waktu saat memuat halaman untuk pertama kalinya.

Fitur

• Manajemen inventaris komponen elektronik Anda. Setiap bagian dapat ditetapkan ke kategori, lokasi, produsen, dan beberapa lokasi toko serta informasi harga. Bagian dapat dikelompokkan menggunakan tag. Anda dapat mengaitkan berbagai file seperti lembar data atau gambar dengan bagian-bagiannya.
• Dukungan multi-bahasa (saat ini Jerman, Inggris, Rusia, Jepang, Prancis, Ceko, Denmark, dan Cina)
• Generator Barcode/Label untuk suku cadang dan lokasi penyimpanan, pindai kode batang melalui webcam menggunakan pemindai kode batang bawaan
• Sistem pengguna dengan grup dan izin terperinci (granular halus). Otentikasi dua faktor didukung (kunci Google Authenticator dan Webauthn/U2F) dan dapat diterapkan untuk grup. Reset kata sandi melalui email dapat diatur.
• Dukungan opsional untuk sistem masuk tunggal (SSO) melalui SAML (menggunakan layanan perantara seperti Keycloak, Anda dapat menyambungkan Part-DB ke server LDAP atau Direktori Aktif yang ada)
• Sistem Impor/Ekspor untuk suku cadang dan struktur data. Impor BOM untuk proyek dari KiCAD didukung.
• Manajemen proyek: Buat proyek dan tetapkan bagian-bagiannya ke bill of material (BOM), untuk menunjukkan seberapa sering Anda dapat membangun proyek ini dan secara langsung menarik semua komponen yang dibutuhkan dari DB
• Log peristiwa: Lacak perubahan apa yang terjadi pada inventaris Anda, lacak pengguna mana yang melakukan apa. Kembalikan komponen Anda ke versi yang lebih lama.
• Desain responsif: Anda dapat menggunakan Part-DB di PC, tablet, dan ponsel cerdas Anda menggunakan antarmuka yang sama.
• MySQL, SQLite dan PostgreSQL didukung sebagai backend database
• Dukungan untuk deskripsi teks kaya dan komentar di beberapa bagian
• Dukungan untuk berbagai mata uang dan pembaruan otomatis nilai tukar didukung
• Fungsi pencarian dan filter yang kuat, termasuk pencarian parametrik (mencari bagian berdasarkan beberapa spesifikasi)
• Pembuatan thumbnail otomatis untuk gambar
• Gunakan penyedia cloud (seperti Octopart, Digikey, Farnell, LCSC, atau TME) untuk secara otomatis mendapatkan informasi suku cadang, lembar data, dan harga suku cadang
• API untuk mengakses Part-DB dari aplikasi/skrip lain
• Integrasi dengan KiCad: Gunakan Part-DB sebagai sumber data pusat untuk KiCad Anda dan lihat komponen yang tersedia dari Part-DB langsung di dalam KiCad.

Dengan fitur-fitur ini, Part-DB berguna bagi para penghobi, yang ingin melacak inventaris komponen elektronik pribadi mereka, atau ruang pembuat, di mana banyak pengguna harus memiliki (mengendalikan) akses ke inventaris bersama.

Part-DB juga digunakan oleh perusahaan kecil dan universitas untuk mengelola inventaris mereka.

Persyaratan

• Server web (seperti Apache2 atau nginx) yang mampu menjalankan Symfony 6, ini mencakup versi PHP minimum PHP 8.1
• Server database MySQL (minimal 5.7) / MariaDB (minimal 10.4), atau PostgreSQL 10+ jika Anda tidak ingin menggunakan SQLite.
• Akses shell ke server Anda sangat disarankan!
• Untuk membangun aset sisi klien , benang dan nodejs (>= 18.0) diperlukan.

Instalasi

Jika Anda ingin memutakhirkan Part-DB versi lama (<1.0.0) ke versi ini, harap baca ini terlebih dahulu.

Petunjuk: Gambar buruh pelabuhan tersedia di jbtronics/part-db1. Cara mengatur Part-DB melalui buruh pelabuhan dijelaskan di sini.

Di bawah ini Anda menemukan gambaran kasar proses instalasi, lihat di sini untuk panduan rinci tentang cara menginstal Part-DB.

1. Salin atau klon repositori ini ke dalam folder di server Anda.
2. Konfigurasikan server web Anda untuk melayani dari folder public/ . Lihat di sini untuk informasi tambahan.
3. Salin file konfigurasi global cp .env .env.local dan edit .env.local :
   • Ubah baris APP_ENV=dev menjadi APP_ENV=prod
   • Jika Anda tidak ingin menggunakan SQLite, ubah nilai DATABASE_URL= sesuai kebutuhan Anda (lihat di sini) untuk formatnya. Dalam kasus yang lebih besar dengan akses bersamaan, MySQL lebih berperforma. Ini tidak bisa diubah dengan mudah nantinya, jadi pilihlah dengan bijak.
4. Instal dependensi komposer dan hasilkan file muat otomatis: composer install -o --no-dev
5. Instal dependensi sisi klien dan bangunlah: yarn install dan yarn build
6. Opsional (mempercepat pemuatan pertama): Cache pemanasan: php bin/console cache:warmup
7. Tingkatkan basis data ke skema baru (atau buat, saat kosong): php bin/console doctrine:migrations:migrate dan ikuti instruksi yang diberikan. Selama proses, kata sandi untuk admin adalah pengguna ditampilkan. Salin itu. Perhatian : Langkah-langkah ini merusak database Anda dan berpotensi menghancurkannya. Jadi pastikan untuk membuat cadangan database Anda.
8. Anda dapat mengonfigurasi Part-DB melalui config/parameters.yaml . Anda harus memeriksa apakah pengaturan sesuai dengan harapan Anda setelah Anda menginstal/meningkatkan Part-DB. Periksa apakah partdb.default_currency cocok dengan mata uang yang paling sering Anda gunakan (ini tidak dapat diubah setelah membuat informasi harga). Jalankan php bin/console cache:clear ketika Anda mengubah sesuatu.
9. Akses Part-DB di browser Anda (di bawah URL yang Anda masukkan) dan masuk dengan pengguna admin . Kata sandi adalah yang dikeluarkan selama pengaturan DB. Jika Anda tidak dapat mengingat kata sandinya, buat kata sandi baru dengan php bin/console app:set-password admin . Anda dapat membuat pengguna baru dengan pengguna admin dan mulai menggunakan Part-DB.

Bila ingin mengupgrade ke versi yang lebih baru, maka copy saja file baru tersebut ke dalam folder dan ulangi langkah 4. hingga 7.

Biasanya kata sandi acak dihasilkan ketika pengguna admin dibuat selama pembuatan database awal, namun, Anda dapat mengatur kata sandi admin awal, dengan mengatur INITIAL_ADMIN_PW env var.

Anda dapat mengonfigurasi Part-DB sesuai kebutuhan Anda dengan mengubah variabel lingkungan di file .env.local . Lihat di sini untuk informasi lebih lanjut.

Proksi terbalik

Jika Anda menggunakan proxy terbalik, Anda harus memastikan bahwa proxy tersebut menyetel header X-Forwarded-* dengan benar, atau Anda akan mendapatkan kesalahan HTTP/HTTPS dan nama host yang salah. Jika proksi terbalik berada di server yang berbeda (atau tidak dapat mengakses Part-DB melalui localhost), Anda harus mengatur variabel env TRUSTED_PROXIES agar sesuai dengan alamat IP (atau blok IP) proksi terbalik Anda. Anda dapat melakukan ini di .env.local atau (saat menggunakan buruh pelabuhan) di file docker-compose.yml Anda.

Donasi untuk pembangunan

Jika Anda ingin berdonasi ke pengembang Part-DB, lihat tombol sponsor di bilah atas (di sebelah nama repo). Di sana Anda akan menemukan berbagai metode untuk mendukung pengembangan secara bulanan atau satu kali.

Dibangun dengan

• Symfony 5: Kerangka utama yang digunakan untuk PHP sisi server
• Bootstrap 5 dan Bootswatch: Digunakan sebagai tema situs web
• Fontawesome: Digunakan sebagai kumpulan ikon
• Stimulus Hotwire dan Hotwire Turbo: Javascript Frontend

Penulis

• Jan Böhmer - Pekerjaan awal - GitHub

Lihat juga daftar kontributor yang berpartisipasi dalam proyek ini.

Berdasarkan Part-DB asli oleh Christoph Lechner dan K. Jacobs

Lisensi

Part-DB dilisensikan di bawah GNU Affero General Public License v3.0 (atau menurut pendapat Anda nanti). Ini sebagian besar berarti bahwa Anda dapat menggunakan Part-DB untuk apa pun yang Anda inginkan (bahkan menggunakannya secara komersial) selama Anda juga mempublikasikan kode sumber untuk setiap perubahan yang Anda buat berdasarkan AGPL.

Lihat LISENSI untuk informasi lebih lanjut.