- What is liberusoftware/module-liberu-executive-insights-api used for?
- It is an optional Laravel/PHP API module that exposes Liberu Executive Insights endpoints for executive dashboards, business metrics, KPIs, and reporting data. It presents one new Liberu cross-product module through a versioned contract covering resources, operations, permissions, tenancy, errors, idempotency, and reconciliation evidence. It depends only on the module's public contracts and is intended to integrate actionable insights into Liberu applications without duplicating behavior owned by Accounting, CRM, Billing, or other modules.
- How do I install and configure the Liberu Executive Insights API package?
- Install it with Composer using composer require liberusoftware/module-liberu-executive-insights-api. Because the repository and README excerpt provided are empty, exact publish tags, config files, and environment variables should be confirmed from the package's composer.json and documentation. Configuration typically involves registering the module's service provider and ensuring the public contract dependencies are available in your Laravel application.
- Which Laravel and PHP versions does this Executive Insights API module support?
- The supplied context confirms it is a Laravel/PHP package but does not list exact Laravel or PHP version constraints. Check the package's composer.json for the authoritative require and require-dev entries before upgrading. You should also verify compatibility with the Laravel version used by your Liberu application and its other modules.
- What endpoints and operations does the Executive Insights API expose?
- The package is described as exposing endpoints for executive dashboards, business metrics, KPIs, and reporting data. It also exposes the module's versioned cross-product contract, resources, operations, permissions, tenancy, errors, idempotency, and reconciliation evidence. The exact route paths and HTTP methods should be taken from the package's route definitions and API documentation rather than assumed.
- How does the package handle multi-tenancy and permissions?
- The API layer includes tenancy and permissions as part of the module's versioned cross-product contract. That means access should be evaluated through the package's public contract and the host application's tenancy model rather than through behavior owned by Accounting, CRM, or Billing. You should confirm the exact tenancy resolution and permission names in the package's configuration and authorization definitions.
- Does this package support idempotency and reconciliation evidence?
- Yes, idempotency and reconciliation evidence are explicitly listed among the capabilities exposed by the module's versioned contract. This is useful for safe retries on write operations and for providing audit-friendly evidence during reconciliation workflows. Implementation details, such as idempotency key headers and evidence formats, should be verified against the package's API documentation.
- How do I test the Executive Insights API endpoints in a Laravel app?
- Use Laravel's HTTP testing helpers to exercise the package's routes against a test database and authenticated tenant context. Because the package depends only on public contracts, you can fake or bind contract implementations to isolate the API layer. Confirm any package-provided test traits, fixtures, or factories from the source and documentation, since the supplied README excerpt is empty.
- Is this package required to use Liberu Executive Insights or is it optional?
- It is optional. The overview states that this is an optional API package presenting exactly one new Liberu cross-product module. The core Executive Insights behavior is owned elsewhere, and this package exposes the public contract through HTTP endpoints. Applications that do not need remote or modular API access can likely rely on the underlying module instead.
- What are the alternatives to this package for building executive dashboards in Laravel?
- Alternatives include implementing dashboard and KPI endpoints directly in your Laravel application or using existing Liberu modules and public contracts without this optional API layer. General Laravel reporting, charting, and analytics packages can complement the data layer but would not provide the same Liberu cross-product contract. The right choice depends on whether you need the versioned API surface, tenancy, idempotency, and reconciliation evidence this package provides.
- How is this Liberu Executive Insights API package maintained and versioned for production?
- The package is part of the Liberu package family and exposes a versioned cross-product contract, which supports controlled upgrades. For production, pin a specific Composer version, review semantic version changes, and verify compatibility with your Laravel and Liberu module versions. Because the repository is unknown and the README excerpt is empty in the supplied context, check Packagist and the source repository for release history and maintenance activity.