Files
ladill-pos/tests/Feature/PosRestaurantTest.php
T
isaaccladandClaude Opus 4.8 d4f4821d96
Deploy Ladill POS / deploy (push) Successful in 23s
Restaurant mode Phase 3: table-QR self-ordering into the kitchen
The "links" slice — a guest scans a table's QR, browses the menu (with
modifiers), and submits an order that lands on that table's open tab and fires
straight to the Kitchen Display.

- Public, auth-free flow scoped by an unguessable table short_code:
  GET /t/{code} (menu + client cart), POST /t/{code}/order (throttled),
  GET /t/{code}/done. Orders open/append the table's dine-in tab, add lines as
  source=guest, and send to the kitchen.
- Staff print a per-table QR (Settings → table → QR; renders client-side to the
  public menu URL). short_code is generated lazily.
- Guest lines are badged on the ticket and the KDS so staff can tell them apart;
  staff still settle the tab as usual (cash / Ladill Pay).
- Extracted PosSaleService::buildProductLine as the single product+modifier
  price resolver, now shared by staff and guest ordering (client prices never
  trusted).

Schema additive: pos_tables.short_code, pos_sale_lines.source. New
PosRestaurantTest covers the guest order firing to the kitchen; suite green (12).

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-06-24 20:13:28 +00:00

206 lines
7.9 KiB
PHP

