grocy 다운로드 - grocy 소스 코드 다운로드

냉장고 너머의 ERP

Grocy는 웹 기반 자체 호스팅 식료품 및 가정 관리 솔루션입니다.

Bernd Bestel의 취미 프로젝트입니다.

한번 시도해 보세요

최신 안정 버전의 공개 데모( release 브랜치) → https://demo.grocy.info
현재 개발 버전의 공개 데모( master 브랜치) → https://demo-prerelease.grocy.info

특징

웹사이트를 참조하세요. → https://grocy.info

질문/도움말/버그 보고서/기능 요청

일반적인 도움말 및 사용법 질문 → r/grocy 하위 레딧
버그 신고 및 기능 요청 → 이슈 트래커

Grocy에 관해 나에게 개인 메시지를 보내거나 전화하지 마세요. 저는 이슈 트래커와 하위 레딧을 거의 매일 확인하지만 그 이상의 지원은 제공하지 않습니다.

지역사회 기여

커뮤니티에서 제공한 추가 기능/도구 목록은 웹사이트를 참조하세요. → https://grocy.info/addons

설치 방법

일반 (Windows) 데스크톱 애플리케이션처럼 웹 서버를 관리할 필요 없이 Grocy를 실행하려면 Grocy Desktop을 확인하세요.
최신 릴리스를 직접 다운로드하십시오. "다음"을 2번만 클릭하면 설치가 완료됩니다.

Grocy는 기술적으로 매우 간단한 PHP 애플리케이션이므로 이를 실행하는 데 필요한 기본 사항은 다음과 같습니다.

최신 릴리스 압축 풀기
config-dist.php data/config.php 에 복사하고 필요에 따라 편집하세요.
data 디렉터리가 쓰기 가능한지 확인하세요.
웹서버 루트는 public 디렉토리를 가리켜야 합니다.
try_files $uri /index.php$is_args$query_string; nginx를 사용하는 경우 위치 블록에
또는 URL 재작성을 비활성화합니다( data/config.php 의 DISABLE_URL_REWRITING 옵션 참조).
→ 기본 로그인은 사용자 admin 이고 비밀번호는 admin 입니다. 즉시 비밀번호를 변경하시기 바랍니다(오른쪽 상단의 사용자 메뉴)

또는 이 리포지토리를 복제하고( release 분기는 항상 최신 릴리스 버전을 참조함) Composer 및 Yarn 종속성을 수동으로 설치합니다.

추가 설치 가이드와 문제 해결 도움말을 보려면 웹사이트를 참조하세요. → https://grocy.info/links

플랫폼 지원

PHP 8.2 또는 8.3(SQLite 3.34.0+ 포함)
필수 PHP 확장: fileinfo , pdo_sqlite , gd , ctype , intl , zlib , mbstring
권장사항: 벤치마크 테스트에서는 최신(3.39.4+) SQLite 버전을 사용할 때 단위 변환 처리가 최대 5배 더 빠른 것으로 나타났습니다.
최신 Firefox, Chrome 또는 Edge

Docker를 사용하여 실행하는 방법

지침은 grocy/grocy-docker 또는 linuxserver/docker-grocy를 참조하세요.

업데이트 방법

data 디렉토리를 유지하면서 최신 릴리스로 모든 것을 덮어씁니다.
config-dist.php 새로운 구성 옵션을 확인하고 해당 옵션을 data/config.php 에 추가하세요( config-dist.php 의 기본값은 data/config.php 정의 설정이 아닌 경우에 사용됩니다).
data/viewcache 디렉토리를 비우세요
데이터베이스 마이그레이션을 적용하려면 기본 경로를 한 번 방문하십시오(아래 참조).

Linux에서 Grocy를 실행하는 경우 정확히 이 작업을 수행하고 추가적으로 백업( .tgz 아카이브)을 생성하는 update.sh 도 있습니다(스크립트를 실행 가능하게 만들고( chmod +x update.sh ) unzip 설치되어 있는지 확인하세요). data/backups 의 현재 설치(60일보다 오래된 백업은 업데이트 중에 삭제됩니다).

현지화

Grocy는 완전히 현지화 가능합니다. 기본 언어는 영어(코드에 통합됨)이고, 독일어 현지화는 항상 제가 관리합니다.

귀하의 언어가 불완전하거나 아직 사용할 수 없는 경우 Transifex에서 Grocy 번역을 쉽게 도울 수 있습니다.

기본 언어는 data/config.php 에서 설정할 수 있습니다. 예: Setting('DEFAULT_LOCALE', 'it'); 사용자마다 다른 언어를 설정하는 사용자 설정(사용자 설정 페이지 참조)도 있습니다.

사전 출시 데모는 70% 이상 완료된 모든 번역에 사용할 수 있으며 매 시간 10분마다 Transifex에서 번역을 가져오므로 기여한 번역을 즉시 미리 볼 수 있습니다. 감사합니다!

또한 완료 수준 70%( strings 리소스)에 도달한 모든 번역이 릴리스에 포함됩니다.

안타깝게도 RTL 언어는 아직 지원되지 않습니다.

동기 부여

