Bagisto电商系统中发票逾期提醒邮件的实现方案

2025-05-12 01:45:51作者：龚格成

背景介绍

在Bagisto电商系统中，发票管理是一个重要功能模块。系统需要向客户发送发票逾期提醒邮件，以提醒客户及时支付未结清的发票款项。然而在代码审查过程中，发现系统虽然设计了发票逾期提醒功能，但关键的邮件类和视图文件却缺失了。

问题分析

Bagisto系统使用Laravel的邮件队列功能来发送发票逾期提醒。在InvoiceReminder这个trait中，系统调用了Mail::queue(new InvoiceOverdueReminder($customer, $this))来发送邮件。但实际开发中，InvoiceOverdueReminder这个邮件类及其对应的视图文件并未被创建。

技术实现方案

1. 创建邮件类

首先需要创建一个新的邮件类InvoiceOverdueReminder，继承自Laravel的Mailable类。这个类需要接收两个参数：客户对象和发票对象。

namespace Webkul\Admin\Mail;

use Illuminate\Bus\Queueable;
use Illuminate\Mail\Mailable;
use Illuminate\Queue\SerializesModels;

class InvoiceOverdueReminder extends Mailable
{
    use Queueable, SerializesModels;
    
    public $customer;
    public $invoice;
    
    public function __construct($customer, $invoice)
    {
        $this->customer = $customer;
        $this->invoice = $invoice;
    }
    
    public function build()
    {
        return $this->to($this->customer->email)
            ->subject(trans('admin::app.mail.invoice.reminder.subject'))
            ->view('admin::emails.invoice.reminder');
    }
}

2. 创建邮件视图文件

在resources/themes/default/views/admin/emails/invoice目录下创建reminder.blade.php视图文件。这个视图应该包含以下内容：

发票基本信息（发票号、日期、金额等）
逾期天数或逾期状态
支付方式说明
联系信息

@extends('admin::emails.layouts.master')

@section('content')
    <div style="padding: 30px;">
        <h2>{{ trans('admin::app.mail.invoice.reminder.title') }}</h2>
        
        <p>{{ trans('admin::app.mail.invoice.reminder.greeting', ['name' => $customer->name]) }}</p>
        
        <p>{{ trans('admin::app.mail.invoice.reminder.message') }}</p>
        
        <table style="width: 100%; margin: 20px 0;">
            <tr>
                <td style="font-weight: bold;">{{ trans('admin::app.mail.invoice.reminder.invoice-number') }}</td>
                <td>{{ $invoice->invoice_id }}</td>
            </tr>
            <tr>
                <td style="font-weight: bold;">{{ trans('admin::app.mail.invoice.reminder.due-date') }}</td>
                <td>{{ $invoice->due_date }}</td>
            </tr>
            <tr>
                <td style="font-weight: bold;">{{ trans('admin::app.mail.invoice.reminder.amount-due') }}</td>
                <td>{{ core()->formatPrice($invoice->grand_total, $invoice->order->order_currency_code) }}</td>
            </tr>
        </table>
        
        <p>{{ trans('admin::app.mail.invoice.reminder.payment-instruction') }}</p>
        
        <div style="margin: 30px 0; text-align: center;">
            <a href="{{ route('customer.invoice.view', $invoice->id) }}" 
               style="padding: 10px 20px; background: #0041FF; color: #ffffff; text-decoration: none;">
                {{ trans('admin::app.mail.invoice.reminder.pay-now') }}
            </a>
        </div>
        
        <p>{{ trans('admin::app.mail.invoice.reminder.contact-us') }}</p>
    </div>
@endsection

3. 添加多语言支持

在语言文件中添加相应的翻译键值对，确保邮件内容可以支持多语言显示。需要在resources/lang/en/admin.php和其他语言文件中添加以下内容：

'mail' => [
    'invoice' => [
        'reminder' => [
            'title' => 'Invoice Payment Reminder',
            'greeting' => 'Dear :name,',
            'message' => 'This is a reminder that your invoice is overdue for payment.',
            'invoice-number' => 'Invoice Number',
            'due-date' => 'Due Date',
            'amount-due' => 'Amount Due',
            'payment-instruction' => 'Please make the payment at your earliest convenience to avoid any late fees or service interruptions.',
            'pay-now' => 'Pay Now',
            'contact-us' => 'If you have any questions about this invoice, please contact our support team.',
            'subject' => 'Reminder: Invoice #:invoice_number is overdue',
        ],
    ],
],