Part DB server

문서 | 데모 | 도커 이미지

부분DB

Part-DB는 전자 부품을 위한 오픈 소스 재고 관리 시스템입니다. 웹 서버에 설치되므로 추가 소프트웨어를 설치할 필요 없이 모든 브라우저에서 액세스할 수 있습니다.

이 저장소의 버전은 최신 프레임워크를 기반으로 레거시 Part-DB(버전 < 1.0)를 완전히 재작성한 것으로 사용을 권장하는 버전입니다.

버그를 발견하면 GitHub에서 문제를 열어서 모두가 수정할 수 있도록 해주세요.

데모

Part-DB를 설치하지 않고 테스트하고 싶다면 이 Heroku 인스턴스를 사용하면 됩니다. (또는 독일어 버전의 경우 이 링크).

사용자 이름: user 및 비밀번호: user 로 로그인할 수 있습니다.

마스터 브랜치에 대한 모든 변경 사항은 자동으로 배포되므로 현재 개발 진행 상황을 나타내며 완전히 안정적이지 않을 수 있습니다. 무료 Heroku 인스턴스를 사용하므로 처음 페이지를 로드할 때 다소 시간이 걸릴 수 있다는 점을 염두에 두시기 바랍니다.

특징

• 전자 부품의 재고 관리. 각 부품은 카테고리, 면적, 제조업체, 여러 매장 위치 및 가격 정보에 할당될 수 있습니다. 태그를 사용하여 부품을 그룹화할 수 있습니다. 데이터시트나 사진과 같은 다양한 파일을 부품과 연결할 수 있습니다.
• 다중 언어 지원(현재 독일어, 영어, 러시아어, 일본어, 프랑스어, 체코어, 덴마크어, 중국어)
• 부품 및 보관 위치에 대한 바코드/라벨 생성기, 내장된 바코드 스캐너를 사용하여 웹캠을 통해 바코드 스캔
• 그룹 및 세부적인(세분화된) 권한이 있는 사용자 시스템입니다. 2단계 인증(Google Authenticator 및 Webauthn/U2F 키)이 지원되며 그룹에 적용할 수 있습니다. 이메일을 통한 비밀번호 재설정을 설정할 수 있습니다.
• SAML을 통한 SSO(Single Sign-On)에 대한 선택적 지원(Keycloak과 같은 중간 서비스를 사용하면 Part-DB를 기존 LDAP 또는 Active Directory 서버에 연결할 수 있음)
• 부품 및 데이터 구조에 대한 가져오기/내보내기 시스템입니다. KiCAD에서 프로젝트에 대한 BOM 가져오기가 지원됩니다.
• 프로젝트 관리: 프로젝트를 생성하고 BOM(Bill of Material)에 부품을 할당하여 이 프로젝트를 얼마나 자주 빌드할 수 있는지 보여주고 DB에서 필요한 모든 구성 요소를 직접 인출할 수 있습니다.
• 이벤트 로그: 인벤토리에 어떤 변화가 발생하는지 추적하고, 어떤 사용자가 무엇을 하는지 추적합니다. 부품을 이전 버전으로 되돌리세요.
• 반응형 디자인: 동일한 인터페이스를 사용하여 PC, 태블릿, 스마트폰에서 Part-DB를 사용할 수 있습니다.
• MySQL, SQLite 및 PostgreSQL은 데이터베이스 백엔드로 지원됩니다.
• 부품의 서식 있는 텍스트 설명 및 주석 지원
• 여러 통화 지원 및 환율 자동 업데이트 지원
• 파라메트릭 검색(일부 사양에 따른 부품 검색)을 포함한 강력한 검색 및 필터 기능
• 사진의 자동 썸네일 생성
• 클라우드 제공업체(예: Octopart, Digikey, Farnell, LCSC 또는 TME)를 사용하여 부품 정보, 데이터시트 및 부품 가격을 자동으로 가져옵니다.
• 다른 애플리케이션/스크립트에서 Part-DB에 액세스하기 위한 API
• KiCad와의 통합: Part-DB를 KiCad의 중앙 데이터 소스로 사용하고 KiCad 내에서 직접 Part-DB의 사용 가능한 부품을 확인하세요.

이러한 기능을 갖춘 Part-DB는 개인 전자 부품 재고 또는 많은 사용자가 공유 재고에 대한 액세스를 제어해야 하는 제작자 공간을 추적하려는 애호가에게 유용합니다.

Part-DB는 중소기업이나 대학에서도 재고 관리를 위해 사용됩니다.

요구사항

• Symfony 6을 실행할 수 있는 웹 서버 (예: Apache2 또는 nginx)에는 PHP 8.1 의 최소 PHP 버전이 포함됩니다.
• MySQL (5.7 이상) / MariaDB (10.4 이상) 데이터베이스 서버 또는 SQLite를 사용하지 않으려는 경우 PostgreSQL 10+.
• 서버에 대한 쉘 액세스를 적극 권장합니다!
• 클라이언트 측 자산을 구축하려면 Yarn 및 nodejs (>= 18.0)가 필요합니다.

설치

Part-DB의 레거시(< 1.0.0) 버전을 이 버전으로 업그레이드하려면 먼저 이 내용을 읽어 보십시오.

