Files
portal-api/app/Http/Controllers/Api/Admin/Invoice/InvoiceController.php
T
2026-09-09 16:56:22 +07:00

448 lines
16 KiB
PHP

<?php
namespace App\Http\Controllers\Api\Admin\Invoice;
use App\Enums\Invoice\InvoiceStatus;
use App\Helpers\OrderHelper;
use App\Http\Controllers\Controller;
use App\Http\Requests\InvoiceRequest;
use App\Http\Resources\Api\Admin\InvoiceResource;
use App\Mail\InvoiceNotificationMail;
use App\Models\Customer;
use App\Models\Invoice;
use App\Models\InvoiceItem;
use App\Models\Order;
use App\Models\Payment;
use App\Repositories\Invoice\InvoiceRepositoryInterface;
use App\Repositories\InvoiceAttachment\InvoiceAttachmentRepositoryInterface;
use App\Repositories\InvoiceItem\InvoiceItemRepositoryInterface;
use App\Services\InvoicePaymentService;
use App\Services\InvoicePdfService;
use Illuminate\Http\JsonResponse;
use Illuminate\Http\Request;
use Illuminate\Support\Facades\DB;
use Illuminate\Support\Facades\Log;
use Illuminate\Support\Facades\Mail;
use Illuminate\Support\Facades\Storage;
use Throwable;
use Yajra\DataTables\Facades\DataTables;
class InvoiceController extends Controller
{
public function __construct(
private readonly InvoiceRepositoryInterface $invoiceRepository,
private readonly InvoiceItemRepositoryInterface $invoiceItemRepository,
private readonly InvoiceAttachmentRepositoryInterface $attachmentRepository,
private readonly InvoicePdfService $invoicePdfService,
private readonly InvoicePaymentService $invoicePaymentService,
) {}
public function index(Request $request): JsonResponse
{
$query = $this->invoiceRepository->filter(
$request->all(),
['payment', 'customer', 'order'],
[],
['*'],
true
);
return response()->json([
'error' => false,
'data' => [
'items' => InvoiceResource::collection($query->get())->resolve(),
'total' => $query->count(),
],
]);
}
public function datatable(Request $request): JsonResponse
{
$query = $this->invoiceRepository->filter(
$request->all(),
['payment', 'customer', 'order'],
[],
['*'],
true
);
return DataTables::eloquent($query)
->addColumn('invoice_number', fn($d) => $d->invoice_number)
->addColumn('date', fn($d) => $d->date)
->addColumn('customer', fn($d) => $d->customer?->fullname)
->addColumn('payment', fn($d) => $d->payment?->name)
->addColumn('total', fn($d) => $d->total)
->addColumn('status', fn($d) => $d->status)
->addColumn('action', fn($d) => $d->id)
->rawColumns(['invoice_number', 'date', 'customer', 'payment', 'total', 'status', 'action'])
->make(true);
}
/**
* Admin tạo thêm 1 invoice thủ công cho 1 order đã tồn tại — chỉ dùng cho phụ
* phí/điều chỉnh thuộc CHÍNH dịch vụ trong order đó (vd. phạt trễ hạn, phí xử lý).
* Order cố định: không dùng endpoint này để bán thêm dịch vụ mới — dịch vụ mới phải
* là 1 Order riêng (qua OrderController::store). Đi qua cùng convention với renewal
* invoice ở nơi khác trong codebase: gắn order_id vào order gốc, tự sinh invoice_number.
*/
public function store(Request $request): JsonResponse
{
$validated = $request->validate([
'order_id' => 'required|integer|exists:orders,id',
'invoice_type' => 'nullable|integer|in:1,2,3',
'description' => 'nullable|string|max:500',
'due_date' => 'nullable|date',
'sub_total' => 'required|numeric|min:0',
'tax' => 'nullable|numeric|min:0',
]);
$order = Order::find($validated['order_id']);
$subTotal = (int) $validated['sub_total'];
$tax = (int) ($validated['tax'] ?? 0);
$total = $subTotal + $tax;
try {
$invoice = DB::transaction(function () use ($order, $validated, $subTotal, $tax, $total) {
$invoice = Invoice::create([
'invoice_number' => OrderHelper::generateOrderNumber('INV'),
'customer_id' => $order->customer_id,
'order_id' => $order->id,
'invoice_type' => $validated['invoice_type'] ?? 3,
'sub_total' => $subTotal,
'discount_amount' => 0,
'tax' => $tax,
'total' => $total,
'status' => InvoiceStatus::UNPAID->value,
'due_date' => $validated['due_date'] ?? now()->addDays(7)->toDateString(),
]);
InvoiceItem::create([
'invoice_id' => $invoice->id,
'type' => 'service',
'description' => $validated['description'] ?: 'Hóa đơn bổ sung',
'months' => 0,
'quantity' => 1,
'unit_price' => $subTotal,
'total_price' => $subTotal,
]);
return $invoice;
});
return response()->json([
'error' => false,
'message' => 'Đã tạo hóa đơn',
'data' => new InvoiceResource($invoice->load('invoiceItems')),
], 201);
} catch (\Exception $e) {
return response()->json([
'error' => true,
'message' => $e->getMessage()
], 500);
}
}
public function show(int $id): JsonResponse
{
$invoice = $this->invoiceRepository->findWithRelationships($id, ['payment', 'invoiceItem', 'customer']);
if (!$invoice) {
return response()->json([
'error' => true,
'message' => "Can't find invoice by ID #" . $id
], 404);
}
return response()->json([
'error' => false,
'data' => new InvoiceResource($invoice)
]);
}
public function update(InvoiceRequest $request, int $id): JsonResponse
{
$invoice = $this->invoiceRepository->find($id);
if (!$invoice) {
return response()->json([
'error' => true,
'message' => "Can't find invoice by ID #" . $id
], 404);
}
$request->validated();
$action = strtolower((string) $request->get('action'));
$status = match ($action) {
'paid' => InvoiceStatus::PAID->value,
'cancel' => InvoiceStatus::CANCELLED->value,
default => null,
};
if ($status === null) {
return response()->json([
'error' => true,
'message' => 'Invalid invoice action.',
], 422);
}
try {
DB::beginTransaction();
$invoice->load(['order', 'customer']);
if ($status === InvoiceStatus::PAID->value) {
$this->invoicePaymentService->markPaidByAdmin($invoice, auth()->id());
} else {
$invoice->update([
'status' => $status,
'paid_at' => null,
]);
}
DB::commit();
return response()->json([
'error' => false,
'message' => 'Invoice updated successfully'
]);
} catch (\Exception $e) {
DB::rollBack();
return response()->json([
'error' => true,
'message' => $e->getMessage()
], 500);
}
}
public function destroy(int $id): JsonResponse
{
$invoice = $this->invoiceRepository->find($id);
if (!$invoice) {
return response()->json([
'error' => true,
'message' => "Can't find invoice by ID #" . $id
], 404);
}
try {
// Note: `orders` has no `invoice_id` column (the FK runs the other way —
// invoices.order_id -> orders.id), so there's nothing to clean up there. Any
// `services.invoice_id` pointing at this invoice is already handled by the
// FK's onDelete('set null').
$this->invoiceRepository->delete($id);
return response()->json([
'error' => false,
'message' => 'Invoice deleted successfully'
]);
} catch (\Exception $e) {
return response()->json([
'error' => true,
'message' => $e->getMessage()
], 500);
}
}
public function markAsPaid(int $id): JsonResponse
{
$invoice = $this->invoiceRepository->find($id);
if (!$invoice) {
return response()->json([
'error' => true,
'message' => "Can't find invoice by ID #" . $id
], 404);
}
try {
DB::beginTransaction();
$invoice->load(['order', 'customer']);
$this->invoicePaymentService->markPaidByAdmin($invoice, auth()->id());
DB::commit();
return response()->json([
'error' => false,
'message' => 'Invoice marked as paid'
]);
} catch (\Exception $e) {
DB::rollBack();
return response()->json([
'error' => true,
'message' => $e->getMessage()
], 500);
}
}
public function cancel(int $id): JsonResponse
{
$invoice = $this->invoiceRepository->find($id);
if (!$invoice) {
return response()->json([
'error' => true,
'message' => "Can't find invoice by ID #" . $id
], 404);
}
try {
DB::beginTransaction();
$invoice->update([
'status' => InvoiceStatus::CANCELLED->value,
'paid_at' => null
]);
DB::commit();
return response()->json([
'error' => false,
'message' => 'Invoice cancelled'
]);
} catch (\Exception $e) {
DB::rollBack();
return response()->json([
'error' => true,
'message' => $e->getMessage()
], 500);
}
}
// ─── Attachments ────────────────────────────────────────────────────────────
public function listAttachments(int $id): JsonResponse
{
$invoice = $this->invoiceRepository->find($id);
if (!$invoice) {
return response()->json(['error' => true, 'message' => "Can't find invoice #$id"], 404);
}
$attachments = $this->attachmentRepository->getByInvoice($id);
return response()->json([
'error' => false,
'data' => $attachments,
]);
}
public function uploadAttachment(Request $request, int $id): JsonResponse
{
$invoice = $this->invoiceRepository->find($id);
if (!$invoice) {
return response()->json(['error' => true, 'message' => "Can't find invoice #$id"], 404);
}
$request->validate([
'file' => 'required|file|mimes:jpg,jpeg,png,gif,pdf,doc,docx,xls,xlsx|max:10240',
]);
$file = $request->file('file');
$path = $file->store("invoice-attachments/{$id}", 'public');
$uploader = $request->user()?->username ?? $request->user()?->name ?? 'admin';
$attachment = $this->attachmentRepository->create([
'invoice_id' => $id,
'filename' => $file->getClientOriginalName(),
'path' => $path,
'disk' => 'public',
'mime_type' => $file->getMimeType(),
'size' => $file->getSize(),
'uploaded_by' => $uploader,
]);
return response()->json([
'error' => false,
'message' => 'File uploaded successfully',
'data' => $attachment,
], 201);
}
public function deleteAttachment(int $id, int $attachmentId): JsonResponse
{
$invoice = $this->invoiceRepository->find($id);
if (!$invoice) {
return response()->json(['error' => true, 'message' => "Can't find invoice #$id"], 404);
}
$attachment = $this->attachmentRepository->find($attachmentId);
if (!$attachment || $attachment->invoice_id !== $id) {
return response()->json(['error' => true, 'message' => 'Attachment not found'], 404);
}
$this->attachmentRepository->deleteWithFile($attachmentId);
return response()->json([
'error' => false,
'message' => 'Attachment deleted',
]);
}
// ─── Send Mail ───────────────────────────────────────────────────────────────
public function sendMail(Request $request, int $id): JsonResponse
{
$request->validate([
'message' => 'nullable|string|max:1000',
'type' => 'nullable|string|in:invoice,renewal',
]);
$invoice = $this->invoiceRepository->find($id);
if (!$invoice) {
return response()->json(['error' => true, 'message' => "Can't find invoice #$id"], 404);
}
$invoice->load('customer');
$customer = $invoice->customer;
if (!$customer || !$customer->email) {
return response()->json(['error' => true, 'message' => 'Customer email not found'], 422);
}
$attachments = $this->attachmentRepository->getByInvoice($id);
$companyName = setting('general.company_name') ?: config('app.name');
$type = $request->get('type', 'invoice');
$message = $request->get(
'message',
$type === 'renewal'
? "Dịch vụ của quý khách sắp đến hạn gia hạn. Vui lòng kiểm tra hóa đơn #{$invoice->order_num} được đính kèm và hoàn tất thanh toán để dịch vụ không bị gián đoạn."
: "Vui lòng xem thông tin hóa đơn #{$invoice->order_num} của bạn."
);
$paymentUrl = url('/client/invoices/' . $invoice->invoice_number . '/payment');
try {
$invoicePdf = $this->invoicePdfService->generate($invoice);
$invoicePdfFileName = $this->invoicePdfService->generateFileName($invoice);
Mail::to($customer->email)->send(
new InvoiceNotificationMail(
$invoice,
$attachments,
$customer->fullname,
$message,
$companyName,
$type,
$invoicePdf,
$invoicePdfFileName,
$paymentUrl
)
);
} catch (Throwable $e) {
Log::error('InvoiceController@sendMail failed', [
'invoice_id' => $id,
'invoice_number' => $invoice->invoice_number ?? null,
'customer_email' => $customer->email,
'type' => $type,
'error' => $e->getMessage(),
]);
return response()->json([
'error' => true,
'message' => 'Không thể gửi email: ' . $e->getMessage(),
], 500);
}
return response()->json([
'error' => false,
'message' => "Email đã được gửi tới {$customer->email}",
]);
}
}