feat(portal): lead module, WHMCS sync report/contacts/mapping, service lifecycle email templates

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
This commit is contained in:
baodev0
2026-10-21 16:55:19 +07:00
co-authored by Claude Sonnet 5.5
parent 3c7710f1de
commit a443ec3bf6
66 changed files with 2032 additions and 124 deletions
@@ -0,0 +1,97 @@
<?php
namespace Modules\Lead\App\Http\Controllers\Api\Admin;
use App\Http\Controllers\Controller;
use Illuminate\Http\JsonResponse;
use Illuminate\Http\Request;
use Illuminate\Validation\Rule;
use Modules\Lead\App\Http\Requests\LeadRequest;
use Modules\Lead\App\Http\Resources\LeadResource;
use Modules\Lead\App\Models\Lead;
class LeadController extends Controller
{
public function index(Request $request): JsonResponse
{
$leads = Lead::query()
->with('customer:id,uuid,fullname,email')
->search($request->input('filter'))
->when($request->filled('status'), fn ($query) => $query->where('status', $request->input('status')))
->when($request->filled('source'), fn ($query) => $query->where('source', $request->input('source')))
->when($request->input('linked') === '1', fn ($query) => $query->whereNotNull('customer_id'))
->when($request->input('linked') === '0', fn ($query) => $query->whereNull('customer_id'))
->orderByDesc('id')
->paginate(min(max((int) $request->input('per_page', 20), 1), 100));
return response()->json([
'error' => false,
'data' => [
'items' => LeadResource::collection($leads->items()),
'total' => $leads->total(),
'per_page' => $leads->perPage(),
'current_page' => $leads->currentPage(),
'last_page' => $leads->lastPage(),
],
]);
}
public function show(string $uuid): JsonResponse
{
return response()->json(['error' => false, 'data' => new LeadResource($this->find($uuid)->load('customer:id,uuid,fullname,email'))]);
}
public function store(LeadRequest $request): JsonResponse
{
$lead = Lead::create($request->validated());
return response()->json(['error' => false, 'message' => 'Đã thêm khách tiềm năng.', 'data' => new LeadResource($lead->load('customer:id,uuid,fullname,email'))], 201);
}
public function update(string $uuid, LeadRequest $request): JsonResponse
{
$lead = $this->find($uuid);
$lead->update($request->validated());
return response()->json(['error' => false, 'message' => 'Đã cập nhật khách tiềm năng.', 'data' => new LeadResource($lead->load('customer:id,uuid,fullname,email'))]);
}
public function destroy(string $uuid): JsonResponse
{
$this->find($uuid)->delete();
return response()->json(['error' => false, 'message' => 'Đã xoá khách tiềm năng.']);
}
public function bulkDestroy(Request $request): JsonResponse
{
$uuids = $this->bulkUuids($request);
$deleted = Lead::query()->whereIn('uuid', $uuids)->delete();
return response()->json(['error' => false, 'message' => "Đã xoá {$deleted} khách tiềm năng.", 'data' => ['affected' => $deleted]]);
}
public function bulkStatus(Request $request): JsonResponse
{
$status = $request->validate(['status' => ['required', Rule::in(Lead::STATUSES)]])['status'];
$updated = Lead::query()->whereIn('uuid', $this->bulkUuids($request))->update(['status' => $status, 'updated_at' => now()]);
return response()->json(['error' => false, 'message' => "Đã cập nhật trạng thái cho {$updated} khách tiềm năng.", 'data' => ['affected' => $updated]]);
}
/**
* @return array<int, string>
*/
private function bulkUuids(Request $request): array
{
return $request->validate([
'uuids' => ['required', 'array', 'min:1', 'max:500'],
'uuids.*' => ['required', 'string', 'max:36'],
])['uuids'];
}
private function find(string $uuid): Lead
{
return Lead::query()->where('uuid', $uuid)->firstOrFail();
}
}
@@ -0,0 +1,49 @@
<?php
namespace Modules\Lead\App\Http\Requests;
use Illuminate\Foundation\Http\FormRequest;
use Illuminate\Validation\Rule;
use Modules\Lead\App\Models\Lead;
class LeadRequest extends FormRequest
{
public function authorize(): bool
{
return true;
}
public function rules(): array
{
return [
'fullname' => ['nullable', 'string', 'max:255'],
'company' => ['nullable', 'string', 'max:255'],
'email' => ['required', 'email', 'max:255', Rule::unique('leads', 'email')->ignore($this->route('uuid'), 'uuid')],
'phone' => ['nullable', 'string', 'max:30'],
'address' => ['nullable', 'string', 'max:1000'],
'status' => ['nullable', Rule::in(Lead::STATUSES)],
'customer_id' => ['nullable', 'integer', 'exists:customers,id'],
'receives_invoice_emails' => ['nullable', 'boolean'],
'receives_domain_emails' => ['nullable', 'boolean'],
'receives_support_emails' => ['nullable', 'boolean'],
'receives_product_emails' => ['nullable', 'boolean'],
'receives_general_emails' => ['nullable', 'boolean'],
'note' => ['nullable', 'string', 'max:5000'],
];
}
public function messages(): array
{
return [
'email.required' => 'Email là bắt buộc.',
'email.unique' => 'Email này đã có trong danh sách khách tiềm năng.',
];
}
protected function prepareForValidation(): void
{
if ($this->has('email')) {
$this->merge(['email' => strtolower(trim((string) $this->input('email')))]);
}
}
}
@@ -0,0 +1,38 @@
<?php
namespace Modules\Lead\App\Http\Resources;
use Illuminate\Http\Request;
use Illuminate\Http\Resources\Json\JsonResource;
class LeadResource extends JsonResource
{
public function toArray(Request $request): array
{
return [
'uuid' => $this->uuid,
'fullname' => $this->fullname,
'company' => $this->company,
'email' => $this->email,
'phone' => $this->phone,
'address' => $this->address,
'source' => $this->source,
'status' => $this->status,
'whmcs_client_id' => $this->whmcs_client_id,
'receives_invoice_emails' => $this->receives_invoice_emails,
'receives_domain_emails' => $this->receives_domain_emails,
'receives_support_emails' => $this->receives_support_emails,
'receives_product_emails' => $this->receives_product_emails,
'receives_general_emails' => $this->receives_general_emails,
'note' => $this->note,
'customer' => $this->whenLoaded('customer', fn () => $this->customer ? [
'id' => $this->customer->id,
'uuid' => $this->customer->uuid,
'fullname' => $this->customer->fullname,
'email' => $this->customer->email,
] : null),
'created_at' => $this->created_at,
'updated_at' => $this->updated_at,
];
}
}