<?php
namespace Tests\Feature;
use App\Http\Middleware\EnsurePlatformSession;
use App\Models\PosLocation;
use App\Models\PosModifier;
use App\Models\PosModifierGroup;
use App\Models\PosProduct;
use App\Models\PosSale;
use App\Models\PosSaleLine;
use App\Models\PosStation;
use App\Models\PosTable;
use App\Models\User;
use Illuminate\Foundation\Testing\RefreshDatabase;
use Tests\TestCase;
class PosRestaurantTest extends TestCase
{
use RefreshDatabase;
protected function setUp(): void
{
parent::setUp();
$this->withoutMiddleware(EnsurePlatformSession::class);
$this->withoutVite();
}
private function user(): User
{
return User::create([
'public_id' => 'u-'.uniqid(),
'name' => 'Server',
'email' => uniqid().'@example.com',
]);
}
private function restaurant(User $user): array
{
$location = PosLocation::create([
'owner_ref' => $user->public_id,
'name' => 'Café',
'currency' => 'GHS',
'service_style' => PosLocation::STYLE_RESTAURANT,
]);
$table = PosTable::create([
'owner_ref' => $user->public_id,
'location_id' => $location->id,
'label' => 'T1',
'seats' => 4,
'status' => PosTable::STATUS_FREE,
]);
$product = PosProduct::create([
'owner_ref' => $user->public_id,
'name' => 'Latte',
'price_minor' => 2500,
'currency' => 'GHS',
'is_active' => true,
]);
return [$location, $table, $product];
}
public function test_dine_in_ticket_lifecycle(): void
{
$user = $this->user();
[, $table, $product] = $this->restaurant($user);
// Open a dine-in tab on the table.
$this->actingAs($user)->post(route('pos.tickets.open'), [
'order_type' => 'dine_in',
'table_id' => $table->id,
])->assertRedirect();
$sale = PosSale::where('owner_ref', $user->public_id)->firstOrFail();
$this->assertSame(PosSale::ORDER_DINE_IN, $sale->order_type);
$this->assertSame(PosSale::STATUS_PENDING, $sale->status);
$this->assertTrue($sale->table_id === $table->id);
$this->assertSame(PosTable::STATUS_OCCUPIED, $table->fresh()->status);
// Add an item to the tab.
$this->actingAs($user)->postJson(route('pos.tickets.lines.add', $sale), [
'product_id' => $product->id,
'name' => $product->name,
'unit_price_minor' => $product->price_minor,
'quantity' => 2,
])->assertOk()->assertJsonPath('total_minor', 5000);
// Fire it to the kitchen.
$this->actingAs($user)->postJson(route('pos.tickets.send', $sale))
->assertOk()->assertJsonPath('fired', 1);
$line = $sale->lines()->firstOrFail();
$this->assertSame(PosSaleLine::KITCHEN_QUEUED, $line->fresh()->kitchen_state);
$this->assertSame(PosSale::KITCHEN_ACTIVE, $sale->fresh()->kitchen_status);
// Kitchen feed shows the active ticket.
$this->actingAs($user)->getJson(route('pos.kitchen.feed'))
->assertOk()->assertJsonCount(1, 'tickets');
// Bump the line through to served.
foreach (['preparing', 'ready', 'served'] as $expected) {
$this->actingAs($user)->postJson(route('pos.kitchen.bump', $line))
->assertOk()->assertJsonPath('state', $expected);
}
$this->assertSame(PosSale::KITCHEN_SERVED, $sale->fresh()->kitchen_status);
// Settle in cash — ticket paid, table freed.
$this->actingAs($user)->post(route('pos.tickets.settle', $sale), [
'payment_method' => 'cash',
])->assertRedirect(route('pos.sales.show', $sale));
$this->assertSame(PosSale::STATUS_PAID, $sale->fresh()->status);
$this->assertNotNull($sale->fresh()->closed_at);
$this->assertSame(PosTable::STATUS_FREE, $table->fresh()->status);
$this->assertNull($table->fresh()->current_sale_id);
}
public function test_modifiers_course_and_station_routing(): void
{
$user = $this->user();
[, , $product] = $this->restaurant($user);
$station = PosStation::create(['owner_ref' => $user->public_id, 'name' => 'Bar']);
$group = PosModifierGroup::create(['owner_ref' => $user->public_id, 'name' => 'Size', 'min_select' => 1, 'max_select' => 1]);
$large = PosModifier::create(['modifier_group_id' => $group->id, 'owner_ref' => $user->public_id, 'name' => 'Large', 'price_delta_minor' => 1000]);
$product->update(['station_id' => $station->id, 'course' => 'drink']);
$product->modifierGroups()->sync([$group->id]);
// Open a takeaway ticket.
$this->actingAs($user)->post(route('pos.tickets.open'), ['order_type' => 'takeaway'])->assertRedirect();
$sale = PosSale::where('owner_ref', $user->public_id)->firstOrFail();
// Add the product with the Large modifier — price = base 2500 + 1000.
$this->actingAs($user)->postJson(route('pos.tickets.lines.add', $sale), [
'product_id' => $product->id,
'modifier_ids' => [$large->id],
'quantity' => 1,
])->assertOk()->assertJsonPath('total_minor', 3500);
$line = $sale->lines()->firstOrFail();
$this->assertSame(3500, $line->unit_price_minor);
$this->assertSame($station->id, $line->station_id);
$this->assertSame('drink', $line->course);
$this->assertSame('Large', $line->modifiers()->value('name'));
// Fire only the "drink" course.
$this->actingAs($user)->postJson(route('pos.tickets.send', $sale), ['course' => 'drink'])
->assertOk()->assertJsonPath('fired', 1);
// KDS feed carries the station + modifier.
$this->actingAs($user)->getJson(route('pos.kitchen.feed'))
->assertOk()
->assertJsonPath('tickets.0.lines.0.station', 'Bar')
->assertJsonPath('tickets.0.lines.0.modifiers.0', 'Large');
}
public function test_guest_table_qr_order_fires_to_kitchen(): void
{
$user = $this->user();
[, $table, $product] = $this->restaurant($user);
$code = $table->ensureShortCode();
// Public menu loads with no auth.
$this->get(route('pos.table.menu', $code))->assertOk()->assertSee($product->name);
// Guest submits an order from the table.
$this->postJson(route('pos.table.order', $code), [
'customer_name' => 'Ama',
'items' => [
['product_id' => $product->id, 'quantity' => 2, 'modifier_ids' => [], 'notes' => 'extra hot'],
],
])->assertOk()->assertJsonStructure(['redirect']);
$sale = PosSale::where('owner_ref', $user->public_id)->firstOrFail();
$this->assertSame(PosSale::ORDER_DINE_IN, $sale->order_type);
$this->assertSame($table->id, $sale->table_id);
$this->assertSame('Ama', $sale->customer_name);
$this->assertSame(PosSale::KITCHEN_ACTIVE, $sale->kitchen_status);
$this->assertSame(PosTable::STATUS_OCCUPIED, $table->fresh()->status);
$line = $sale->lines()->firstOrFail();
$this->assertSame('guest', $line->source);
$this->assertSame(2, $line->quantity);
$this->assertSame('extra hot', $line->notes);
$this->assertSame(PosSaleLine::KITCHEN_QUEUED, $line->kitchen_state);
}
public function test_cannot_open_two_tabs_on_one_table(): void
{
$user = $this->user();
[, $table] = $this->restaurant($user);
$this->actingAs($user)->post(route('pos.tickets.open'), [
'order_type' => 'dine_in', 'table_id' => $table->id,
])->assertRedirect();
$this->actingAs($user)->post(route('pos.tickets.open'), [
'order_type' => 'dine_in', 'table_id' => $table->id,
])->assertRedirect();
$this->assertSame(1, PosSale::where('owner_ref', $user->public_id)->count());
}
}