star-erp/app/Modules/Procurement/Contracts/ProcurementServiceInterface.php

<?php

namespace App\Modules\Procurement\Contracts;

use Illuminate\Support\Collection;

interface ProcurementServiceInterface
{
    /**
     * Get purchase orders within a date range.
     * 
     * @param string $start
     * @param string $end
     * @param array $statuses
     * @return Collection
     */
    public function getPurchaseOrdersByDate(string $start, string $end, array $statuses = ['received', 'completed']): Collection;

    /**
     * Get purchase orders by multiple IDs.
     * 
     * @param array $ids
     * @param array $with
     * @return Collection
     */
    public function getPurchaseOrdersByIds(array $ids, array $with = []): Collection;

    /**
     * Get statistics for the dashboard.
     * 
     * @return array
     */
    public function getDashboardStats(): array;
}