Files
ladill-pos/app/Models/PosSale.php
T
isaaccladandClaude Opus 4.8 9780591e74
Deploy Ladill POS / deploy (push) Successful in 36s
Split bills + kitchen ingest for online orders
Split bills (restaurant tickets):
- New pos_payments ledger; a tab is settled across one or more cash/Ladill Pay
  payments. The ticket shows total / paid / balance, an amount field with Full /
  ½ / ⅓ / ¼ helpers, and the payments taken. Partial payments keep the tab open;
  the sale finalises (and frees the table) only when the balance hits zero.
  Pay splits get their own checkout + callback (pos.payments.callback).

Pipe online orders to the KDS:
- POST /api/kitchen/orders — a first-party, service-keyed ingest
  (config pos.kitchen_api_keys, scoped by owner, idempotent by external_ref) that
  creates a paid, already-fired ticket (order_type=online, lines source=online).
- The KDS feed is now payment-agnostic (any kitchen-active sale), so paid online
  orders sit on the board next to dine-in tabs and bump the same way; they're
  badged "online".

Schema additive: pos_payments, pos_sales.external_ref. Suite green (14).

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-06-24 23:49:01 +00:00

133 lines
3.1 KiB
PHP

<?php
namespace App\Models;
use Illuminate\Database\Eloquent\Builder;
use Illuminate\Database\Eloquent\Model;
use Illuminate\Database\Eloquent\Relations\BelongsTo;
use Illuminate\Database\Eloquent\Relations\HasMany;
class PosSale extends Model
{
public const STATUS_PENDING = 'pending';
public const STATUS_PAID = 'paid';
public const STATUS_FAILED = 'failed';
public const STATUS_CANCELLED = 'cancelled';
public const METHOD_PAY = 'pay';
public const METHOD_CASH = 'cash';
public const ORDER_COUNTER = 'counter';
public const ORDER_DINE_IN = 'dine_in';
public const ORDER_TAKEAWAY = 'takeaway';
public const KITCHEN_NONE = 'none';
public const KITCHEN_ACTIVE = 'active';
public const KITCHEN_SERVED = 'served';
protected $fillable = [
'owner_ref',
'location_id',
'table_id',
'reference',
'external_ref',
'status',
'payment_method',
'order_type',
'kitchen_status',
'covers',
'notes',
'pay_order_id',
'payment_reference',
'customer_name',
'customer_email',
'customer_phone',
'crm_customer_id',
'subtotal_minor',
'total_minor',
'currency',
'paid_at',
'opened_at',
'kitchen_sent_at',
'closed_at',
];
protected function casts(): array
{
return [
'subtotal_minor' => 'integer',
'total_minor' => 'integer',
'pay_order_id' => 'integer',
'crm_customer_id' => 'integer',
'covers' => 'integer',
'paid_at' => 'datetime',
'opened_at' => 'datetime',
'kitchen_sent_at' => 'datetime',
'closed_at' => 'datetime',
];
}
public function location(): BelongsTo
{
return $this->belongsTo(PosLocation::class, 'location_id');
}
public function table(): BelongsTo
{
return $this->belongsTo(PosTable::class, 'table_id');
}
public function payments(): HasMany
{
return $this->hasMany(PosPayment::class);
}
public function paidMinor(): int
{
return (int) $this->payments()->where('status', PosPayment::STATUS_PAID)->sum('amount_minor');
}
public function balanceMinor(): int
{
return max(0, (int) $this->total_minor - $this->paidMinor());
}
public function isOpen(): bool
{
return $this->status === self::STATUS_PENDING;
}
public function isDineIn(): bool
{
return $this->order_type === self::ORDER_DINE_IN;
}
public function scopeOpenTickets(Builder $query): Builder
{
return $query->where('status', self::STATUS_PENDING);
}
public function lines(): HasMany
{
return $this->hasMany(PosSaleLine::class)->orderBy('position');
}
public function isPaid(): bool
{
return $this->status === self::STATUS_PAID;
}
public function scopeOwned(Builder $query, string $ownerRef): Builder
{
return $query->where('owner_ref', $ownerRef);
}
}