零售专家：零售系统、POS解决方案、库存管理与全渠道策略专业指南
retail-expert by personamanagmentlayer/pcl
安装命令
npx skills add https://github.com/personamanagmentlayer/pcl --skill retail-expert🇨🇳中文介绍
零售专家
为零售系统、销售点解决方案、库存管理、电子商务平台、客户分析和全渠道零售策略提供专业指导。
核心概念
零售系统
- 销售点系统
- 库存管理系统
- 客户关系管理系统
- 订单管理系统
- 仓库管理系统
- 电子商务平台
- 支付处理
全渠道零售
- 线上到线下整合
- 线上下单，店内取货
- 门店发货
- 统一的客户档案
- 跨渠道库存可见性
- 跨渠道一致定价
- 整合的忠诚度计划
技术
- 移动销售点系统
- 自助结账系统
- 电子货架标签
- 用于库存追踪的射频识别技术
- 用于分析的计算机视觉
- 人工智能驱动的推荐
- 非接触式支付
销售点系统
from dataclasses import dataclass
from datetime import datetime
from decimal import Decimal
from typing import List, Optional
from enum import Enum
class PaymentMethod(Enum):
CASH = "cash"
CREDIT_CARD = "credit_card"
DEBIT_CARD = "debit_card"
MOBILE_PAYMENT = "mobile_payment"
GIFT_CARD = "gift_card"
class TransactionStatus(Enum):
PENDING = "pending"
COMPLETED = "completed"
VOIDED = "voided"
REFUNDED = "refunded"
@dataclass
class Product:
"""产品/SKU 信息"""
sku: str
name: str
description: str
price: Decimal
cost: Decimal
barcode: str
category: str
department: str
tax_rate: Decimal
is_taxable: bool
stock_quantity: int
reorder_point: int
@dataclass
class LineItem:
"""交易行项目"""
sku: str
product_name: str
quantity: int
unit_price: Decimal
discount_amount: Decimal
tax_amount: Decimal
line_total: Decimal
@dataclass
class Transaction:
"""POS 交易"""
transaction_id: str
store_id: str
register_id: str
cashier_id: str
timestamp: datetime
items: List[LineItem]
subtotal: Decimal
tax_total: Decimal
discount_total: Decimal
grand_total: Decimal
payment_method: PaymentMethod
status: TransactionStatus
customer_id: Optional[str]
class POSSystem:
"""销售点系统"""
def __init__(self, store_id: str, register_id: str):
self.store_id = store_id
self.register_id = register_id
self.current_transaction = None
self.products = {}
def start_transaction(self, cashier_id: str) -> str:
"""开始新交易"""
transaction_id = self._generate_transaction_id()
self.current_transaction = Transaction(
transaction_id=transaction_id,
store_id=self.store_id,
register_id=self.register_id,
cashier_id=cashier_id,
timestamp=datetime.now(),
items=[],
subtotal=Decimal('0'),
tax_total=Decimal('0'),
discount_total=Decimal('0'),
grand_total=Decimal('0'),
payment_method=None,
status=TransactionStatus.PENDING,
customer_id=None
)
return transaction_id
def scan_item(self, barcode: str, quantity: int = 1) -> dict:
"""扫描商品并添加到交易"""
if not self.current_transaction:
return {'error': 'No active transaction'}
# 查找商品
product = self._lookup_product(barcode)
if not product:
return {'error': 'Product not found', 'barcode': barcode}
# 检查库存
if product.stock_quantity < quantity:
return {
'error': 'Insufficient inventory',
'available': product.stock_quantity
}
# 计算行项目总计
unit_price = product.price
line_subtotal = unit_price * quantity
discount_amount = Decimal('0') # 在此处应用促销
# 计算税费
tax_amount = Decimal('0')
if product.is_taxable:
tax_amount = (line_subtotal - discount_amount) * product.tax_rate
line_total = line_subtotal - discount_amount + tax_amount
# 创建行项目
line_item = LineItem(
sku=product.sku,
product_name=product.name,
quantity=quantity,
unit_price=unit_price,
discount_amount=discount_amount,
tax_amount=tax_amount,
line_total=line_total
)
# 添加到交易
self.current_transaction.items.append(line_item)
# 更新交易总计
self._recalculate_totals()
return {
'success': True,
'item': {
'name': product.name,
'quantity': quantity,
'price': float(unit_price),
'line_total': float(line_total)
},
'transaction_total': float(self.current_transaction.grand_total)
}
def apply_discount(self, discount_code: str) -> dict:
"""将折扣/促销应用于交易"""
if not self.current_transaction:
return {'error': 'No active transaction'}
discount = self._validate_discount(discount_code)
if not discount:
return {'error': 'Invalid discount code'}
# 根据类型应用折扣
if discount['type'] == 'percentage':
discount_amount = self.current_transaction.subtotal * (discount['value'] / 100)
elif discount['type'] == 'fixed':
discount_amount = Decimal(str(discount['value']))
else:
return {'error': 'Unknown discount type'}
self.current_transaction.discount_total += discount_amount
self._recalculate_totals()
return {
'success': True,
'discount_applied': float(discount_amount),
'new_total': float(self.current_transaction.grand_total)
}
def process_payment(self,
payment_method: PaymentMethod,
amount: Decimal,
payment_details: dict = None) -> dict:
"""处理交易付款"""
if not self.current_transaction:
return {'error': 'No active transaction'}
if amount < self.current_transaction.grand_total:
return {'error': 'Insufficient payment amount'}
# 通过支付网关处理付款
payment_result = self._process_payment_gateway(
payment_method,
amount,
payment_details
)
if not payment_result['success']:
return payment_result
# 完成交易
self.current_transaction.payment_method = payment_method
self.current_transaction.status = TransactionStatus.COMPLETED
# 更新库存
self._update_inventory()
# 计算找零
change = amount - self.current_transaction.grand_total
# 生成收据
receipt = self._generate_receipt()
transaction_id = self.current_transaction.transaction_id
self.current_transaction = None # 清除当前交易
return {
'success': True,
'transaction_id': transaction_id,
'amount_paid': float(amount),
'change': float(change),
'receipt': receipt
}
def void_transaction(self, reason: str) -> dict:
"""作废当前交易"""
if not self.current_transaction:
return {'error': 'No active transaction'}
self.current_transaction.status = TransactionStatus.VOIDED
transaction_id = self.current_transaction.transaction_id
self.current_transaction = None
return {
'success': True,
'transaction_id': transaction_id,
'reason': reason
}
def _recalculate_totals(self):
"""重新计算交易总计"""
self.current_transaction.subtotal = sum(
item.unit_price * item.quantity for item in self.current_transaction.items
)
self.current_transaction.tax_total = sum(
item.tax_amount for item in self.current_transaction.items
)
self.current_transaction.grand_total = (
self.current_transaction.subtotal +
self.current_transaction.tax_total -
self.current_transaction.discount_total
)
def _lookup_product(self, barcode: str) -> Optional[Product]:
"""通过条形码查找商品"""
return self.products.get(barcode)
def _validate_discount(self, discount_code: str) -> Optional[dict]:
"""验证并获取折扣详情"""
# 实现将对照促销数据库进行检查
return None
def _process_payment_gateway(self,
payment_method: PaymentMethod,
amount: Decimal,
details: dict) -> dict:
"""通过网关处理付款"""
# 与支付处理商集成
return {'success': True, 'transaction_id': 'pay_123456'}
def _update_inventory(self):
"""销售后更新库存"""
for item in self.current_transaction.items:
product = self.products.get(item.sku)
if product:
product.stock_quantity -= item.quantity
def _generate_receipt(self) -> dict:
"""生成交易收据"""
return {
'transaction_id': self.current_transaction.transaction_id,
'timestamp': self.current_transaction.timestamp.isoformat(),
'items': [
{
'name': item.product_name,
'qty': item.quantity,
'price': float(item.unit_price),
'total': float(item.line_total)
}
for item in self.current_transaction.items
],
'subtotal': float(self.current_transaction.subtotal),
'tax': float(self.current_transaction.tax_total),
'discount': float(self.current_transaction.discount_total),
'total': float(self.current_transaction.grand_total)
}
def _generate_transaction_id(self) -> str:
"""生成唯一交易 ID"""
import uuid
return f"TXN-{uuid.uuid4().hex[:12].upper()}"
广告位招租
在这里展示您的产品或服务
触达数万 AI 开发者，精准高效
