- What is baks-dev/products-stocks used for?
- It is a warehouse and stock-accounting module for PHP 8.4+ applications in the BaksDev ecosystem. It provides Doctrine entities and schema for tracking product inventory, warehouses, and stock movements. Use it when inventory is a distinct domain in an e-commerce, retail, logistics, or modular Laravel application. It does not include a ready-made admin UI.
- How do I install baks-dev/products-stocks?
- Install it with Composer using composer require baks-dev/products-stocks. Then publish configuration and file assets with the BaksDev asset command shown in the README, php bin/console baks:assets:install. In a Laravel app, confirm whether the command is exposed through Artisan or the BaksDev console before scripting deployment. After that, generate and review Doctrine migrations.
- Does this package support Laravel and PHP 8.4?
- The package requires PHP 8.4+ and is designed around Doctrine and the BaksDev ecosystem. The technical assessment notes Laravel 10+ assumptions because it uses Doctrine migrations and Artisan-style tooling. Test against your exact Laravel version in a container or staging environment, especially if you are upgrading from older PHP or Symfony components.
- How do I run database migrations for products-stocks?
- Generate a schema diff with php bin/console doctrine:migrations:diff, then review the generated migration before applying it. Run php bin/console doctrine:migrations:migrate, preferably with a dry run or staging database first. The module introduces inventory-related tables, so check for conflicts with existing stock tables and plan legacy data backfills.
- How do I run the products-stocks PHPUnit tests?
- The README shows php bin/phpunit --group=products-stocks. That dedicated PHPUnit group lets you isolate the module tests from the rest of your suite. In a Laravel project, adapt the binary path to your test runner if needed. Use these tests as a starting point, then add integration tests for your own stock workflows.
- What databases are supported by baks-dev/products-stocks?
- Because it uses Doctrine, it is expected to work with MySQL, PostgreSQL, and SQLite. The technical assessment notes that SQL Server support is not confirmed. Verify compatibility for your target database and check generated Doctrine mappings before migrating production data.
- Does baks-dev/products-stocks include an admin UI?
- No. The package focuses on the domain model, Doctrine schema, assets, and migrations for stock accounting. It does not ship a pre-built admin panel or frontend for warehouse operations. You will need to build or integrate UI screens for products, warehouses, and stock movements.
- Can baks-dev/products-stocks handle multi-warehouse inventory?
- The module includes warehouse and stock movement concepts in its Doctrine model, but the provided documentation does not confirm advanced multi-warehouse routing or global allocation rules. Treat multi-warehouse scalability as a validation item and test your specific scenarios. You may need custom extensions for geo-based routing, transfers, or low-stock alerts.
- Does the module support events like StockUpdated for real-time sync?
- The overview and README do not document StockUpdated events, listeners, or other event-driven hooks. Before designing order-processing or notification integrations around events, inspect the source code and tests for available domain events. If none exist, add integration tests and extend the module with your own event dispatch layer.
- Is baks-dev/products-stocks production-ready and MIT licensed?
- It is MIT licensed, so you can use and customize it commercially. Production readiness depends on your Laravel, PHP 8.4, database, and migration strategy. Run migrations in staging, benchmark key queries, and build integration tests for critical stock workflows before rollout.