billifty/shared-resources

Shared Laravel module with modular support for User, Post, Comments, etc.

dev-main 2026-06-10 06:54 UTC

Requires

• php: ^8.1

Requires (Dev)

• laravel/passport: ^12.4
• orchestra/testbench: ^8.0
• phpunit/phpunit: ^10.0

MIT

README

Workspace-scoped invoicing records

business_profiles and clients are owned by workspace_id, not user_id. User ownership should be resolved through workspace.user_id. This keeps future workspace switching possible while preserving current user-level plan counts via the user's workspace relationships.

Invoice PDF totals

Invoice PDF templates must use invoices.total_cents as the source of truth for the displayed invoice total.

invoices.amount_due_cents represents the remaining balance after payments. It can legitimately become 0 when Stripe or PayPal marks an invoice as paid, so it must not be used as the primary invoice total in generated PDFs.

When invoice financial fields, payment status, or payment-link metadata changes, the stored PDF snapshot (pdf_path, pdf_status, pdf_generated_at, pdf_error) should be invalidated so a stale PDF is not reused.

docker compose -f docker-compose.yml -f docker-compose.dev.yml exec -T mysql \
  sh -lc "MYSQL_PWD='root' mysqldump -u 'root' app_db --single-transaction --routines --triggers --events --no-tablespaces" \
  > shared-resources/src/TestCase/sqldumps/billifty.mysql.sql

and run the test on specific class

Run every module test class one class at a time:

composer test

Or:

./bin/phpunit-by-class

Run a specific class through PHPUnit:

./vendor/bin/phpunit --filter=UserSubscriptionTest

Or

docker compose -f docker-compose.yml -f docker-compose.dev.yml exec backend php artisan testdb:snapshot