힌트: docker 이미지는 jbtronics/part-db1에서 사용할 수 있습니다. docker를 통해 Part-DB를 설정하는 방법은 여기에 설명되어 있습니다.

아래에서는 설치 프로세스에 대한 대략적인 개요를 찾을 수 있습니다. Part-DB 설치 방법에 대한 자세한 지침은 여기를 참조하세요.

1. 이 저장소를 서버의 폴더에 복사하거나 복제하세요.
2. public/ 폴더에서 서비스를 제공하도록 웹 서버를 구성하십시오. 추가 정보는 여기를 참조하세요.
3. 전역 구성 파일 cp .env .env.local 을 복사하고 .env.local 편집합니다.
   • APP_ENV=dev 행을 APP_ENV=prod 로 변경합니다.
   • SQLite를 사용하지 않으려면 DATABASE_URL= 값을 필요에 따라 형식으로 변경하세요(여기 참조). 동시 액세스가 가능한 대규모 인스턴스에서는 MySQL이 더 성능이 좋습니다. 나중에 쉽게 변경할 수 없으므로 현명하게 선택하세요.
4. 작곡가 종속 항목 설치 및 자동 로드 파일 생성: composer install -o --no-dev
5. 클라이언트 측 종속성을 설치하고 빌드합니다: yarn install 및 yarn build
6. 선택 사항 (첫 번째 로드 속도 향상): Warmup 캐시: php bin/console cache:warmup
7. 데이터베이스를 새 구성표로 업그레이드하십시오(또는 비어 있을 경우 생성하십시오): php bin/console doctrine:migrations:migrate 제공된 지침을 따르십시오. 이 과정에서 관리자의 비밀번호는 사용자입니다. 복사하세요. 주의 : 이러한 단계는 데이터베이스를 변조하고 잠재적으로 데이터베이스를 파괴할 수 있습니다. 따라서 데이터베이스를 백업해두시기 바랍니다.
8. config/parameters.yaml 통해 Part-DB를 구성할 수 있습니다. Part-DB를 설치/업그레이드한 후 설정이 기대한 것과 일치하는지 확인해야 합니다. partdb.default_currency 주로 사용하는 통화와 일치하는지 확인하세요. (가격 정보 생성 후에는 변경할 수 없습니다.) 무언가를 변경할 때 php bin/console cache:clear 실행하세요.
9. 브라우저에서(입력한 URL 아래) Part-DB에 액세스하고 사용자 admin 으로 로그인합니다. 비밀번호는 DB 설정 시 출력되는 비밀번호입니다. 비밀번호가 기억나지 않으면 php bin/console app:set-password admin 으로 새 비밀번호를 설정하세요. 관리자로 새 사용자를 생성하고 Part-DB 사용을 시작할 수 있습니다.

최신 버전으로 업그레이드하려면 새 파일을 폴더에 복사하고 4~7단계를 반복하세요.

일반적으로 초기 데이터베이스 생성 중에 관리자가 생성되면 임의의 비밀번호가 생성되지만 INITIAL_ADMIN_PW env var를 설정하여 초기 관리자 비밀번호를 설정할 수 있습니다.

.env.local 파일에서 환경 변수를 변경하여 필요에 맞게 Part-DB를 구성할 수 있습니다. 자세한 내용은 여기를 참조하세요.

역방향 프록시

역방향 프록시를 사용하는 경우 프록시가 X-Forwarded-* 헤더를 올바르게 설정했는지 확인해야 합니다. 그렇지 않으면 HTTP/HTTPS 혼합 및 잘못된 호스트 이름이 발생합니다. 역방향 프록시가 다른 서버에 있는 경우(또는 로컬 호스트를 통해 Part-DB에 액세스할 수 없는 경우) 역방향 프록시의 IP 주소(또는 IP 블록)와 일치하도록 TRUSTED_PROXIES 환경 변수를 설정해야 합니다. .env.local 또는 (docker를 사용하는 경우) docker-compose.yml 파일에서 이 작업을 수행할 수 있습니다.

개발을 위해 기부하세요

Part-DB 개발자에게 기부하고 싶다면 상단 바(repo 이름 옆)에 있는 후원 버튼을 확인하세요. 여기서는 월간 또는 일회성 개발을 지원하는 다양한 방법을 찾을 수 있습니다.

다음으로 제작됨

• Symfony 5: 서버사이드 PHP에 사용되는 주요 프레임워크
• Bootstrap 5 및 Bootswatch: 웹사이트 테마로 사용됨
• Fontawesome: 아이콘 세트로 사용됨
• Hotwire Stimulus 및 Hotwire Turbo: 프론트엔드 자바스크립트

저자

• Jan Böhmer - 초기 작업 - GitHub

이 프로젝트에 참여한 기여자 목록도 참조하세요.

Christoph Lechner와 K. Jacobs의 원본 Part-DB를 기반으로 합니다.

특허

Part-DB는 GNU Affero General Public License v3.0(또는 향후 귀하의 의견에 따라)에 따라 라이센스가 부여됩니다. 이는 AGPL에 따라 변경하는 모든 사항에 대한 소스 코드를 게시하는 한 원하는 대로 Part-DB를 사용할 수 있음을 의미합니다(상업적으로도 사용할 수 있음).

자세한 내용은 라이센스를 참조하세요.