Question 1

Docker에서 InvoiceShelf 정기 인보이스가 생성되지 않는 이유는 무엇이며, scheduler를 어떻게 수정하나요?

Accepted Answer

InvoiceShelf Docker 이미지 v2.4.2(및 영향을 받는 3.x 이미지)에서는 Nginx와 PHP-FPM만 실행됩니다. php artisan schedule:run을 실행하는 프로세스가 없으므로 반복 청구서, 연체 업데이트, 견적 만료가 전혀 실행되지 않습니다. 다음을 실행하여 확인하세요:

docker exec -u www-data <container> php artisan schedule:run

누락된 작업이 즉시 실행되면, 동일한 이미지, 환경, 네트워크, 볼륨을 사용하는 전용 스케줄러 컨테이너를 추가하세요:

scheduler:
  image: invoiceshelf/invoiceshelf:2.4.2
  command: php artisan schedule:work
  restart: unless-stopped
  env_file: .env
  volumes:
    - .:/var/www/html
  networks:
    - invoiceshelf

그런 다음 docker compose up -d scheduler를 실행하세요. 호스트 수준의 임시

Question 2

소수점 환율로 견적을 저장할 때 발생하는 PostgreSQL "invalid input syntax for type bigint" 오류를 어떻게 수정하나요?

Accepted Answer

이 문제는 PostgreSQL에서 발생합니다. 소수 환율이 120001.65606과 같은 분수 회사 통화 금액을 생성하고, 이 값이 base_total 같은 BIGINT 최소 단위 컬럼에 기록되기 때문입니다. 정수 환율은 분수 값을 생성하지 않으므로 정상 작동합니다.

수정 사항은 InvoiceShelf 2.x의 PR #861 및 3.x의 PR #862에 병합되었습니다. 패치된 2.x 또는 3.x 릴리스로 업그레이드한 다음 업데이트된 코드를 배포하세요:

composer install --no-dev
php artisan migrate
php artisan optimize:clear

exchange_rate 컬럼을 변경할 필요는 없습니다. 환율은 예를 들어 11.257191처럼 소수로 유지할 수 있습니다. 변환된 금액은 guarded half-away-from-zero 규칙을 사용하여 최소 통화 단위의 정수로 반올림됩니다. EUR 106.60은 11.257191에서 이제 120001.65606 대신 base_total = 120002를 저장합니다.

패치되지 않은 버전에서의 임시 해결 방법: 11과 같은 정수 환율을 사용하거나, 업그레이드가 배포될 때까지 소수 환율을 피하세요.

Question 3

InvoiceShelf API를 통해 견적을 업데이트할 때 'Undefined array key "discount_val"' 오류를 어떻게 해결하나요?

Accepted Answer

discount_val 필드는 요청의 최상위 수준에만 있는 것이 아니라 items 배열의 모든 객체 안에 포함되어야 합니다. 각 항목에 "discount_val": 0을 추가하고 /api/v1/estimates/{id}로 PUT 요청을 다시 보내세요.

예시 항목:
{
  "name": "23232",
  "price": 11100,
  "quantity": 1,
  "sub_total": 11100,
  "discount_val": 0
}

이 임시 해결 방법은 PHP 8.2에서 실행되는 InvoiceShelf 1.3.0에 적용됩니다. 이 문제는 2.0.0 개발 브랜치에서 재현되지 않는 것으로 보고되었습니다.

Question 4

InvoiceShelf에서 직원에게만 표시되는 비공개 메모나 URL을 청구서 항목에 어떻게 추가하나요?

Accepted Answer

InvoiceShelf 3.x 이상으로 업그레이드하세요. Item 모델에 연결된 사용자 정의 필드를 생성하고 해당 배치를 internal로 설정하세요. internal 필드는 관리자 인터페이스에서만 작성되고 조회됩니다. 인보이스/견적서에 인쇄되지 않으며 고객 포털을 통해 노출되지 않습니다. 고객 대상 문서에 필드를 표시하려면 대신 해당 배치를 document로 설정하세요. 이는 역할 기반 접근 제어가 아니라 필드 수준 가시성입니다. 항목을 볼 수 있는 모든 관리자 사용자는 해당 항목의 internal 필드를 볼 수 있습니다. 특정 필드를 특정 역할로 제한하는 것은 이 기능에서 지원되지 않으며 별도 개발이 필요합니다.

Question 5

반복 청구서가 많을 때 InvoiceShelf 성능 문제를 해결하는 방법

Accepted Answer

InvoiceShelf 3.0.0-alpha.3 이상으로 업그레이드하세요. 반복 청구서 생성은 애플리케이션 bootstrap에서 제거되어 Laravel 스케줄러가 실행하는 전용 recurring-invoices:generate Artisan command로 옮겨졌습니다. 이 명령은 또한 겹치거나 느린 실행으로 인한 중복 청구를 방지하기 위해 row locking/claiming을 사용합니다.

업그레이드 후 Laravel 스케줄러가 실행 중인지 확인하세요:

* * * * * cd /path-to-invoiceshelf && php artisan schedule:run >> /dev/null 2>&1

이전 bootstrap 기반 cron 등록에 의존하지 마세요. InvoiceShelf 2.4.x는 여전히 영향을 받습니다; 2.x 수정은 PR #741에서 추적되므로, 3.x로 업그레이드하는 것이 확인된 해결책입니다.

InvoiceShelf

주요 기능

할 수 없는 것

사용 사례

태그

시작하기

유사한 프로젝트