- What Laravel and PHP versions does baks-dev/products-sign support?
- The package requires PHP 8.4+ and is fully compatible with Laravel 10+. Check the [Packagist page](https://packagist.org/packages/baks-dev/products-sign) for the latest version compatibility details. Ensure your Laravel project aligns with these requirements before installation.
- How do I install and configure the package for Честный знак compliance?
- Run `composer require baks-dev/barcode baks-dev/products-sign`, then create the upload directory (`public/upload/product_sign_code`) and set permissions. Install `pdftk` and `texlive-extra-utils` via `sudo apt install`, and configure ImageMagick’s `policy.xml` to allow PDF read/write. Finally, run `php artisan baks:assets:install` to publish assets.
- Does this package handle dynamic QR code requirements for tamper-evident features?
- The package currently supports static QR/PDF generation for Честный знак compliance but lacks explicit documentation on dynamic or tamper-evident features. Review the [latest release notes](https://github.com/baks-dev/products-sign/releases) for updates, as regulatory changes may require manual adjustments.
- Can I use cloud storage (S3) instead of the default filesystem for uploaded codes?
- The package defaults to filesystem storage, but you can configure S3 or other cloud storage by updating the `FILESYSTEM_DISK` in your `.env` file. Ensure your storage adapter is properly set up in Laravel’s `filesystems.php` configuration.
- What breaking changes were introduced in version 7.4.20+, and how do I migrate?
- Version 7.4.20+ introduced changes like replacing `Signature::generate()` with `SignatureCreator`. Review the [migration guide](https://github.com/baks-dev/products-sign/blob/main/UPGRADE.md) for details. Test your application thoroughly, as undocumented changes may affect validation or generation workflows.
- How do I validate Честный знак codes in my Laravel application?
- Use the `SignatureValidator` class to validate codes. Example: `$validator = new SignatureValidator(); $isValid = $validator->validate($code);`. For bulk validation, consider queueing jobs to avoid performance bottlenecks, as PDF/QR processing can be resource-intensive.
- Are there performance optimizations for high-volume product marking (e.g., 10K+ products/month)?
- The package does not include built-in async or caching optimizations. For high-volume use, implement Laravel queues (e.g., `SignatureGenerationJob`) and cache validation results. Monitor PDF/QR processing latency, as external tools like `pdftk` may introduce delays.
- Can I run this package in a Windows development environment?
- The package relies on Linux-specific tools (`pdftk`, `texlive-extra-utils`). Use Docker with a Linux container (e.g., `ubuntu:latest`) or a VM to replicate production dependencies. Windows WSL or Git Bash may not fully support these tools without additional configuration.
- How do I test the package’s compliance with Federal Law No. 243-FZ?
- Run the provided test suite with `php bin/phpunit --group=products-sign`. Additionally, manually verify QR/PDF generation against official Честный знак validation tools. Cross-check with the latest [EEU regulatory guidelines](https://www.eurasiancommission.org/) for silent compliance updates.
- What alternatives exist for Честный знак compliance in Laravel?
- Alternatives include custom GS1 QR generation libraries (e.g., `endroid/qr-code`) or third-party APIs like [Честный знак’s official SDK](https://chestnyznak.ru/). However, this package offers deep Laravel integration (Eloquent, Artisan) and regulatory alignment for Russian/EEU markets, reducing development effort.