mirror of
https://github.com/InvoiceShelf/InvoiceShelf.git
synced 2026-07-16 22:05:20 +00:00
refactor(services): Documents→Document + ExchangeRate→Integrations/ExchangeRate
Two follow-ups to the Services reorg that landed in 6d1816bd.
**Documents → Document** (singular). Documents/ was the only plural subdir in app/Services/ — every other bucket (Company, Mail, Module, Pdf, Storage, Update, ExchangeRate) was singular. Renaming to Document/ normalizes the whole tree.
**ExchangeRate → Integrations/ExchangeRate**. Introduces Integrations/ as an umbrella for external-service adapter subsystems. Exchange rate providers move in first; AI providers, payment gateways, and any other driver-pattern integrations land as sibling subdirs (Integrations/Ai/, Integrations/Payment/) without another reorg. Integrations/ was chosen over Providers/ to avoid conceptual collision with Laravel's app/Providers/ — 'check the providers' shouldn't be ambiguous.
17 files moved, 21 consumer files rewritten to point at the new namespaces via literal-string replacement (same approach as the previous reorg). 350 tests pass, Pint clean.
This commit is contained in:
Darko Gjorgjijoski
437
app/Services/Document/InvoiceService.php
Normal file
437
app/Services/Document/InvoiceService.php
Normal file
@@ -0,0 +1,437 @@
|
||||
<?php
|
||||
|
||||
namespace App\Services\Document;
|
||||
|
||||
use App;
|
||||
use App\Facades\Hashids;
|
||||
use App\Facades\Pdf;
|
||||
use App\Mail\SendInvoiceMail;
|
||||
use App\Models\Company;
|
||||
use App\Models\CompanySetting;
|
||||
use App\Models\CustomField;
|
||||
use App\Models\Estimate;
|
||||
use App\Models\ExchangeRateLog;
|
||||
use App\Models\Invoice;
|
||||
use App\Services\Mail\CompanyMailConfigService;
|
||||
use App\Support\Pdf\PdfTemplateUtils;
|
||||
use Carbon\Carbon;
|
||||
use Illuminate\Http\Request;
|
||||
use Illuminate\Support\Collection;
|
||||
use Illuminate\Validation\ValidationException;
|
||||
|
||||
class InvoiceService
|
||||
{
|
||||
public function __construct(
|
||||
private readonly DocumentItemService $documentItemService,
|
||||
) {}
|
||||
|
||||
public function create(Request $request): Invoice
|
||||
{
|
||||
$data = $request->getInvoicePayload();
|
||||
|
||||
if ($request->has('invoiceSend')) {
|
||||
$data['status'] = Invoice::STATUS_SENT;
|
||||
}
|
||||
|
||||
$invoice = Invoice::create($data);
|
||||
|
||||
$serial = (new SerialNumberService)
|
||||
->setModel($invoice)
|
||||
->setCompany($invoice->company_id)
|
||||
->setCustomer($invoice->customer_id)
|
||||
->setNextNumbers();
|
||||
|
||||
$invoice->sequence_number = $serial->nextSequenceNumber;
|
||||
$invoice->customer_sequence_number = $serial->nextCustomerSequenceNumber;
|
||||
$invoice->unique_hash = Hashids::connection(Invoice::class)->encode($invoice->id);
|
||||
$invoice->save();
|
||||
|
||||
$this->documentItemService->createItems($invoice, $request->items);
|
||||
|
||||
$companyCurrency = CompanySetting::getSetting('currency', $request->header('company'));
|
||||
|
||||
if ((string) $data['currency_id'] !== $companyCurrency) {
|
||||
ExchangeRateLog::addExchangeRateLog($invoice);
|
||||
}
|
||||
|
||||
if ($request->has('taxes') && (! empty($request->taxes))) {
|
||||
$this->documentItemService->createTaxes($invoice, $request->taxes);
|
||||
}
|
||||
|
||||
if ($request->customFields) {
|
||||
$invoice->addCustomFields($request->customFields);
|
||||
}
|
||||
|
||||
return Invoice::with([
|
||||
'items',
|
||||
'items.fields',
|
||||
'items.fields.customField',
|
||||
'customer',
|
||||
'taxes',
|
||||
])->find($invoice->id);
|
||||
}
|
||||
|
||||
/**
|
||||
* @throws ValidationException
|
||||
*/
|
||||
public function update(Invoice $invoice, Request $request): Invoice
|
||||
{
|
||||
$serial = (new SerialNumberService)
|
||||
->setModel($invoice)
|
||||
->setCompany($invoice->company_id)
|
||||
->setCustomer($request->customer_id)
|
||||
->setModelObject($invoice->id)
|
||||
->setNextNumbers();
|
||||
|
||||
$data = $request->getInvoicePayload();
|
||||
$oldTotal = $invoice->total;
|
||||
|
||||
$totalPaidAmount = $invoice->total - $invoice->due_amount;
|
||||
|
||||
if ($totalPaidAmount > 0 && $invoice->customer_id !== $request->customer_id) {
|
||||
throw ValidationException::withMessages([
|
||||
'customer_id' => ['customer_cannot_be_changed_after_payment_is_added'],
|
||||
]);
|
||||
}
|
||||
|
||||
if ($request->total >= 0 && $request->total < $totalPaidAmount) {
|
||||
throw ValidationException::withMessages([
|
||||
'total' => ['total_invoice_amount_must_be_more_than_paid_amount'],
|
||||
]);
|
||||
}
|
||||
|
||||
if ($oldTotal != $request->total) {
|
||||
$oldTotal = (int) round($request->total) - (int) $oldTotal;
|
||||
} else {
|
||||
$oldTotal = 0;
|
||||
}
|
||||
|
||||
$data['due_amount'] = ($invoice->due_amount + $oldTotal);
|
||||
$data['base_due_amount'] = $data['due_amount'] * $data['exchange_rate'];
|
||||
$data['customer_sequence_number'] = $serial->nextCustomerSequenceNumber;
|
||||
|
||||
$invoice->update($data);
|
||||
|
||||
$statusData = $invoice->getInvoiceStatusByAmount($data['due_amount']);
|
||||
if (! empty($statusData)) {
|
||||
$invoice->update($statusData);
|
||||
}
|
||||
|
||||
$companyCurrency = CompanySetting::getSetting('currency', $request->header('company'));
|
||||
|
||||
if ((string) $data['currency_id'] !== $companyCurrency) {
|
||||
ExchangeRateLog::addExchangeRateLog($invoice);
|
||||
}
|
||||
|
||||
$invoice->items->map(function ($item) {
|
||||
$fields = $item->fields()->get();
|
||||
|
||||
$fields->map(function ($field) {
|
||||
$field->delete();
|
||||
});
|
||||
});
|
||||
|
||||
$invoice->items()->delete();
|
||||
$invoice->taxes()->delete();
|
||||
|
||||
$this->documentItemService->createItems($invoice, $request->items);
|
||||
|
||||
if ($request->has('taxes') && (! empty($request->taxes))) {
|
||||
$this->documentItemService->createTaxes($invoice, $request->taxes);
|
||||
}
|
||||
|
||||
if ($request->customFields) {
|
||||
$invoice->updateCustomFields($request->customFields);
|
||||
}
|
||||
|
||||
return Invoice::with([
|
||||
'items',
|
||||
'items.fields',
|
||||
'items.fields.customField',
|
||||
'customer',
|
||||
'taxes',
|
||||
])->find($invoice->id);
|
||||
}
|
||||
|
||||
public function delete(Collection $ids): bool
|
||||
{
|
||||
foreach ($ids as $id) {
|
||||
$invoice = Invoice::find($id);
|
||||
|
||||
if ($invoice->transactions()->exists()) {
|
||||
$invoice->transactions()->delete();
|
||||
}
|
||||
|
||||
$invoice->delete();
|
||||
}
|
||||
|
||||
return true;
|
||||
}
|
||||
|
||||
public function sendInvoiceData(Invoice $invoice, array $data): array
|
||||
{
|
||||
$data['invoice'] = $invoice->toArray();
|
||||
$data['customer'] = $invoice->customer->toArray();
|
||||
$data['company'] = Company::find($invoice->company_id);
|
||||
$data['subject'] = $invoice->getEmailString($data['subject']);
|
||||
$data['body'] = $invoice->getEmailString($data['body']);
|
||||
$data['attach']['data'] = ($invoice->getEmailAttachmentSetting()) ? $this->getPdfData($invoice) : null;
|
||||
|
||||
return $data;
|
||||
}
|
||||
|
||||
public function preview(Invoice $invoice, array $data): array
|
||||
{
|
||||
$data = $this->sendInvoiceData($invoice, $data);
|
||||
|
||||
return [
|
||||
'type' => 'preview',
|
||||
'view' => new SendInvoiceMail($data),
|
||||
];
|
||||
}
|
||||
|
||||
public function send(Invoice $invoice, array $data): array
|
||||
{
|
||||
$data = $this->sendInvoiceData($invoice, $data);
|
||||
|
||||
CompanyMailConfigService::apply($invoice->company_id);
|
||||
|
||||
$mail = \Mail::to($data['to']);
|
||||
if (! empty($data['cc'])) {
|
||||
$mail->cc($data['cc']);
|
||||
}
|
||||
if (! empty($data['bcc'])) {
|
||||
$mail->bcc($data['bcc']);
|
||||
}
|
||||
$mail->send(new SendInvoiceMail($data));
|
||||
|
||||
if ($invoice->status == Invoice::STATUS_DRAFT) {
|
||||
$invoice->status = Invoice::STATUS_SENT;
|
||||
$invoice->sent = true;
|
||||
$invoice->save();
|
||||
}
|
||||
|
||||
return [
|
||||
'success' => true,
|
||||
'type' => 'send',
|
||||
];
|
||||
}
|
||||
|
||||
public function getPdfData(Invoice $invoice)
|
||||
{
|
||||
$taxes = collect();
|
||||
|
||||
if ($invoice->tax_per_item === 'YES') {
|
||||
foreach ($invoice->items as $item) {
|
||||
foreach ($item->taxes as $tax) {
|
||||
$found = $taxes->filter(function ($item) use ($tax) {
|
||||
return $item->tax_type_id == $tax->tax_type_id;
|
||||
})->first();
|
||||
|
||||
if ($found) {
|
||||
$found->amount += $tax->amount;
|
||||
} else {
|
||||
$taxes->push($tax);
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
$invoiceTemplate = Invoice::find($invoice->id)->template_name;
|
||||
|
||||
$company = Company::find($invoice->company_id);
|
||||
$locale = CompanySetting::getSetting('language', $company->id);
|
||||
$customFields = CustomField::where('model_type', 'Item')->get();
|
||||
|
||||
App::setLocale($locale);
|
||||
|
||||
$logo = $company->logo_path;
|
||||
|
||||
view()->share([
|
||||
'invoice' => $invoice,
|
||||
'customFields' => $customFields,
|
||||
'company_address' => $invoice->getCompanyAddress(),
|
||||
'shipping_address' => $invoice->getCustomerShippingAddress(),
|
||||
'billing_address' => $invoice->getCustomerBillingAddress(),
|
||||
'notes' => $invoice->getNotes(),
|
||||
'logo' => $logo ?? null,
|
||||
'taxes' => $taxes,
|
||||
]);
|
||||
|
||||
$template = PdfTemplateUtils::findFormattedTemplate('invoice', $invoiceTemplate, '');
|
||||
$templatePath = $template['custom'] ? sprintf('pdf_templates::invoice.%s', $invoiceTemplate) : sprintf('app.pdf.invoice.%s', $invoiceTemplate);
|
||||
|
||||
if (request()->has('preview')) {
|
||||
return view($templatePath);
|
||||
}
|
||||
|
||||
return Pdf::loadView($templatePath);
|
||||
}
|
||||
|
||||
public function clone(Invoice $invoice): Invoice
|
||||
{
|
||||
$date = Carbon::now();
|
||||
|
||||
$serial = (new SerialNumberService)
|
||||
->setModel($invoice)
|
||||
->setCompany($invoice->company_id)
|
||||
->setCustomer($invoice->customer_id)
|
||||
->setNextNumbers();
|
||||
|
||||
$dueDate = null;
|
||||
$dueDateEnabled = CompanySetting::getSetting(
|
||||
'invoice_set_due_date_automatically',
|
||||
$invoice->company_id
|
||||
);
|
||||
|
||||
if ($dueDateEnabled === 'YES') {
|
||||
$dueDateDays = intval(CompanySetting::getSetting(
|
||||
'invoice_due_date_days',
|
||||
$invoice->company_id
|
||||
));
|
||||
$dueDate = Carbon::now()->addDays($dueDateDays)->format('Y-m-d');
|
||||
}
|
||||
|
||||
$exchangeRate = $invoice->exchange_rate;
|
||||
|
||||
$newInvoice = Invoice::create([
|
||||
'invoice_date' => $date->format('Y-m-d'),
|
||||
'due_date' => $dueDate,
|
||||
'invoice_number' => $serial->getNextNumber(),
|
||||
'sequence_number' => $serial->nextSequenceNumber,
|
||||
'customer_sequence_number' => $serial->nextCustomerSequenceNumber,
|
||||
'reference_number' => $invoice->reference_number,
|
||||
'customer_id' => $invoice->customer_id,
|
||||
'company_id' => $invoice->company_id,
|
||||
'template_name' => $invoice->template_name,
|
||||
'status' => Invoice::STATUS_DRAFT,
|
||||
'paid_status' => Invoice::STATUS_UNPAID,
|
||||
'sub_total' => $invoice->sub_total,
|
||||
'discount' => $invoice->discount,
|
||||
'discount_type' => $invoice->discount_type,
|
||||
'discount_val' => $invoice->discount_val,
|
||||
'total' => $invoice->total,
|
||||
'due_amount' => $invoice->total,
|
||||
'tax_per_item' => $invoice->tax_per_item,
|
||||
'discount_per_item' => $invoice->discount_per_item,
|
||||
'tax' => $invoice->tax,
|
||||
'notes' => $invoice->notes,
|
||||
'exchange_rate' => $exchangeRate,
|
||||
'base_total' => $invoice->total * $exchangeRate,
|
||||
'base_discount_val' => $invoice->discount_val * $exchangeRate,
|
||||
'base_sub_total' => $invoice->sub_total * $exchangeRate,
|
||||
'base_tax' => $invoice->tax * $exchangeRate,
|
||||
'base_due_amount' => $invoice->total * $exchangeRate,
|
||||
'currency_id' => $invoice->currency_id,
|
||||
'sales_tax_type' => $invoice->sales_tax_type,
|
||||
'sales_tax_address_type' => $invoice->sales_tax_address_type,
|
||||
]);
|
||||
|
||||
$newInvoice->unique_hash = Hashids::connection(Invoice::class)->encode($newInvoice->id);
|
||||
$newInvoice->save();
|
||||
|
||||
$invoice->load('items.taxes');
|
||||
$this->documentItemService->createItems($newInvoice, $invoice->items->toArray());
|
||||
|
||||
if ($invoice->taxes) {
|
||||
$this->documentItemService->createTaxes($newInvoice, $invoice->taxes->toArray());
|
||||
}
|
||||
|
||||
if ($invoice->fields()->exists()) {
|
||||
$customFields = [];
|
||||
|
||||
foreach ($invoice->fields as $data) {
|
||||
$customFields[] = [
|
||||
'id' => $data->custom_field_id,
|
||||
'value' => $data->defaultAnswer,
|
||||
];
|
||||
}
|
||||
|
||||
$newInvoice->addCustomFields($customFields);
|
||||
}
|
||||
|
||||
return $newInvoice;
|
||||
}
|
||||
|
||||
public function convertToEstimate(Invoice $invoice): Estimate
|
||||
{
|
||||
$invoice->load(['items', 'items.taxes', 'customer', 'taxes']);
|
||||
|
||||
$serial = (new SerialNumberService)
|
||||
->setModel(new Estimate)
|
||||
->setCompany($invoice->company_id)
|
||||
->setCustomer($invoice->customer_id)
|
||||
->setNextNumbers();
|
||||
|
||||
$exchangeRate = $invoice->exchange_rate;
|
||||
|
||||
$estimate = Estimate::create([
|
||||
'creator_id' => $invoice->creator_id,
|
||||
'estimate_date' => Carbon::now()->format('Y-m-d'),
|
||||
'expiry_date' => Carbon::now()->addDays(30)->format('Y-m-d'),
|
||||
'estimate_number' => $serial->getNextNumber(),
|
||||
'sequence_number' => $serial->nextSequenceNumber,
|
||||
'customer_sequence_number' => $serial->nextCustomerSequenceNumber,
|
||||
'reference_number' => $serial->getNextNumber(),
|
||||
'customer_id' => $invoice->customer_id,
|
||||
'company_id' => $invoice->company_id,
|
||||
'template_name' => $invoice->getEstimateTemplateName(),
|
||||
'status' => Estimate::STATUS_DRAFT,
|
||||
'sub_total' => $invoice->sub_total,
|
||||
'discount' => $invoice->discount,
|
||||
'discount_type' => $invoice->discount_type,
|
||||
'discount_val' => $invoice->discount_val,
|
||||
'total' => $invoice->total,
|
||||
'tax_per_item' => $invoice->tax_per_item,
|
||||
'discount_per_item' => $invoice->discount_per_item,
|
||||
'tax' => $invoice->tax,
|
||||
'notes' => $invoice->notes,
|
||||
'exchange_rate' => $exchangeRate,
|
||||
'base_discount_val' => $invoice->discount_val * $exchangeRate,
|
||||
'base_sub_total' => $invoice->sub_total * $exchangeRate,
|
||||
'base_total' => $invoice->total * $exchangeRate,
|
||||
'base_tax' => $invoice->tax * $exchangeRate,
|
||||
'currency_id' => $invoice->currency_id,
|
||||
'sales_tax_type' => $invoice->sales_tax_type,
|
||||
'sales_tax_address_type' => $invoice->sales_tax_address_type,
|
||||
]);
|
||||
|
||||
$estimate->unique_hash = Hashids::connection(Estimate::class)->encode($estimate->id);
|
||||
$estimate->save();
|
||||
|
||||
$this->documentItemService->createItems($estimate, $invoice->items->toArray());
|
||||
|
||||
if ($invoice->taxes) {
|
||||
$this->documentItemService->createTaxes($estimate, $invoice->taxes->toArray());
|
||||
}
|
||||
|
||||
if ($invoice->fields()->exists()) {
|
||||
$customFields = [];
|
||||
|
||||
foreach ($invoice->fields as $data) {
|
||||
$customFields[] = [
|
||||
'id' => $data->custom_field_id,
|
||||
'value' => $data->defaultAnswer,
|
||||
];
|
||||
}
|
||||
|
||||
$estimate->addCustomFields($customFields);
|
||||
}
|
||||
|
||||
return $estimate;
|
||||
}
|
||||
|
||||
public function changeStatus(Invoice $invoice, string $status): void
|
||||
{
|
||||
if ($status == Invoice::STATUS_SENT) {
|
||||
$invoice->status = Invoice::STATUS_SENT;
|
||||
$invoice->sent = true;
|
||||
$invoice->save();
|
||||
} elseif ($status == Invoice::STATUS_COMPLETED) {
|
||||
$invoice->status = Invoice::STATUS_COMPLETED;
|
||||
$invoice->paid_status = Invoice::STATUS_PAID;
|
||||
$invoice->due_amount = 0;
|
||||
$invoice->save();
|
||||
}
|
||||
}
|
||||
}
|
||||
Reference in New Issue
Block a user