feat: Phase 2F — customer CRM

Backend:
- New model: Customer (customers table) — name, nickname, phone, email, notes, is_active
- Order model: add customer_id nullable FK → customers
- New router: /api/customers/ — list (with ?search=), create, get, update, soft-delete,
  GET /{id}/orders (visit history with totals)
- Each CustomerOut includes visit_count + total_spent (computed from closed/paid orders)
- PUT /api/orders/{id}/customer — assign or unassign a customer; manager-only;
  validates customer is active; broadcasts order_updated SSE event
- GET /api/orders/{id} now returns customer_id, customer_name (with nickname), customer_phone
- Migration: CREATE TABLE customers + ALTER TABLE orders ADD COLUMN customer_id

Frontend:
- CustomersPage (/customers): searchable list (name/nickname/phone), avatar initials,
  visit count + total_spent on each row; click → detail panel slides in showing stats
  (visits, total spent, avg ticket), contact info, notes, full visit history
- OrderDetailPage: new Πελάτης card — shows assigned customer in blue if set;
  for open orders shows "+ Ανάθεση πελάτη" button → inline search dropdown → assign;
  Αφαίρεση button to unassign
- Sidebar: Users icon for Πελάτες (between Επαφές and Ρυθμίσεις)

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
This commit is contained in:
2026-06-08 02:59:53 +03:00
parent d39382e8dd
commit e9bdf61a4d
10 changed files with 648 additions and 1 deletions

View File

@@ -0,0 +1,117 @@
from fastapi import APIRouter, Depends, HTTPException, status, Query
from sqlalchemy.orm import Session
from typing import List, Optional
from database import get_db
from models.customers import Customer
from models.order import Order, OrderItem
from models.user import User
from schemas.customers import CustomerCreate, CustomerUpdate, CustomerOut, AssignCustomerRequest
from routers.deps import require_manager, get_current_user
router = APIRouter()
def _customer_out(c: Customer, db: Session) -> dict:
orders = db.query(Order).filter(
Order.customer_id == c.id,
Order.status.in_(["closed", "paid"]),
).all()
total_spent = sum(
sum(i.unit_price * i.quantity for i in o.items if i.status in ("active", "paid"))
for o in orders
)
return {
"id": c.id,
"name": c.name,
"nickname": c.nickname,
"phone": c.phone,
"email": c.email,
"notes": c.notes,
"is_active": c.is_active,
"created_at": c.created_at,
"created_by_id": c.created_by_id,
"visit_count": len(orders),
"total_spent": round(total_spent, 2),
}
@router.get("/", response_model=List[CustomerOut])
def list_customers(
search: Optional[str] = None,
include_inactive: bool = False,
db: Session = Depends(get_db),
user: User = Depends(require_manager),
):
q = db.query(Customer)
if not include_inactive:
q = q.filter(Customer.is_active == True)
if search:
term = f"%{search}%"
q = q.filter(
Customer.name.ilike(term) |
Customer.nickname.ilike(term) |
Customer.phone.ilike(term)
)
customers = q.order_by(Customer.name).all()
return [_customer_out(c, db) for c in customers]
@router.post("/", response_model=CustomerOut, status_code=status.HTTP_201_CREATED)
def create_customer(body: CustomerCreate, db: Session = Depends(get_db), user: User = Depends(require_manager)):
customer = Customer(**body.model_dump(), created_by_id=user.id)
db.add(customer)
db.commit()
db.refresh(customer)
return _customer_out(customer, db)
@router.get("/{customer_id}", response_model=CustomerOut)
def get_customer(customer_id: int, db: Session = Depends(get_db), user: User = Depends(require_manager)):
c = db.query(Customer).filter(Customer.id == customer_id).first()
if not c:
raise HTTPException(status_code=404, detail="Customer not found")
return _customer_out(c, db)
@router.put("/{customer_id}", response_model=CustomerOut)
def update_customer(customer_id: int, body: CustomerUpdate, db: Session = Depends(get_db), user: User = Depends(require_manager)):
c = db.query(Customer).filter(Customer.id == customer_id).first()
if not c:
raise HTTPException(status_code=404, detail="Customer not found")
for field, value in body.model_dump(exclude_none=True).items():
setattr(c, field, value)
db.commit()
db.refresh(c)
return _customer_out(c, db)
@router.delete("/{customer_id}", status_code=status.HTTP_204_NO_CONTENT)
def delete_customer(customer_id: int, db: Session = Depends(get_db), user: User = Depends(require_manager)):
c = db.query(Customer).filter(Customer.id == customer_id).first()
if not c:
raise HTTPException(status_code=404, detail="Customer not found")
c.is_active = False
db.commit()
@router.get("/{customer_id}/orders")
def customer_orders(customer_id: int, db: Session = Depends(get_db), user: User = Depends(require_manager)):
c = db.query(Customer).filter(Customer.id == customer_id).first()
if not c:
raise HTTPException(status_code=404, detail="Customer not found")
from models.table import Table
orders = db.query(Order).filter(Order.customer_id == customer_id).order_by(Order.opened_at.desc()).all()
tables_map = {t.id: (t.label or f"T{t.number}") for t in db.query(Table).all()}
result = []
for o in orders:
total = sum(i.unit_price * i.quantity for i in o.items if i.status in ("active", "paid"))
result.append({
"id": o.id,
"table_name": tables_map.get(o.table_id) if o.table_id else None,
"opened_at": o.opened_at,
"status": o.status,
"total": round(total, 2),
"item_count": sum(i.quantity for i in o.items if i.status in ("active", "paid")),
})
return {"orders": result}

