- Can this bundle be used in Laravel projects, or is it strictly for Symfony?
- This bundle is designed exclusively for Symfony and API Platform. Laravel projects will need alternative solutions, such as custom API integrations or third-party SDKs like VNG-RealisatieGids, to achieve similar Dutch government API functionality.
- What Laravel alternatives exist for BSN validation or KVK business registry lookups?
- For Laravel, consider packages like `spatie/laravel-activitylog` for auditing, `fruitcake/laravel-bsn-validator` for BSN checks, or direct API integrations with Dutch government endpoints (e.g., KVK API). No direct Laravel equivalent of this Symfony bundle exists.
- How do I configure the bundle to work with the Dutch Common Ground API?
- After installing via Composer, enable the bundle in `config/bundles.php` and copy `conduction_common_ground.yaml` to `config/packages/`. Set environment variables for `COMMONGROUND_API_URL`, `CLIENT_ID`, and `CLIENT_SECRET` in your `.env` file, then configure the API URL and credentials in the YAML file.
- Does this bundle support Symfony 5.x or only older versions?
- The bundle requires Symfony 4.4+ and is compatible with Symfony 5.x, as it aligns with API Platform’s latest versions. Check the [GitHub repository](https://github.com/ConductionNL/CommonGroundBundle) for version-specific notes, though no explicit Symfony 6.x support is mentioned.
- Are there any known issues with production stability or performance?
- The bundle has low adoption (0 stars/dependents), indicating unproven production stability. Potential risks include undocumented edge cases or breaking changes. Test thoroughly in staging, especially for Dutch-specific APIs like BSN/KVK, which may introduce latency or rate limits.
- How do I extend API Platform resources with Common Ground traits or events?
- Use the bundle’s events (e.g., `commonground.resource.save`) to hook into CRUD operations. For resources, add the `[CommonGroundResource]` attribute or implement custom controllers. Refer to the [README](https://github.com/ConductionNL/CommonGroundBundle) for event listener examples, though detailed guides are lacking.
- Will this bundle work with self-hosted Common Ground instances or only the official API?
- The bundle supports configurable API URLs, so it can work with self-hosted Common Ground instances. Ensure your instance adheres to the VNG API Standard and update the `api_url` in `conduction_common_ground.yaml` to point to your endpoint.
- How do I handle GDPR compliance for BSN data processed by this bundle?
- The bundle provides lifecycle events (e.g., `commonground.resource.created`) to log or audit BSN data. Implement custom event listeners to enforce GDPR requirements, such as data retention policies or consent tracking. Validate compliance with Dutch privacy laws (e.g., AVG) separately.
- Is there a way to test the bundle’s KVK or BSN validation features locally?
- Mock the Common Ground API responses in tests using tools like `nelmio/api-doc-bundle` or Symfony’s `HttpClient` with fixtures. Replace the `api_url` in tests with a local endpoint or use a testing service like [Common Ground’s sandbox](https://common-ground.test) if available.
- What happens if the Dutch government changes the VNG API Standard or Common Ground requirements?
- The bundle’s maintenance status is unclear due to low adoption. Monitor the [GitHub repository](https://github.com/ConductionNL/CommonGroundBundle) for updates or consider forking the project to adapt to changes. Directly integrating with the VNG API Standard documentation may offer more future-proof flexibility.