add projet
This commit is contained in:
root
Executable
+298
@@ -0,0 +1,298 @@
|
||||
<?php
|
||||
|
||||
namespace App\Models;
|
||||
|
||||
use App\Models\BaseModel;
|
||||
|
||||
class Invoice extends BaseModel
|
||||
{
|
||||
protected $table = 'invoices';
|
||||
protected $primaryKey = 'id';
|
||||
protected $fillable = [
|
||||
'parent_id',
|
||||
'invoice_number',
|
||||
'total_amount',
|
||||
'balance',
|
||||
'paid_amount',
|
||||
'has_discount',
|
||||
'issue_date',
|
||||
'due_date',
|
||||
'status',
|
||||
'description',
|
||||
'school_year',
|
||||
'created_at',
|
||||
'updated_at',
|
||||
'updated_by',
|
||||
'semester',
|
||||
];
|
||||
|
||||
// Your table handles timestamps (defaults/triggers), keep CI auto off
|
||||
public $timestamps = true;
|
||||
|
||||
// --- Validate as DATETIME strings like "YYYY-MM-DD HH:MM:SS" ---
|
||||
protected $validationRules = [
|
||||
// allow update without tripping uniqueness
|
||||
'invoice_number' => 'required|is_unique[invoices.invoice_number,id,{id}]',
|
||||
'total_amount' => 'required|decimal',
|
||||
'balance' => 'permit_empty|decimal',
|
||||
'issue_date' => 'required|valid_date[Y-m-d H:i:s]',
|
||||
'due_date' => 'permit_empty|valid_date[Y-m-d H:i:s]',
|
||||
'status' => 'required|string|max_length[50]',
|
||||
];
|
||||
|
||||
|
||||
protected $validationMessages = [
|
||||
'invoice_number' => [
|
||||
'required' => 'The invoice number is required.',
|
||||
'is_unique' => 'The invoice number must be unique.',
|
||||
],
|
||||
'total_amount' => [
|
||||
'required' => 'The total amount is required.',
|
||||
'decimal' => 'The total amount must be a valid decimal.',
|
||||
],
|
||||
'balance' => [
|
||||
'decimal' => 'The balance must be a valid decimal.',
|
||||
],
|
||||
'issue_date' => [
|
||||
'required' => 'The issue date is required.',
|
||||
'valid_date' => 'The issue date must be a valid datetime (YYYY-MM-DD HH:MM:SS).',
|
||||
],
|
||||
'due_date' => [
|
||||
'valid_date' => 'The due date must be a valid datetime (YYYY-MM-DD HH:MM:SS).',
|
||||
],
|
||||
'status' => [
|
||||
'required' => 'The status is required.',
|
||||
'max_length' => 'The status must not exceed 50 characters.',
|
||||
],
|
||||
];
|
||||
|
||||
// --- Normalize any incoming date/datetime into UTC 'Y-m-d H:i:s' ---
|
||||
protected $beforeInsert = ['normalizeDateTimes'];
|
||||
protected $beforeUpdate = ['normalizeDateTimes'];
|
||||
|
||||
protected function normalizeDateTimes(array $data): array
|
||||
{
|
||||
foreach (['issue_date', 'due_date', 'created_at', 'updated_at'] as $field) {
|
||||
if (array_key_exists($field, $data['data'])) {
|
||||
$val = $data['data'][$field];
|
||||
if ($val === null || $val === '' || $val === '0000-00-00' || $val === '0000-00-00 00:00:00') {
|
||||
// keep NULL/empty for nullable fields
|
||||
$data['data'][$field] = ($field === 'due_date') ? null : $val;
|
||||
continue;
|
||||
}
|
||||
$normalized = $this->toUtcDateTimeString($val);
|
||||
if ($normalized !== null) {
|
||||
$data['data'][$field] = $normalized;
|
||||
}
|
||||
// else leave as-is; validation will catch invalid format
|
||||
}
|
||||
}
|
||||
return $data;
|
||||
}
|
||||
|
||||
private function toUtcDateTimeString($raw): ?string
|
||||
{
|
||||
if ($raw instanceof \DateTimeInterface) {
|
||||
$dt = (new \DateTimeImmutable('@' . $raw->getTimestamp()))
|
||||
->setTimezone(new \DateTimeZone('UTC'));
|
||||
return $dt->format('Y-m-d H:i:s');
|
||||
}
|
||||
|
||||
$s = trim((string) $raw);
|
||||
if ($s === '') return null;
|
||||
|
||||
// Try strict formats first
|
||||
$utc = new \DateTimeZone('UTC');
|
||||
|
||||
$dt = \DateTime::createFromFormat('Y-m-d H:i:s', $s, $utc);
|
||||
if ($dt !== false) {
|
||||
$dt->setTimezone($utc);
|
||||
return $dt->format('Y-m-d H:i:s');
|
||||
}
|
||||
|
||||
$d = \DateTime::createFromFormat('Y-m-d', $s, $utc);
|
||||
if ($d !== false) {
|
||||
// If date-only sneaks in, store at 12:00:00 to avoid boundary confusion
|
||||
$d->setTime(12, 0, 0);
|
||||
$d->setTimezone($utc);
|
||||
return $d->format('Y-m-d H:i:s');
|
||||
}
|
||||
|
||||
// Fallback parser (may accept ISO8601, etc.)
|
||||
try {
|
||||
$flex = new \DateTime($s);
|
||||
$flex->setTimezone($utc);
|
||||
return $flex->format('Y-m-d H:i:s');
|
||||
} catch (\Throwable $e) {
|
||||
return null;
|
||||
}
|
||||
}
|
||||
|
||||
// ----------------------- Queries -----------------------
|
||||
|
||||
public function getInvoicesByUserId($userId, $schoolYear = null)
|
||||
{
|
||||
$builder = $this->where('parent_id', $userId);
|
||||
if ($schoolYear !== null) {
|
||||
$builder->where('school_year', $schoolYear);
|
||||
}
|
||||
return $builder->findAll();
|
||||
}
|
||||
|
||||
public function updateInvoiceStatus($invoiceId, $status)
|
||||
{
|
||||
return $this->update($invoiceId, ['status' => $status]);
|
||||
}
|
||||
|
||||
public function getUnpaidInvoices()
|
||||
{
|
||||
return $this->where('status', 'unpaid')
|
||||
->orderBy('due_date', 'ASC')
|
||||
->findAll();
|
||||
}
|
||||
|
||||
public function getLatestInvoiceTotalAmount($parentId)
|
||||
{
|
||||
return $this->where('parent_id', $parentId)
|
||||
->orderBy('created_at', 'DESC')
|
||||
->select('total_amount')
|
||||
->get()
|
||||
->getRow('total_amount');
|
||||
}
|
||||
|
||||
public function getLatestInvoicePaidAmount($parentId)
|
||||
{
|
||||
return $this->where('parent_id', $parentId)
|
||||
->orderBy('created_at', 'DESC')
|
||||
->select('paid_amount')
|
||||
->get()
|
||||
->getRow('paid_amount');
|
||||
}
|
||||
|
||||
public function getLatestInvoiceBalance($parentId)
|
||||
{
|
||||
$invoice = $this->where('parent_id', $parentId)
|
||||
->orderBy('created_at', 'DESC')
|
||||
->select('balance')
|
||||
->get()
|
||||
->getRow();
|
||||
|
||||
return $invoice ? $invoice->balance : null;
|
||||
}
|
||||
|
||||
public function getInvoiceEventCharges($invoiceId)
|
||||
{
|
||||
return $this->db->table('invoice_event')
|
||||
->where('invoice_id', $invoiceId)
|
||||
->get()
|
||||
->getResultArray();
|
||||
}
|
||||
|
||||
public function getInvoicesByParentId($parentId, $schoolYear = null)
|
||||
{
|
||||
$builder = $this->where('parent_id', $parentId);
|
||||
if (!empty($schoolYear)) {
|
||||
$builder->where('school_year', $schoolYear);
|
||||
}
|
||||
return $builder->orderBy('created_at', 'DESC')->findAll();
|
||||
}
|
||||
|
||||
public function getLatestInvoiceBalanceByYear($parentId, $schoolYear)
|
||||
{
|
||||
return $this->where('parent_id', $parentId)
|
||||
->where('school_year', $schoolYear)
|
||||
->orderBy('created_at', 'DESC')
|
||||
->select('total_amount, paid_amount, balance, updated_at')
|
||||
->get()
|
||||
->getRowArray();
|
||||
}
|
||||
|
||||
public function getDiscountedInvoicesByParent($parentId)
|
||||
{
|
||||
return $this->where('parent_id', $parentId)
|
||||
->where('has_discount', 1)
|
||||
->findAll();
|
||||
}
|
||||
|
||||
/* =======================
|
||||
* Query helpers
|
||||
* ======================= */
|
||||
|
||||
|
||||
/**
|
||||
* Multi-parent variant (useful when preloading for all parents).
|
||||
*/
|
||||
public function getInvoicesByUserIds(array $parentIds, string $schoolYear): array
|
||||
{
|
||||
if (empty($parentIds)) return [];
|
||||
return $this->select('id,parent_id,invoice_number,status,balance,total_amount,issue_date,due_date')
|
||||
->whereIn('parent_id', array_map('intval', $parentIds))
|
||||
->where('school_year', $schoolYear)
|
||||
->orderBy('issue_date', 'DESC')
|
||||
->orderBy('id', 'DESC')
|
||||
->findAll();
|
||||
}
|
||||
|
||||
/* =======================
|
||||
* Additional charge math
|
||||
* ======================= */
|
||||
|
||||
/**
|
||||
* Atomically add an extra amount to additional_charge (and optionally totals).
|
||||
* Adjust total_amount and balance too (comment out if you don't want that).
|
||||
*/
|
||||
public function applyAdditionalCharge(int $invoiceId, float $amount): bool
|
||||
{
|
||||
$val = number_format(abs($amount), 2, '.', '');
|
||||
$ok = $this->db->query(
|
||||
"UPDATE {$this->table}
|
||||
SET total_amount = total_amount + {$val},
|
||||
balance = balance + {$val}
|
||||
WHERE id = ?", [$invoiceId]
|
||||
);
|
||||
return $ok && $this->db->affectedRows() > 0;
|
||||
}
|
||||
|
||||
public function deductAdditionalCharge(int $invoiceId, float $amount): bool
|
||||
{
|
||||
$val = number_format(abs($amount), 2, '.', '');
|
||||
$ok = $this->db->query(
|
||||
"UPDATE {$this->table}
|
||||
SET total_amount = GREATEST(total_amount - {$val}, 0),
|
||||
balance = GREATEST(balance - {$val}, 0)
|
||||
WHERE id = ?", [$invoiceId]
|
||||
);
|
||||
return $ok && $this->db->affectedRows() > 0;
|
||||
}
|
||||
|
||||
|
||||
public function getAllInvoicesByUserIds(array $parentIds, string $schoolYear): array
|
||||
{
|
||||
if (empty($parentIds)) return [];
|
||||
$parentIds = array_map('intval', $parentIds);
|
||||
return $this->select('id, parent_id, invoice_number, status, balance, issue_date')
|
||||
->whereIn('parent_id', $parentIds)
|
||||
->where('school_year', $schoolYear)
|
||||
->orderBy('issue_date', 'DESC')
|
||||
->orderBy('id', 'DESC')
|
||||
->findAll();
|
||||
}
|
||||
|
||||
|
||||
|
||||
/**
|
||||
* Reverse an extra amount from additional_charge (and totals), never below 0.
|
||||
*/
|
||||
public function reverseAdditionalCharge(int $invoiceId, float $amount): bool
|
||||
{
|
||||
$amount = round($amount, 2);
|
||||
$tb = $this->db->table($this->table);
|
||||
$val = $this->db->escape($amount);
|
||||
return $tb->set('total_amount', "GREATEST(total_amount - $val, 0)", false)
|
||||
->set('balance', "GREATEST(balance - $val, 0)", false)
|
||||
->where('id', $invoiceId)
|
||||
->update();
|
||||
}
|
||||
|
||||
|
||||
}
|
||||
Reference in New Issue
Block a user