Question 1

なぜ Docker で InvoiceShelf の定期請求書が生成されないのか、またスケジューラを修正するにはどうすればよいですか？

Accepted Answer

InvoiceShelf Docker image v2.4.2（および影響を受ける 3.x イメージ）では、Nginx と PHP-FPM だけが実行され、php artisan schedule:run を実行するプロセスが存在しないため、定期請求書、期限超過更新、見積もりの期限切れは決して実行されません。確認するには次を実行します: docker exec -u www-data php artisan schedule:run 不足しているジョブがすぐに実行される場合は、同じイメージ、環境、ネットワーク、ボリュームを使用する専用の scheduler コンテナを追加します: 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 を実行します。ホストレベルの回避策として、cron ジョブを追加します: * * * * * docker exec -u www-data php artisan schedule:run 影響を受けるバージョンでは /api/cron に依存しないでください。config/services.php に cron_job.auth_token エントリがないため、401 を返すことがあります。

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 です。変換後の金額は、ガード付きの half-away-from-zero ルールを使用して最小通貨単位の整数に丸められます。11.257191 での EUR 106.60 は 120001.65606 ではなく base_total = 120002 を保存するようになります。

未パッチ版での一時的な回避策: 11 のような整数の為替レートを使用するか、アップグレードがデプロイされるまで小数レートを避けてください。

Question 3

InvoiceShelf APIを通じて見積を更新する際に「Undefined array key "discount_val"」を修正する方法は？

Accepted Answer

discount_val フィールドは、リクエストのトップレベルだけでなく、items 配列内のすべてのオブジェクトに含める必要があります。各 item に "discount_val": 0 を追加し、/api/v1/estimates/{id} に PUT リクエストを再送信してください。

item の例:
{
  "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 に設定します。これはフィールドレベルの可視性であり、ロールベースのアクセス制御ではないことに注意してください。Item を表示できるすべての管理者ユーザーは、その internal フィールドを表示できます。特定のフィールドを特定のロールに制限することはこの機能ではサポートされておらず、別途開発が必要です。

Question 5

定期請求書が多い場合に InvoiceShelf のパフォーマンス問題を修正する方法は？

Accepted Answer

InvoiceShelf 3.0.0-alpha.3 以降にアップグレードしてください。定期請求書の生成は、アプリケーションの bootstrap から、Laravel のスケジューラによって実行される専用の recurring-invoices:generate Artisan コマンドへ移動されました。このコマンドはまた、実行の重複や遅い実行による二重請求を防ぐために、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

主な機能

できないこと

使用例

タグ

はじめ方

類似プロジェクト