mercadodevida/work/artifacts/POS-005/architect.md

POS-005 — Architect

Feature

POS API Phase 1: product search + payment methods.

Objetivo

Endpoints: GET /pos/products/search, /pos/products/by-ean/:ean, /pos/products/by-sku/:sku. Admin: GET/POST/PATCH /pos/admin/payment-methods.

Diseño

• Product search: JOIN catalog_product_variants + catalog_products + inventory_stock + pricing_variant_prices + categories + brands
• Payment methods: direct CRUD on pos_payment_methods table
• Auth: requireAnyRole for product routes; requireRole admin for payment method admin