Files
ladill-pos/app/Http/Controllers/Pos/TicketController.php
T
isaaccladandClaude Opus 4.8 50b170b0af
Deploy Ladill POS / deploy (push) Successful in 35s
Restaurant mode Phase 2: menu depth — categories, stations, modifiers, courses
Builds on Phase 1 with the menu structure restaurants need:
- Menu setup page (restaurant mode): categories, kitchen stations, and modifier
  groups with options (price deltas).
- Products gain category, kitchen station, default course, and attached modifier
  groups (managed on the product form).
- Ordering: the ticket groups the catalog by category and, when a product has
  modifier groups, opens a picker (respects min/max select) for options + notes +
  course before adding. Effective price = base + modifier deltas (resolved
  server-side; client prices are never trusted).
- Fire-by-course: send the whole tab or just one course to the kitchen.
- KDS: filter by station; each item shows its station, course, modifiers and notes.

Schema additive (pos_categories, pos_stations, pos_modifier_groups, pos_modifiers,
product↔group pivot, pos_sale_line_modifiers; category/station/course columns on
products and lines). PosRestaurantTest covers modifiers, course and station routing;
suite green (11 passed).

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-06-24 19:58:57 +00:00

268 lines
9.6 KiB
PHP

<?php
namespace App\Http\Controllers\Pos;
use App\Http\Controllers\Controller;
use App\Http\Controllers\Pos\Concerns\ScopesToAccount;
use App\Models\PosProduct;
use App\Models\PosSale;
use App\Models\PosSaleLine;
use App\Services\Pos\PosLocationService;
use App\Services\Pos\PosSaleService;
use Illuminate\Http\JsonResponse;
use Illuminate\Http\RedirectResponse;
use Illuminate\Http\Request;
use Illuminate\View\View;
use RuntimeException;
class TicketController extends Controller
{
use ScopesToAccount;
public function __construct(private PosSaleService $sales, private PosLocationService $locations) {}
public function open(Request $request): RedirectResponse
{
$data = $request->validate([
'order_type' => ['required', 'in:dine_in,takeaway,counter'],
'table_id' => ['nullable', 'integer'],
'covers' => ['nullable', 'integer', 'min:1', 'max:99'],
]);
$merchant = ladill_account() ?? $request->user();
$location = $this->locations->ensureDefault($this->ownerRef($request));
try {
$sale = $this->sales->openTicket($merchant, [
'order_type' => $data['order_type'],
'table_id' => $data['table_id'] ?? null,
'covers' => $data['covers'] ?? null,
'location_id' => $location->id,
'currency' => $location->currency,
]);
} catch (RuntimeException $e) {
return back()->with('error', $e->getMessage());
}
return redirect()->route('pos.tickets.show', $sale);
}
public function show(Request $request, PosSale $sale): View
{
$this->authorizeOwner($request, $sale);
if (! $sale->isOpen()) {
return redirect()->route('pos.sales.show', $sale);
}
$owner = $this->ownerRef($request);
$sale->load('lines', 'table');
$products = PosProduct::owned($owner)->active()
->with(['category', 'modifierGroups.modifiers'])
->orderBy('name')->get();
return view('pos.tickets.show', [
'sale' => $sale,
'products' => $products->map(fn (PosProduct $p) => [
'id' => $p->id,
'name' => $p->name,
'price_minor' => $p->price_minor,
'category' => $p->category?->name,
'modifier_groups' => $p->modifierGroups->map(fn ($g) => [
'id' => $g->id,
'name' => $g->name,
'min' => $g->min_select,
'max' => $g->max_select,
'modifiers' => $g->modifiers->map(fn ($m) => [
'id' => $m->id, 'name' => $m->name, 'price_delta_minor' => $m->price_delta_minor,
])->values()->all(),
])->values()->all(),
])->values()->all(),
'categories' => $products->pluck('category.name')->filter()->unique()->values()->all(),
'courses' => PosSaleLine::COURSES,
'lines' => $this->lineData($sale),
]);
}
public function addLine(Request $request, PosSale $sale): JsonResponse
{
$this->authorizeOpen($request, $sale);
$data = $request->validate([
'product_id' => ['nullable', 'integer'],
'name' => ['nullable', 'string', 'max:200'],
'unit_price_minor' => ['nullable', 'integer', 'min:1'],
'quantity' => ['nullable', 'integer', 'min:1', 'max:999'],
'notes' => ['nullable', 'string', 'max:200'],
'course' => ['nullable', 'in:'.implode(',', array_keys(PosSaleLine::COURSES))],
'modifier_ids' => ['nullable', 'array'],
'modifier_ids.*' => ['integer'],
]);
$payload = [
'quantity' => $data['quantity'] ?? 1,
'notes' => $data['notes'] ?? null,
'course' => $data['course'] ?? null,
];
if (! empty($data['product_id'])) {
$product = PosProduct::owned($this->ownerRef($request))
->with('modifierGroups.modifiers')
->find($data['product_id']);
if (! $product) {
return response()->json(['message' => 'Unknown product.'], 422);
}
// Only modifiers that belong to this product's groups count.
$allowed = $product->modifierGroups->flatMap->modifiers->keyBy('id');
$chosen = collect($data['modifier_ids'] ?? [])
->map(fn ($id) => $allowed->get((int) $id))
->filter()
->values();
$payload['product_id'] = $product->id;
$payload['name'] = $product->name;
$payload['station_id'] = $product->station_id;
$payload['course'] = $payload['course'] ?? $product->course;
$payload['unit_price_minor'] = max(1, $product->price_minor + (int) $chosen->sum('price_delta_minor'));
$payload['modifiers'] = $chosen->map(fn ($m) => [
'modifier_id' => $m->id, 'name' => $m->name, 'price_delta_minor' => $m->price_delta_minor,
])->all();
} else {
// Custom (open-price) line.
$payload['name'] = (string) ($data['name'] ?? '');
$payload['unit_price_minor'] = (int) ($data['unit_price_minor'] ?? 0);
}
try {
$this->sales->addLine($sale, $payload);
} catch (RuntimeException $e) {
return response()->json(['message' => $e->getMessage()], 422);
}
return $this->ticketJson($sale);
}
public function updateLine(Request $request, PosSale $sale, PosSaleLine $line): JsonResponse
{
$this->authorizeOpen($request, $sale);
abort_unless($line->pos_sale_id === $sale->id, 404);
$data = $request->validate([
'quantity' => ['required', 'integer', 'min:0', 'max:999'],
'notes' => ['nullable', 'string', 'max:200'],
]);
$this->sales->updateLine($line, $data['quantity'], $data['notes'] ?? null);
return $this->ticketJson($sale);
}
public function removeLine(Request $request, PosSale $sale, PosSaleLine $line): JsonResponse
{
$this->authorizeOpen($request, $sale);
abort_unless($line->pos_sale_id === $sale->id, 404);
$this->sales->removeLine($line);
return $this->ticketJson($sale);
}
public function sendToKitchen(Request $request, PosSale $sale): JsonResponse
{
$this->authorizeOpen($request, $sale);
$data = $request->validate([
'course' => ['nullable', 'in:'.implode(',', array_keys(PosSaleLine::COURSES))],
]);
$fired = $this->sales->sendToKitchen($sale, $data['course'] ?? null);
$sale->refresh();
return response()->json([
'lines' => $this->lineData($sale),
'subtotal_minor' => $sale->subtotal_minor,
'total_minor' => $sale->total_minor,
'kitchen_status' => $sale->kitchen_status,
'fired' => $fired,
]);
}
public function settle(Request $request, PosSale $sale): RedirectResponse
{
$this->authorizeOpen($request, $sale);
$data = $request->validate([
'payment_method' => ['required', 'in:pay,cash'],
'customer_name' => ['nullable', 'string', 'max:120'],
'customer_phone' => ['nullable', 'string', 'max:40'],
]);
$sale->loadCount('lines');
if ($sale->lines_count === 0) {
return back()->with('error', 'Add at least one item before settling.');
}
if (! empty($data['customer_name']) || ! empty($data['customer_phone'])) {
$sale->forceFill([
'customer_name' => $data['customer_name'] ?? $sale->customer_name,
'customer_phone' => $data['customer_phone'] ?? $sale->customer_phone,
])->save();
}
$merchant = ladill_account() ?? $request->user();
try {
if ($data['payment_method'] === 'cash') {
$this->sales->recordCashPayment($sale);
return redirect()->route('pos.sales.show', $sale)->with('success', 'Ticket settled (cash).');
}
$result = $this->sales->initiatePayCheckout($sale, $merchant);
return redirect()->away($result['checkout_url']);
} catch (RuntimeException $e) {
return back()->with('error', $e->getMessage());
}
}
private function authorizeOpen(Request $request, PosSale $sale): void
{
$this->authorizeOwner($request, $sale);
abort_unless($sale->isOpen(), 409, 'This ticket is already settled.');
}
private function ticketJson(PosSale $sale): JsonResponse
{
$sale->refresh();
return response()->json([
'lines' => $this->lineData($sale),
'subtotal_minor' => $sale->subtotal_minor,
'total_minor' => $sale->total_minor,
'kitchen_status' => $sale->kitchen_status,
]);
}
/** @return list<array<string,mixed>> */
private function lineData(PosSale $sale): array
{
return $sale->lines()->with('modifiers')->orderBy('position')->get()->map(fn (PosSaleLine $l) => [
'id' => $l->id,
'product_id' => $l->product_id,
'name' => $l->name,
'unit_price_minor' => $l->unit_price_minor,
'quantity' => $l->quantity,
'line_total_minor' => $l->line_total_minor,
'kitchen_state' => $l->kitchen_state,
'notes' => $l->notes,
'course' => $l->course,
'modifiers' => $l->modifiers->map(fn ($m) => $m->name)->all(),
'fired' => $l->kitchen_state !== PosSaleLine::KITCHEN_NEW,
])->all();
}
}