가정은 관리되어야 합니다. Grocy 이전에는 처음으로 직접 작성한 소프트웨어(C# Windows 양식 응용 프로그램)와 여러 Excel 시트를 사용하여 이 작업을 거의 10년 동안 수행했습니다. 소프트웨어는 결국 사용하기가 어려웠고 Excel은 Excel입니다. 그래서 (아주) 오랫동안 다양한 것들을 찾아보고 시도했지만 100% 맞는 것은 없었기 때문에 이것이 "완전한 집안 관리"에 대한 나의 목표입니다. 냉장고를 ERP하세요!

알아야 할 가치가 있는 것들

REST API

/api의 통합 Swagger UI 인스턴스를 참조하세요.

웹 프론트엔드는 거의 모든 것에 정확히 이 API를 사용합니다. 따라서 여기서 할 수 있는 모든 작업은 API를 통해서도 가능합니다.

바코드 판독기 및 카메라 스캐닝

일부 필드(위의 바코드 아이콘 포함)에서는 바코드를 스캔하여 값을 선택할 수도 있습니다. 바코드 판독기가 모든 바코드 앞에 일반적으로 항목 이름의 일부가 아닌 문자( $ 사용)를 붙이고 스캔 후 TAB 을 보낼 때 가장 잘 작동합니다.

또한 해당 필드 오른쪽에 있는 카메라 버튼을 사용하여 장치 카메라를 사용하여 바코드를 스캔할 수도 있습니다(Quagga2에서 제공, 완전히 오프라인/클라이언트 측 카메라 스트림 처리, 브라우저 보안 제한으로 인해 주의하세요). 보안 연결( https:// )을 통해 Grocy를 제공할 때만 작동합니다. 빠른 비디오 데모: https://www.youtube.com/watch?v=Y5YH6IJFnfc

개인적인 추천: USB 바코드 레이저 스캐너를 사용하세요. 가격이 저렴하고 어떤 조명 조건이나 어떤 각도에서도 1000% 더 좋고 더 빠르게 작동합니다.

날짜 필드에 대한 단축어 입력

(생산성) 이유로 모든 날짜(및 시간) 입력(및 표시) 필드는 현지화에 관계없이 ISO-8601 형식을 사용합니다. 다음과 같은 단축어를 사용할 수 있습니다.

MMDD > 오늘인 경우 올해의 특정 날짜로 확장되고 < 오늘인 경우 내년의 특정 날짜로 확장됩니다.
예: 0517 2024-05-17 로 변환됩니다.
YYYYMMDD 적절한 ISO-8601 표기법으로 확장됩니다.
예: 20240417 2024-04-17 로 변환됩니다.
YYYYMMe 또는 YYYYMM+ 적절한 표기법으로 해당 연도의 해당 월 말까지 확장됩니다.
예: 202407e 2024-07-31 로 변환됩니다.
[+/-]n[d/m/y] 일 / 월 / 년의 수 를 적절한 표기법으로 더하거나 빼( - )면서 오늘을 기준으로 한 날짜로 확장됩니다.
예: +1m 다음 달 같은 날로 변환됩니다.
x 2999-12-31 로 확장됩니다("never overdue"의 별칭).
아래쪽/위쪽 화살표 키를 누르면 날짜가 1일씩 증가/감소됩니다.
오른쪽/왼쪽 화살표 키를 누르면 날짜가 1주 단위로 증가/감소됩니다.
Shift + 아래쪽/위쪽 화살표 키를 누르면 날짜가 1개월씩 증가/감소됩니다.
Shift + 오른쪽/왼쪽 화살표 키를 누르면 날짜가 1년씩 증가/감소됩니다.

버튼에 대한 키보드 속기

버튼에 굵게 강조 표시된 문자가 포함되어 있는 경우 이는 바로 가기 키입니다. 예: 키보드의 P 키를 사용하여 " P 새 제품으로 추가" 버튼을 "누를" 수 있습니다.

외부 서비스를 통한 바코드 조회

바코드를 통해 외부 서비스와 대조하여 제품을 데이터베이스에 직접 추가할 수 있습니다.

이 작업은 제품 선택기 워크플로 "외부 바코드 조회(플러그인을 통해)"를 사용하여 현장에서 수행할 수 있습니다(제품 입력 필드에 알 수 없는 내용을 입력하면 워크플로 대화 상자가 표시됨).

어떤 서비스에도 플러그인이 포함되어 있지 않습니다. data/plugins/DemoBarcodeLookupPlugin.php 의 참조 구현을 확인하세요.

데이터베이스 마이그레이션

데이터베이스 스키마 마이그레이션은 루트( / ) 경로 방문 시 자동으로 수행됩니다. (왼쪽 상단 로고 클릭)

참고: 데이터베이스 마이그레이션은 모든 커밋이 아닌 릴리스 간에 작동해야 합니다. 현재 master 브랜치(개발 버전)를 실행하려면 해당 브랜치(및 그 이상)를 직접 처리해야 합니다.

특정 기능 비활성화

Grocy의 특정 기능 세트를 사용하지 않는 경우(예를 들어 "집안일"이 필요하지 않은 경우) 관련 UI 요소를 숨기거나 비활성화하도록 설정된 주요 기능별 기능 플래그가 있습니다( config-dist.php 참조).

애플리케이션 자체를 수정할 필요 없이 자신만의 CSS 또는 JS 추가

data/custom_js.html 파일이 존재하면 모든 페이지의 </body> (본문 끝) 바로 앞에 파일 내용이 추가됩니다.
data/custom_css.html 파일이 존재하면 모든 페이지의 </head> (head 끝) 바로 앞에 파일 내용이 추가됩니다.

데모 모드

MODE 설정이 dev , demo 또는 prerelease 로 설정된 경우 애플리케이션은 인증이 비활성화되고 일부 데모 데이터가 데이터베이스 스키마 마이그레이션 중에 생성됨을 의미하는 데모 모드에서 작동합니다(쿼리 매개변수 nodemodata 전달, 예 https://grocy.example.com/?nodemodata 건너뛰세요).