Files
logisticsAPI/app/Filament/Pages/Documents.php
Marvin bb1bbc2904 Refactor error handling and enhance API interactions across Filament pages
- Introduced `ApiErrorTranslator` to normalize and translate API error messages, providing clearer feedback in French.
- Updated all Filament pages (Articles, Documents, Divers, Journaux, Tiers, TablesExplorer) to utilize the new error translation mechanism, improving user experience during API interactions.
- Added validation for required fields before API calls, ensuring users receive immediate feedback when mandatory inputs are missing.
- Implemented tracking properties to distinguish between "never searched" and "searched without results," enhancing the user interface.
- Removed the obsolete `$results` property from the Articles page and added a new `$barcode` property to align with API requirements.
- Updated documentation to reflect changes in API behavior and error handling, including new metadata returned by the `art_list` endpoint.
- Added new tests to verify the functionality of the barcode handling and validation logic.
2026-02-23 10:15:17 +01:00

436 lines
13 KiB
PHP

<?php
namespace App\Filament\Pages;
use App\Exceptions\LogisticsApiException;
use App\Services\LogisticsService;
use App\Support\ApiErrorTranslator;
use Filament\Pages\Page;
use Filament\Support\Icons\Heroicon;
class Documents extends Page
{
protected static string|\BackedEnum|null $navigationIcon = Heroicon::OutlinedDocumentText;
protected static ?string $navigationLabel = 'Documents';
protected static ?string $title = 'Documents';
protected static ?int $navigationSort = 3;
protected string $view = 'filament.pages.documents';
public string $mode = 'read';
// document_list
public string $select = 'jnl,number,thirdid,date';
public string $thirdId = '';
// document_detail
public string $detailJnl = '';
public string $detailNumber = '';
// Document_GetStatusList
public string $statusJnl = '';
// Document_GetUnitPriceAndVat
public string $priceArtId = '';
public string $priceQty = '';
public string $priceJnl = '';
public string $priceThirdId = '';
public string $priceDate = '';
// Document_GetDueDate
public string $payDelay = '';
public string $dueDateInput = '';
// Document_GetAttachListThumbnail
public string $attachJnl = '';
public string $attachNumber = '';
// Document_GetPDF
public string $pdfJnl = '';
public string $pdfNumber = '';
public string $pdfLayout = '';
// document_add
public string $addThirdId = '';
public string $addDate = '';
public string $addArtIds = '';
public string $addQty = '';
public string $addSalePrice = '';
public string $addJnl = '';
public string $addDiscount = '';
public string $addVatId = '';
public string $addVatPc = '';
// document_mod
public string $modNumber = '';
public string $modJnl = '';
public string $modThirdId = '';
public string $modArtIds = '';
public string $modQty = '';
public string $modSalePrice = '';
// Data holders
public array $data = [];
public array $detailData = [];
public array $statusData = [];
public array $priceData = [];
public array $dueDateData = [];
public array $attachData = [];
public array $pdfData = [];
public array $addResult = [];
public array $modResult = [];
public ?array $metadata = null;
public ?string $errorMessage = null;
// Tracking
public bool $hasSearchedDocs = false;
public bool $hasDetail = false;
public bool $hasStatus = false;
public bool $hasPrice = false;
public bool $hasDueDate = false;
public bool $hasAttach = false;
public bool $hasPdf = false;
public bool $hasAdded = false;
public bool $hasModified = false;
public function searchDocuments(): void
{
$this->errorMessage = null;
$this->hasSearchedDocs = true;
try {
$service = app(LogisticsService::class);
$params = array_filter([
'select' => $this->select,
'thirdid' => $this->thirdId,
]);
$response = $service->documentList($params);
$this->data = $response['data'] ?? [];
$this->metadata = $response['metadata'] ?? null;
$this->errorMessage = ApiErrorTranslator::translate($response['error'] ?? null);
} catch (LogisticsApiException $e) {
$this->errorMessage = ApiErrorTranslator::translate($e->getMessage());
$this->data = [];
} catch (\Throwable $e) {
$this->errorMessage = ApiErrorTranslator::translate($e->getMessage());
$this->data = [];
}
}
public function getDocumentDetail(): void
{
$this->errorMessage = null;
if (blank($this->detailJnl) || blank($this->detailNumber)) {
$this->errorMessage = 'Les champs code journal (jnl) et numero de document (number) sont obligatoires.';
return;
}
$this->hasDetail = true;
try {
$service = app(LogisticsService::class);
$response = $service->documentDetail($this->detailJnl, $this->detailNumber);
$this->detailData = $response['data'] ?? [];
$this->errorMessage = ApiErrorTranslator::translate($response['error'] ?? null);
} catch (LogisticsApiException $e) {
$this->errorMessage = ApiErrorTranslator::translate($e->getMessage());
$this->detailData = [];
} catch (\Throwable $e) {
$this->errorMessage = ApiErrorTranslator::translate($e->getMessage());
$this->detailData = [];
}
}
public function getStatusList(): void
{
$this->errorMessage = null;
if (blank($this->statusJnl)) {
$this->errorMessage = 'Le champ code journal (jnl) est obligatoire.';
return;
}
$this->hasStatus = true;
try {
$service = app(LogisticsService::class);
$response = $service->documentGetStatusList($this->statusJnl);
$this->statusData = $response['data'] ?? [];
$this->errorMessage = ApiErrorTranslator::translate($response['error'] ?? null);
} catch (LogisticsApiException $e) {
$this->errorMessage = ApiErrorTranslator::translate($e->getMessage());
$this->statusData = [];
} catch (\Throwable $e) {
$this->errorMessage = ApiErrorTranslator::translate($e->getMessage());
$this->statusData = [];
}
}
public function getUnitPriceAndVat(): void
{
$this->errorMessage = null;
if (blank($this->priceArtId) || blank($this->priceQty) || blank($this->priceJnl) || blank($this->priceThirdId) || blank($this->priceDate)) {
$this->errorMessage = 'Tous les champs sont obligatoires : ARTID, QTY (format string), JNL, THIRDID et DATE.';
return;
}
$this->hasPrice = true;
try {
$service = app(LogisticsService::class);
$response = $service->documentGetUnitPriceAndVat([
'ARTID' => $this->priceArtId,
'QTY' => $this->priceQty,
'JNL' => $this->priceJnl,
'THIRDID' => $this->priceThirdId,
'DATE' => $this->priceDate,
]);
$this->priceData = $response['data'] ?? [];
$this->errorMessage = ApiErrorTranslator::translate($response['error'] ?? null);
} catch (LogisticsApiException $e) {
$this->errorMessage = ApiErrorTranslator::translate($e->getMessage());
$this->priceData = [];
} catch (\Throwable $e) {
$this->errorMessage = ApiErrorTranslator::translate($e->getMessage());
$this->priceData = [];
}
}
public function getDueDate(): void
{
$this->errorMessage = null;
if (blank($this->payDelay) || blank($this->dueDateInput)) {
$this->errorMessage = 'Les champs delai de paiement (paydelay) et date de depart (date) sont obligatoires.';
return;
}
$this->hasDueDate = true;
try {
$service = app(LogisticsService::class);
$response = $service->documentGetDueDate($this->payDelay, $this->dueDateInput);
$this->dueDateData = $response['data'] ?? [];
$this->errorMessage = ApiErrorTranslator::translate($response['error'] ?? null);
} catch (LogisticsApiException $e) {
$this->errorMessage = ApiErrorTranslator::translate($e->getMessage());
$this->dueDateData = [];
} catch (\Throwable $e) {
$this->errorMessage = ApiErrorTranslator::translate($e->getMessage());
$this->dueDateData = [];
}
}
public function getAttachListThumbnail(): void
{
$this->errorMessage = null;
if (blank($this->attachJnl) || blank($this->attachNumber)) {
$this->errorMessage = 'Les champs code journal (JNL) et numero de document (NUMBER) sont obligatoires.';
return;
}
$this->hasAttach = true;
try {
$service = app(LogisticsService::class);
$response = $service->documentGetAttachListThumbnail($this->attachJnl, $this->attachNumber);
$this->attachData = $response['data'] ?? [];
$this->errorMessage = ApiErrorTranslator::translate($response['error'] ?? null);
} catch (LogisticsApiException $e) {
$this->errorMessage = ApiErrorTranslator::translate($e->getMessage());
$this->attachData = [];
} catch (\Throwable $e) {
$this->errorMessage = ApiErrorTranslator::translate($e->getMessage());
$this->attachData = [];
}
}
public function getPdf(): void
{
$this->errorMessage = null;
if (blank($this->pdfJnl) || blank($this->pdfNumber) || blank($this->pdfLayout)) {
$this->errorMessage = 'Les champs code journal (JNL), numero de document (NUMBER) et mise en page (LAYOUT) sont obligatoires.';
return;
}
$this->hasPdf = true;
try {
$service = app(LogisticsService::class);
$response = $service->documentGetPdf($this->pdfJnl, $this->pdfNumber, $this->pdfLayout);
$this->pdfData = $response['data'] ?? [];
$this->errorMessage = ApiErrorTranslator::translate($response['error'] ?? null);
} catch (LogisticsApiException $e) {
$this->errorMessage = ApiErrorTranslator::translate($e->getMessage());
$this->pdfData = [];
} catch (\Throwable $e) {
$this->errorMessage = ApiErrorTranslator::translate($e->getMessage());
$this->pdfData = [];
}
}
public function addDocument(): void
{
$this->errorMessage = null;
if (blank($this->addThirdId) || blank($this->addDate) || blank($this->addArtIds) || blank($this->addQty) || blank($this->addSalePrice) || blank($this->addJnl)) {
$this->errorMessage = 'Les champs ThirdId, Date, Artid, Qty, Saleprice et JNL sont obligatoires.';
return;
}
$this->hasAdded = true;
try {
$service = app(LogisticsService::class);
$params = [
'ThirdId' => $this->addThirdId,
'Date' => $this->addDate,
'Artid' => $this->splitCsv($this->addArtIds),
'Qty' => $this->splitCsv($this->addQty),
'Saleprice' => $this->splitCsv($this->addSalePrice),
'JNL' => $this->addJnl,
];
if (filled($this->addDiscount)) {
$params['Discount'] = $this->splitCsv($this->addDiscount);
}
if (filled($this->addVatId)) {
$params['Vatid'] = $this->splitCsv($this->addVatId);
}
if (filled($this->addVatPc)) {
$params['Vatpc'] = $this->splitCsv($this->addVatPc);
}
$response = $service->documentAdd($params);
$this->addResult = $response['data'] ?? [];
$this->errorMessage = ApiErrorTranslator::translate($response['error'] ?? null);
} catch (LogisticsApiException $e) {
$this->errorMessage = ApiErrorTranslator::translate($e->getMessage());
$this->addResult = [];
} catch (\Throwable $e) {
$this->errorMessage = ApiErrorTranslator::translate($e->getMessage());
$this->addResult = [];
}
}
public function modDocument(): void
{
$this->errorMessage = null;
if (blank($this->modNumber) || blank($this->modJnl)) {
$this->errorMessage = 'Les champs numero de document (number) et code journal (JNL) sont obligatoires.';
return;
}
$this->hasModified = true;
try {
$service = app(LogisticsService::class);
$params = [
'number' => $this->modNumber,
'JNL' => $this->modJnl,
];
if (filled($this->modThirdId)) {
$params['Thirdid'] = $this->modThirdId;
}
if (filled($this->modArtIds)) {
$params['Artid'] = $this->splitCsv($this->modArtIds);
}
if (filled($this->modQty)) {
$params['Qty'] = $this->splitCsv($this->modQty);
}
if (filled($this->modSalePrice)) {
$params['Saleprice'] = $this->splitCsv($this->modSalePrice);
}
$response = $service->documentMod($params);
$this->modResult = $response['data'] ?? [];
$this->errorMessage = ApiErrorTranslator::translate($response['error'] ?? null);
} catch (LogisticsApiException $e) {
$this->errorMessage = ApiErrorTranslator::translate($e->getMessage());
$this->modResult = [];
} catch (\Throwable $e) {
$this->errorMessage = ApiErrorTranslator::translate($e->getMessage());
$this->modResult = [];
}
}
/**
* @return array<int, string>
*/
private function splitCsv(string $value): array
{
return array_map('trim', explode(',', $value));
}
}