View File

@@ -191,6 +191,15 @@ def get_order(order_id: int, db: Session = Depends(get_db), user: User = Depends
table = db.query(Table).filter(Table.id == order.table_id).first() if order.table_id else None
table_name = (table.label or f"T{table.number}") if table else None
# Phase 2F: resolve customer name for display
customer_name = None
customer_phone = None
if order.customer_id and order.customer:
customer_name = order.customer.name
if order.customer.nickname:
customer_name = f"{order.customer.name} «{order.customer.nickname}»"
customer_phone = order.customer.phone
return {
"id": order.id,
"table_id": order.table_id,
@@ -202,6 +211,9 @@ def get_order(order_id: int, db: Session = Depends(get_db), user: User = Depends
"closed_by": order.closed_by,
"notes": order.notes,
"business_day_id": order.business_day_id,
"customer_id": order.customer_id,
"customer_name": customer_name,
"customer_phone": customer_phone,
"items": [fmt_item(i) for i in order.items],
"waiters": [{"waiter_id": w.waiter_id} for w in order.waiters],
"audit_logs": [fmt_log(l) for l in order.audit_logs],
@@ -567,6 +579,26 @@ def assign_waiter(order_id: int, body: AssignWaiterRequest, db: Session = Depend
return {"status": "assigned"}
class AssignCustomerBody(BaseModel):
customer_id: Optional[int] = None # null = unassign
@router.put("/{order_id}/customer")
def assign_customer(order_id: int, body: AssignCustomerBody, db: Session = Depends(get_db), user: User = Depends(require_manager)):
from models.customers import Customer
order = db.query(Order).filter(Order.id == order_id).first()
if not order:
raise HTTPException(status_code=404, detail="Order not found")
if body.customer_id is not None:
customer = db.query(Customer).filter(Customer.id == body.customer_id, Customer.is_active == True).first()
if not customer:
raise HTTPException(status_code=404, detail="Customer not found")
order.customer_id = body.customer_id
db.commit()
broadcast_sync("order_updated", {"order_id": order.id, "table_id": order.table_id, "status": order.status, "action": "customer_assigned"})
return {"status": "ok", "customer_id": order.customer_id}
@router.delete("/{order_id}/waiters/{waiter_id}", status_code=status.HTTP_204_NO_CONTENT)
def remove_waiter(order_id: int, waiter_id: int, db: Session = Depends(get_db), user: User = Depends(require_manager)):
assignment = db.query(OrderWaiter).filter(