Initial kitchen scaffold — Phase 1 kitchen port (build-verified 2026-07-11)

FastAPI backend (Python 3.11, MSSQL ODBC for SambaPOS, Azure DI OCR),
kitchen_db on central PG. React/TS/Vite frontend with navy sidebar layout.

Backend: auth.py (APP_SLUG=kitchen, SimpleNamespace — archive routes use
.kitchen_id/.is_admin without modification), main.py (51 migrations, scheduler,
internal router for KDS bookings feed), api/internal.py, full archive API
(31 routers: invoices, recipes, menus, sambapos, resos, newbook, disputes,
purchase_orders, etc.), models, migrations, OCR pipeline.
kitchen_id pinned to 1 (B1 — single hotel).

Frontend: AuthGate (app=kitchen, token shim for archive compat — B5b pending),
Layout (navy sidebar, 6 sections, Lucide icons, teal --app-primary),
App.tsx (Outlet pattern, UploadApp outside Layout), index.css (full :root block).
strict: false — archive components have type issues; build clean.

Note: 45 archive components call fetch('/api/...') without /kitchen/ prefix
(B5b). Runtime 404s; deferred until after initial testing.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

backend/models/logbook.py

@@ -0,0 +1,143 @@
+"""
+Logbook models for tracking wastage, transfers, staff food, and manual adjustments.
+"""
+from datetime import datetime, date
+from decimal import Decimal
+from sqlalchemy import String, DateTime, Date, ForeignKey, Numeric, Boolean, Text, Integer, Index, Enum
+from sqlalchemy.dialects.postgresql import JSONB
+from sqlalchemy.orm import Mapped, mapped_column, relationship
+from database import Base
+import enum
+
+
+class EntryType(str, enum.Enum):
+    WASTAGE = "wastage"
+    TRANSFER = "transfer"
+    STAFF_FOOD = "staff_food"
+    MANUAL_ADJUSTMENT = "manual_adjustment"
+
+
+class WastageReason(str, enum.Enum):
+    SPOILED = "spoiled"
+    DAMAGED = "damaged"
+    EXPIRED = "expired"
+    OVERPRODUCTION = "overproduction"
+    QUALITY_ISSUE = "quality_issue"
+    OTHER = "other"
+
+
+class TransferStatus(str, enum.Enum):
+    PENDING = "pending"
+    IN_TRANSIT = "in_transit"
+    RECEIVED = "received"
+    CANCELLED = "cancelled"
+
+
+class LogbookEntry(Base):
+    """Base table for all logbook entries"""
+    __tablename__ = "logbook_entries"
+
+    id: Mapped[int] = mapped_column(primary_key=True, index=True)
+    kitchen_id: Mapped[int] = mapped_column(ForeignKey("kitchens.id"), nullable=False, index=True)
+
+    # Entry metadata
+    entry_type: Mapped[EntryType] = mapped_column(Enum(EntryType), nullable=False, index=True)
+    entry_date: Mapped[date] = mapped_column(Date, nullable=False, index=True)
+    reference_number: Mapped[str | None] = mapped_column(String(100), nullable=True, index=True)
+
+    # Type-specific data (stored as JSONB for flexibility)
+    # Wastage: {reason: "spoiled"}
+    # Transfer: {destination_kitchen_id: 2, status: "pending"}
+    # Staff food: {meal_type: "lunch", staff_count: 3}
+    # Manual adjustment: {adjustment_reason: "...", original_invoice_id: 123}
+    type_data: Mapped[dict] = mapped_column(JSONB, nullable=False, default={})
+
+    # Common fields
+    notes: Mapped[str | None] = mapped_column(Text, nullable=True)
+    total_cost: Mapped[Decimal] = mapped_column(Numeric(12, 2), default=0.0)  # Calculated from line items
+
+    # Audit fields
+    created_by: Mapped[int] = mapped_column(ForeignKey("users.id"), nullable=False)
+    created_at: Mapped[datetime] = mapped_column(DateTime, default=datetime.utcnow, index=True)
+    updated_at: Mapped[datetime] = mapped_column(DateTime, default=datetime.utcnow, onupdate=datetime.utcnow)
+
+    # Soft delete
+    is_deleted: Mapped[bool] = mapped_column(Boolean, default=False, index=True)
+
+    # Relationships
+    kitchen: Mapped["Kitchen"] = relationship("Kitchen", back_populates="logbook_entries")
+    created_by_user: Mapped["User"] = relationship("User", foreign_keys=[created_by])
+    line_items: Mapped[list["LogbookLineItem"]] = relationship(
+        "LogbookLineItem", back_populates="entry", cascade="all, delete-orphan", lazy="selectin"
+    )
+    attachments: Mapped[list["LogbookAttachment"]] = relationship(
+        "LogbookAttachment", back_populates="entry", cascade="all, delete-orphan", lazy="selectin"
+    )
+
+    __table_args__ = (
+        Index('idx_logbook_kitchen_date', 'kitchen_id', 'entry_date'),
+        Index('idx_logbook_type', 'kitchen_id', 'entry_type', 'entry_date'),
+    )
+
+
+class LogbookLineItem(Base):
+    """Line items for logbook entries (products/items)"""
+    __tablename__ = "logbook_line_items"
+
+    id: Mapped[int] = mapped_column(primary_key=True, index=True)
+    entry_id: Mapped[int] = mapped_column(ForeignKey("logbook_entries.id"), nullable=False, index=True)
+    kitchen_id: Mapped[int] = mapped_column(ForeignKey("kitchens.id"), nullable=False, index=True)
+
+    # Product reference (nullable for manual entries)
+    # TODO: Add ForeignKey when Product model is created
+    product_id: Mapped[int | None] = mapped_column(Integer, nullable=True)
+
+    # Product details (denormalized for historical accuracy)
+    product_name: Mapped[str] = mapped_column(String(255), nullable=False, index=True)
+    product_code: Mapped[str | None] = mapped_column(String(100), nullable=True)
+    supplier_name: Mapped[str | None] = mapped_column(String(255), nullable=True)
+
+    # Quantity and cost
+    quantity: Mapped[Decimal] = mapped_column(Numeric(10, 3), nullable=False)
+    unit: Mapped[str | None] = mapped_column(String(50), nullable=True)  # kg, litres, each
+    unit_price: Mapped[Decimal | None] = mapped_column(Numeric(12, 4), nullable=True)
+    total_cost: Mapped[Decimal] = mapped_column(Numeric(12, 2), nullable=False)
+
+    # Additional data
+    notes: Mapped[str | None] = mapped_column(Text, nullable=True)
+
+    created_at: Mapped[datetime] = mapped_column(DateTime, default=datetime.utcnow)
+
+    # Relationships
+    entry: Mapped["LogbookEntry"] = relationship("LogbookEntry", back_populates="line_items")
+    # product: Mapped["Product"] = relationship("Product", lazy="selectin")  # TODO: Add Product model
+    kitchen: Mapped["Kitchen"] = relationship("Kitchen")
+
+
+class LogbookAttachment(Base):
+    """Photos and documents attached to logbook entries"""
+    __tablename__ = "logbook_attachments"
+
+    id: Mapped[int] = mapped_column(primary_key=True, index=True)
+    entry_id: Mapped[int] = mapped_column(ForeignKey("logbook_entries.id"), nullable=False, index=True)
+    kitchen_id: Mapped[int] = mapped_column(ForeignKey("kitchens.id"), nullable=False, index=True)
+
+    # File details
+    file_name: Mapped[str] = mapped_column(String(255), nullable=False)
+    file_path: Mapped[str] = mapped_column(String(500), nullable=False)  # Relative path in storage
+    file_type: Mapped[str] = mapped_column(String(50), nullable=False)  # image/jpeg, application/pdf
+    file_size_bytes: Mapped[int] = mapped_column(Integer, nullable=False)
+
+    # Metadata
+    description: Mapped[str | None] = mapped_column(String(255), nullable=True)
+    uploaded_by: Mapped[int] = mapped_column(ForeignKey("users.id"), nullable=False)
+    uploaded_at: Mapped[datetime] = mapped_column(DateTime, default=datetime.utcnow)
+
+    # Relationships
+    entry: Mapped["LogbookEntry"] = relationship("LogbookEntry", back_populates="attachments")
+    kitchen: Mapped["Kitchen"] = relationship("Kitchen")
+    uploaded_by_user: Mapped["User"] = relationship("User")
+
+
+# Forward references
+from .user import Kitchen, User